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 up to 10 results on the first page. Consequently, 10 companies will be added towards your total search allocation, 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 companies 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 or endpoints—it will only count as 1 company 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.

Please note that MinifiedSearch only works when using the "Companies"-endpoint.

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 most common use case for MinifiedSearch is to do pre-screening of possible hits before delving deeper on specific companies in the results.

The basic information typically includes:

• valu8Id (unique identifier)
• Organization number

• Company name

• Country code

• OperationalStatus
• URL
• Ultimate parent org nr
• Meta data concerning when the company was last updated

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.

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.