In contrast to our API Rate Limit, that is there to handle the technical limitations of how much you ping our API. You also have limitation on the regions that you have access to.

Search quota

Every user is allocated a Search Quota, which represents the total number of unique companies you can retrieve information about during your contract or trial period.

This quota is based on the total number of unique valu8Ids fetched through our Companies and Relations endpoints. For example, consider the following search query:

{
    "parameters": {
      "countryCode": [
        "BE"
      ],
      "ContentUpdatedAt": ["2025-05-14"]
    },
    "currency": "usd",
    "pageNumber": 1,
    "pageSize": 10,
    "sortByColumn": "id",
    "sortByDirection": "asc",
    "minifiedSearch": False
}

This query will generate a list of 10 results on the first page. Consequently, 10 quotas will be deducted from your total quota, regardless of whether you utilize information from 1, 5, or all 10 results.

If you modify the pageNumber to 2 and execute the query again, it will count an additional 10 quotas toward your total.

It's important to note that if you request data for the same company multiple times—whether through the same search or entirely different queries—it will only count as 1 quota for that contract period.

Minified Search

Minified Search and Quota Usage

When making a request to the API, you can control the amount of information returned by setting the minifiedSearch parameter. This has a direct impact on how your Search Quota is counted.

Minified Search: True

If minifiedSearch _is set to_True , the quota will not be counted against your total quota. This mode returns only the most basic information about a company, allowing you to perform lightweight queries without consuming your search quota.

The basic information typically includes:

• Company name
• Country code
• valu8Id (unique identifier)
• Company type

Since this information is minimal, it provides a quick way to check basic company details without impacting your allocated quota.

Example:

{
    "parameters": {
      "countryCode": ["BE"],
      "ContentUpdatedAt": ["2025-05-14"]
    },
    "currency": "usd",
    "pageNumber": 1,
    "pageSize": 10,
    "sortByColumn": "id",
    "sortByDirection": "asc",
    "minifiedSearch": True
}

In this example, even though the query retrieves 10 results, no quotas will be consumed, as the minifiedSearchis set to True. You will receive only the basic details for each company.

Minified Search: False

When minifiedSearch is set to False (the default), the API will return the full dataset for each company. In this case, the quota will be counted for each unique valu8Idreturned in the query, regardless of whether you utilize the entire dataset or not.

This setting is useful when you require detailed and comprehensive company information.

Key Points:

Minified Search: True – Basic company information returned, no quota consumed.
Minified Search: False – Full company data returned, quota counted for each unique valu8Id.

This feature provides flexibility, allowing you to choose between lightweight, non-quota-consuming searches and in-depth queries based on your needs.