Search Filters

data type company query type coresignal's custom filters url /v2/company base/search/filter overview use the endpoint to discover employee ids it offers a less complex user experience than the /v2/company base/search/es dsl endpoint explore the available filters, their potential applications, and helpful tips if you prefer uncomplicated queries, opt for this endpoint below are details about filter explanations and how to use them endpoint structure full structure { "name" "string", "website" "string", "exact website" "string", "size" "string", "industry" "string", "country" "string", "location" "string", "created at gte" "string", "created at lte" "string", "last updated gte" "string", "last updated lte" "string", "deleted" true, "employees count gte" 0, "employees count lte" 0, "source id" 0, "founded year gte" 0, "founded year lte" 0, "funding total rounds count gte" 0, "funding total rounds count lte" 0, "funding last round type" "string", "funding last round date gte" "string", "funding last round date lte" "string" } filter list all personal/company information mentioned within this context is entirely fictional and is solely intended for illustrative purposes e xample outputs are redacted and may not contain all the fields you would receive using the endpoint response codes https //docs coresignal com/api/company api response codes#lkqt7 see the list of possible error codes request examples https //docs coresignal com/api/company api requests search test out the endpoint with suggested examples name filter name data input type description usage name s tring company name find company records using the company name or parts of it available operators and (both keywords need to be present) or (one or the other keyword is present) you can search for company records using a part of the name for instance, entering it will return results with companies such as backbone it consulting inc and brothers it limited name { "name" "it" } or operator { "name" "(it consulting) or (it security)" } and operator { "name" "(it consulting) and (it security)" } use "(first phrase) or (second phrase)" if you are searching for words in a phrase and want them to be interpreted together example output first example { "id" 482, "name" "it consulting inc ", } second example { "id" 1186, "name" "it limited", website filter name data input type description usage website s tring company's website search for company records using the company's website possible url formats include microsoft com subdomain microsoft com www microsoft com https //www microsoft com example input domain { "website" "example company com" } https format { "website" "https //www example company com" } example output example "name" "example company", "website" "www example company com", exact website filter name data input type description usage exact website s tring company's website search for company records using the (exact) company website possible url formats microsoft com www microsoft com https //www microsoft com exact website { "name" "it company", "exact website" "www it company com" } example output example "name" "it company", "website" "http //www it company com", size filter name data input type description usage size s tring company size (based on headcount) find company profiles based on their size possible input values industry filter name data input type description usage industry s tring associated industry use the associated industry values to find company profiles search based on the available industry list available operators and (both keywords need to be present) or (one or the other keyword is present in the data) use "(first phrase) or (second phrase)" if you are searching for words in a phrase and want them to be interpreted together phrases { "industry" "(information technology) or internet" } possible input values country filter name data input type description usage country s tring country where the company is based use any of the possible country values to find company records available operators or (one of the two input values) use "(first phrase) or (second phrase)" if you are searching for words in a phrase and want them to be interpreted together phrases { "country" "(united kingdom) or germany" } possible input list location filter name data input type description usage location s tring company location use the following values to search for company records continent (e g , north america) country (e g , united states) state (e g , florida) city (e g , jacksonville) village (e g , palmetto bay) you can additionally combine several of the location values, e g , continent, country (united states, north america) country, state, city (united states, florida, miami) city, state (jacksonville beach, florida) village, city, state, country (palmetto bay, miami, florida, united states) available operators and (both keywords need to be present) or (one of the two input values) example input location { "location" "united states, florida" } example output output "headquarters new address" "palmetto bay, miami, florida, united states", use "\\"{keyword}\\"" format to find exact matches exact match { "location" "\\"united states\\" or germany" } created at gte filter name data input type description usage created at gte s tring date and time when the record was created in our database find company records based on the creation date use the yyyy mm dd hh\ mm\ ss date format the output value will be greater than or equal to the input value example input created at gte { "created at gte" "2021 06 26 12 21 01" } example output example "created" "2021 06 26 12 21 06", created at lte filter name data input type description usage created at lte s tring date and time when the record was created in our database find company records based on the creation date use the yyyy mm dd hh\ mm\ ss date format the output data will be less than or equal to the input value example input created at lte { "created at lte" "2021 06 26 12 21 01" } example output example "created" "2016 06 17 14 59 01", last updated gte filter name data input type description usage last updated gte st ring date and time when the record was last updated find company records based on the last update date use the yyyy mm dd hh\ mm\ ss date format the output value will be greater than or equal to the input value example input last updated gte { "last updated gte" "2021 02 26 12 41 01" } example output example "last updated" "2023 05 21 17 58 40", "last response code" 200, last updated lte filter name data input type description usage last updated lte s tring date and time when the record was last updated find company records based on the last update date use the yyyy mm dd hh\ mm\ ss date format the output value will be less than or equal to the input value example input last updated lte { "last updated lte" "2023 02 26 12 41 01" } example output example "last updated" "2023 01 09 05 01 35", "last response code" 200, deleted filter name data input type description usage deleted b oolean marks record's public availability use it to see company records that are deleted or private use the value true to include deleted/private profiles or false to exclude such profiles from your search tip combine with other filters using relevant keywords possible input values true { "deleted" true } false { "deleted" false } example output deleted profile { "deleted" 1, } active profile { "deleted" 0, } employees count gte filter name data input type description usage employees count gte i nteger employee count visible on the company's profile find company records based on the company headcount the output value will be greater than or equal to the input value example input employees count gte { "employees count gte" 22 } example output example "employees count" 190, employees count lte filter name data input type description usage employees count gte i nteger employee count visible on the company's profile find company records based on the company headcount the output value will be less than or equal to the input value example input employees count { "employees count lte" 22 } example output example "employees count" 2, source id filter name data input type description usage source id i nteger company id assigned by the source find company records using source identifiers example input source id { "source id" 2280242 } example output example "id" 5, "url" "https //www professional network com/company/it company", "hash" "7c7aa7f01abcc2c5672ae36fc412cff9", "name" "itcompany", "source id" 2280242, founded year gte filter name data input type description usage founded year gte i nteger company's founding year find company records based on their founding year the output value will be greater than or equal to the input value example input founded year { "founded year gte" 2011 } example output example "founded" 2015, founded year lte filter name data input type description usage founded year lte i nteger company's founding year find company records based on their founding year the output value will be less than or equal to the input value example input founded year lte { "founded year lte" 2011 } example output example "founded" 2001, funding total rounds count gte filter name data input type description funding total rounds count gte i nteger total number of company's funding rounds usage find company records based on the funding rounds in the company's financial history the output value will be greater than or equal to the input value example input funding rounds total count { "funding total rounds count gte" 5 } example input example "company funding rounds collection" \[ { "id" 81212, "last round investors count" 0, "total rounds count" 5, "last round type" "seed", "last round date" "2016 11 21 00 00 00", "last round money raised" "us$ 1 6m", "cb url" "https //www crunchbase com/funding round/it company", "created" "2020 09 15 10 22 31", "last updated" "2020 10 17 23 02 42", "deleted" 1 } ] funding total rounds count lte filter name data input type description funding total rounds count lte i nteger total number of company's funding rounds usage find company records based on the funding rounds in the company's financial history the output value will be less than or equal to the input value example input funding total rounds count { "funding total rounds count lte" 5 } example output example "company funding rounds collection" \[ { "id" 9707, "last round investors count" 0, "total rounds count" 0, "last round type" null, "last round date" null, "last round money raised" null, "cb url" null, "created" "2020 09 07 19 44 55", "last updated" "2020 10 30 09 03 58", "deleted" 1 } ] funding last round type filter name data input type description usage funding last round type s tring la st funding round type find company records based on the company's last funding round use any of the possible input values possible input values funding last round date gte filter name data input type description usage funding last round date gte s tring last fun ding round date use the last funding round date to find relevant company records use the yyyy mm dd date format the output value will be greater than or equal to the input value example input funding last round date gte { "funding last round date gte" "2011 11 01" } example output example "company funding rounds collection" \[ { "id" 81212, "last round investors count" 0, "total rounds count" 5, "last round type" "seed", "last round date" "2016 11 21 00 00 00", "last round money raised" "us$ 1 6m", "cb url" "https //www crunchbase com/funding round/it company seed ca1a15ae", "created" "2020 09 15 10 22 31", "last updated" "2020 10 17 23 02 42", "deleted" 1 } ] funding last round date lte filter name data input type description usage funding last round date gte s tring last fun ding round date use the last funding round date to find relevant company records use the yyyy mm dd date format the output value will be less than or equal to the input value example input funding last round date lte { "funding last round date lte" "2011 11 01" } example output example "company funding rounds collection" \[ { "id" 121691, "last round investors count" 0, "total rounds count" 1, "last round type" "angel", "last round date" "2007 01 01 00 00 00", "last round money raised" null, "cb url" "https //www crunchbase com/funding round/it company", "created" "2020 09 20 23 18 01", "last updated" "2020 10 13 08 17 36", "deleted" 1 } ]