Company Data API - Global Business Registry Search

Search a worldwide registry database of companies and pull the matches as flat rows: legal name, trade name, full address, official registration number, CEO, phone, email, website, industry code, headcount, revenue, founding year and the corporate group chain above the company.

What this actor does

• Filters on real registry fields, not a keyword box: ISO country code, province, region, city, street, postal code, four digit SIC industry code, legal status, company status and subsidiary code.
• Filters on size and age with true ranges: total headcount, on-site headcount, annual revenue, founding year and numeric postal code, each with an independent minimum and maximum.
• Filters on data completeness, which is what makes a list usable: only companies that have an email, a phone, a website, a named CEO, a contact person, a registration number or a street address.
• Walks large result sets with the provider's scroll cursor rather than deep offset paging, and stops the moment a page adds nothing new so a plan that does not page cannot loop and re-charge.
• Separates search from export. Search returns the preview record and is the cheap way to size a filter set. Export returns the full record and draws on your export allowance, so the actor never spends export credit unless you ask it to.
• Keeps the untouched API record under raw alongside the flat promoted columns.

Input

Field	What it does
endpoint	Search for the preview record, or export for the full record.
search	Free text terms matched across the record.
countryCode, countryName	ISO two letter codes, or full names when you lack the code.
provinceName, regionName, cityName, streetName, postalCode	Geographic narrowing.
sic4Digits	Four digit industry activity codes.
legalStatus, statusCode, subsidiaryCode, importExportCode	Registry classification codes.
ids, nationalId, worldwideHeadquarterId	Direct lookups by provider ID, registration number, or whole corporate group.
employeesTotalMin/Max, employeesHereMin/Max	Headcount ranges.
annualSalesMin/Max	Revenue range.
foundingYearsMin/Max	Founding year range.
postalCodeIntegerMin/Max	Numeric postal code range.
hasEmail, hasPhone, hasWebsite, hasCEOName, and the other presence flags	Data completeness filters.
advancedParams	Raw query string pairs for anything this form does not list. Wins over the fields above.
useScroll, pageSize, maxResults	Paging mode, page size and the hard cap on spend.
apiKey	Your own API key, sent in the x-api-key header. Stored as a secret.

Example output

{
  "recordType": "company",
  "matched": true,
  "id": "492871553",
  "name": "Van Dijk Logistiek B.V.",
  "tradeName": "Van Dijk Logistics",
  "website": "vandijklogistiek.nl",
  "email": "info@vandijklogistiek.nl",
  "phone": "20 4567890",
  "phoneCountryCode": "31",
  "addressLine1": "Dam 12",
  "city": "Amsterdam",
  "stateProvince": "Noord-Holland",
  "postalCode": "1012 JS",
  "country": "Netherlands",
  "registrationNumber": "34215567",
  "ceoName": "P. van Dijk",
  "ceoTitle": "Directeur",
  "businessCategory": "Freight transport by road",
  "businessCategoryCode": "4213",
  "foundingYear": "2004",
  "employeesTotal": 84,
  "employeesHere": 61,
  "annualSalesUsd": 18400000,
  "currencyCode": "EUR",
  "globalHqName": "Van Dijk Holding B.V.",
  "companiesInGroup": 4,
  "raw": { }
}

Frequently asked questions

What data does this company data API return?

Each row carries the company's legal name and trade name, address status, two address lines, city, state or province, postal code and country, the official registration number and its type code, phone with country dialling code, fax, email and website, the CEO name and title, the business category with its numeric code, founding year, legal type, location type, total and on-site headcount, annual revenue in local currency and US dollars, and the local, national and global headquarters IDs and names with the size of the corporate group. Export records also carry executive names and titles.

Do I need my own API key?

Yes. This actor does not include data access. You use your own API key from CompanyData.com, which is the provider whose API this actor calls. Your own plan, search allowance and export allowance apply. Paste the key into the apiKey field, where it is stored as an Apify secret and sent in the x-api-key request header rather than as a URL parameter, so it never appears in a log line or a redirect.

What is the difference between the search and export endpoints?

Search returns a preview record and is the cheap way to check that a filter set matches the companies you expect. Export returns the complete record, including the headquarters chain and executives, and consumes your export allowance. The actor defaults to search so a filter experiment never quietly spends export credit.

How do I filter by company size or revenue?

Use the range fields. employeesTotalMin and employeesTotalMax bound company-wide headcount, employeesHereMin and employeesHereMax bound the headcount at that specific location, and annualSalesMin and annualSalesMax bound yearly revenue. Either side of a range can be left empty for an open-ended bound.

Can I pull every company in a corporate group?

Yes. Put the group's global headquarters ID into worldwideHeadquarterId and every member of that group is returned. Each row also carries the local, national and global headquarters ID and name, so you can walk the structure from any member you already have.

How do I use a filter this form does not list?

Put it in advancedParams as query string pairs joined by &, for example legalStatus=3&hasBusinessName=true. Anything there is sent verbatim and overrides a form field of the same name, so your own API reference stays the authority on what your plan supports.

How much does a run cost?

Pricing is pay per result: you are charged for each company returned to the dataset, and duplicates are not charged. Apify platform usage is included in the per-result price. Your own API provider's search and export allowances are separate and billed by them.

Why did my run stop early?

Either it hit maxResults, or a page returned only companies already collected. The second case means the result set is not paging for your key, and the actor stops rather than looping over the same records and charging again. Narrow the filter to reach different companies.

Keyword map

company data API, business registry API, company search API, global company database, firmographic data API, company lookup by country, SIC code search, company registration number lookup, B2B company list building, corporate group structure API, headcount and revenue filters, company enrichment API, business data export, chamber of commerce data, international company records