Request Parameters

Search Request Parameters

NameDescriptionOperators
company_idcompany_id of companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
namesNames of companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
tagsTags associated with the companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
domainsDomain URLs of the companies you want to filter by. is, is not, is one of, is not one of, exists, does not exist.
industries_namesIndustries names associated with the companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
industries_codesIndustries codes associated with the companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
countriesCountries where the companies are located to filter by.is, is not, is one of, is not one of, exists, does not exist.
statesStates where the companies are located to filter by.is, is not, is one of, is not one of, exists, does not exist.
citiesCities where the companies are located to filter by.is, is not, is one of, is not one of, exists, does not exist.
revenue_codesRevenue range in USD of companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
employees_codesEmployees range of companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
technologies_product_namesProducts names used in companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
technologies_vendor_namesVendors names used in companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
technologies_product_category_namesProducts category names used in companies to filter by.is, is not, is one of, is not one of, exists, does not exist.
last_modified_dateDate from which data are filtered.since, before

Search Request Boolean Logic

A OR operator is applied between the values of a parameter.
A AND operator is applied between parameters.

Search Request Settings

SettingsDescriptionValue
reveal_all_dataFor all companies that match the criteria:

When set to true
So that you know – the complete response will be returned. One corpo record credit per company returned will be charged.

When set to false
A partial response will be returned. So that you know, no credit will be charged.
Mandatory
page_sizeThe number [1, 100] of results to return in a single page.Optional.

The default is 20.
page_numberThe search results are paginated; this attribute specifies which page will be returned between [1, 100].Optional.

The default is 1.

Examples

{
    "reveal_all_data": false,
    "parameters": {   
        "company_id": [
            {
            "operator":"exists",
            "value": null
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "names": [
            {
            "operator":"is one of",
            "value": ["DOS SANTOS CARVALHO", "DG CONCEPT"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "tags": [
            {
            "operator":"is one of",
            "value": ["Corporation", "Has Social Link"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "domains": [
            {
            "operator":"is one of",
            "value": ["apple.com", "google.com"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "industries_names": [
            {
            "operator":"is one of",
            "value": ["Home Furniture, Furnishings and Equipment Stores"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "industries_codes": [
            {
            "operator":"is one of",
            "value": ["57", "0291"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "countries": [
            {
            "operator":"is one of",
            "value": ["Canada", "United States"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "states": [
            {
            "operator":"is one of",
            "value": ["New York", "Berkshire"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "cities": [
            {
            "operator":"is one of",
            "value": ["New York City", "Wokingham"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "revenue_codes": [
            {
            "operator":"is one of",
            "value": ["1M - 2M", "100M - 500M"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "employee_codes": [
            {
            "operator":"is one of",
            "value": ["10 - 49","200 - 499"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "technologies_product_names": [
            {
            "operator":"is one of",
            "value": ["Adobe Typekit","Google Analytics"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "technologies_vendor_names": [
            {
            "operator":"is one of",
            "value": ["Google","Microsoft"]
            }
        ]
    }
}
{
    "reveal_all_data": true,
    "parameters": {   
        "technologies_product_category_names": [
            {
            "operator":"is one of",
            "value": ["Enterprise Content Solutions", "Infrastructure as a Service (IaaS)"]
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {   
        "last_modified_date": [
            {
            "operator": "since",
            "value": "2022-10-30"
            }
        ]
    }
}
{
    "reveal_all_data": false,
    "parameters": {
        "domains": [
            {
                "operator": "exists",
                "value": null
            }
         ],
         "countries": [
            {
                "operator": "is one of",
                "value": ["Canada","United Kingdom"]
            }
         ],
         "last_modified_date": [
            {
                "operator": "since",
                "value": "2022-01-06"
            }
         ]  
    }
}

What’s Next