Global Company Database API - Worldwide Firmographics Data

Search a worldwide company database covering more than 200 countries and export the matches as clean rows, with firmographics, contact details, map coordinates and corporate group linkage in the same record. Filter by country, city, province, region, postal code, a radius around a map point, four parallel industry classifications including NACE, employee count, sales volume, founding year, legal form, national registration number and the country of the corporate parent. You pay only for the companies you actually receive.

This actor is built for international account list building, market sizing in countries where registry data is hard to reach, supplier and distributor discovery, local business mapping, and enriching a CRM with registry-sourced firmographics outside the usual English-speaking markets.

What you can do with it

• Build a company list in almost any country, not just the United States and the United Kingdom.
• Find every local subsidiary of a foreign group by filtering on the parent company's country.
• Search a circle: a latitude, a longitude and a radius in metres, for territory planning and field sales routing.
• Require the fields you actually need, so a list built for calling only contains records that carry a phone number.
• Target companies by what their website runs: online shop, payment, digital marketing and detected technology tags.
• Filter on registry facts other databases do not carry: legal form, national registration number, whether that number is also a VAT number, and import or export agent status.
• Export everything as JSON, CSV or Excel, or push it into a CRM or warehouse.

Features

• Every documented search field is a real input field, grouped into company, location, industry, size, legal, required data points, web presence, deduplication and search behaviour.
• The provider's two-phase saved search is handled for you: the actor submits the filter set, reads the match count, then walks the record pages against that saved search.
• The three-state presence filters are exposed as dropdowns rather than checkboxes, because the provider models website and registration-number presence as ignore, must have, or must not have, not as a simple yes.
• The data-set selector is sent as a valid enum value, never as zero, which is the value that makes the provider's own serialiser fail.
• Four parallel industry classifications are supported side by side: international, NACE, the provider's directory categories and country-specific local categories, plus keyword matching when you do not have a code to hand.
• Category columns are collapsed for you. The provider returns categories as numbered columns, up to ten for directory categories and fifteen for local ones, and the actor turns each set into one clean list of code and label pairs.
• Corporate linkage is flattened into parent, domestic ultimate and global ultimate blocks, so group structure is readable without digging into nested objects.
• Deduplication can be pushed down to the provider, on phone, email, website, web domain, mobile, contact number or registration number, so duplicates are removed before you are charged rather than after.
• Filed financial history is kept intact where the provider has it, alongside the current sales volume in local currency, dollars and euros.
• Page pagination is walked automatically and stops on a short page or on the reported total.
• Duplicate companies are removed across pages, keyed on record id then registration number then domain then name, before anything is charged.
• The untouched provider payload is kept under raw, so nothing is lost.
• Rate limits are handled with retry-after aware backoff, and a run that hits a limit keeps everything already collected.
• Pay-per-result pricing with a hard result cap so a run can never surprise you.

Input

Field	Type	Description
businessNames	array	Business names to match.
who / where	string	Free-text name-or-category box and free-text location box.
websites / emails / phoneNumbers / nationalIds	array	Match on a known contact point or registration number.
countryCodes	array	Two-letter ISO country codes.
cityNames / provinceNames / regionNames / postCodes	array	Location filters by name or postal code.
cityCodes / provinceCodes / regionCodes	array	Location filters by the provider's own codes.
centerLatitude / centerLongitude / radiusMeters	string, string, integer	Circle search around a map point. Radius is in metres.
internationalCodes / naceCodes / infobelCodes / localCodes	array	Four parallel industry classifications.
categoryKeywords	array	Match categories by keyword instead of by code.
minEmployeesTotal / maxEmployeesTotal	integer	Headcount range for the whole company.
minEmployeesHere / maxEmployeesHere	integer	Headcount range for the individual location.
minSalesVolume / maxSalesVolume	integer	Sales range, in the chosen currency.
salesVolumeCurrency	string	Local currency, US dollars or euros.
minYearStarted / maxYearStarted	integer	Founding year range.
legalStatusCodes / nationalIdentificationTypeCodes / isVat	array, array, boolean	Registration and legal form filters.
locationStatus	array	Single location, headquarters or branch.
globalUltimateCountryCodes / parentUniqueIds	array	Corporate parent filters.
hasPhone / hasEmail / hasMobile / hasCoordinates and more	boolean	Require a record to carry a given field.
hasWebsite / hasNationalId	string	Three-state presence: ignore, must have, must not have.
technographicalTags / hasEShop / hasPayment	array, boolean	Website and technology filters.
dedupePhone / dedupeEmail / dedupeWebDomain and more	boolean	Collapse duplicates at the provider before charging.
dataType	string	Business database, yellow pages or white pages.
matchAnyFilter	boolean	Combine inclusive filters with OR rather than AND.
sortingOrder	array	Sort by relevance, name, sales, employees, year started and more.
rawFilters	object	Any extra search field, merged last.
maxResults	integer	Stop after this many companies (1 to 50,000).
pageSize	integer	Companies per API call (1 to 50).
apiKey	string	An access token you already hold. Stored securely.
username / password	string	Account login, used to request a token when no token is given.

At least one filter is required.

Example output

Each dataset item is one company. Fields are populated where the provider has data, and the untouched payload is kept under raw:

{
  "uniqueId": "BE0000123456",
  "businessName": "Example Trading",
  "tradeName": "Example",
  "website": "https://www.example.be",
  "domain": "example.be",
  "email": "info@example.be",
  "phone": "+32 2 123 45 67",
  "mobile": null,
  "addressStreet": "Rue de l'Exemple",
  "houseNumber": "42",
  "postCode": "1000",
  "city": "Brussels",
  "province": "Brussels",
  "region": "Brussels",
  "country": "Belgium",
  "countryCode": "BE",
  "latitude": 50.8503,
  "longitude": 4.3517,
  "geoLevel": 3,
  "geoLevelDescription": "Street Segment Interpolated",
  "nationalId": "0123456789",
  "nationalIdIsVat": true,
  "legalStatus": "Corporation",
  "status": "HQ",
  "yearStarted": 1998,
  "employeesHere": 34,
  "employeesTotal": 120,
  "salesVolume": 18500000,
  "salesVolumeEuros": 18500000,
  "currency": "EUR",
  "ceoName": "A. Example",
  "ceoTitle": "Managing Director",
  "internationalCategories": [{ "code": "017116", "label": "Software Publishers" }],
  "naceCategories": [{ "code": "62010", "label": "Computer programming activities" }],
  "parentLinkage": null,
  "globalLinkage": {
    "uniqueId": "NL0000987654",
    "businessName": "Example Group",
    "city": "Amsterdam",
    "countryCode": "NL"
  },
  "financialHistory": [{ "yearStat": 2025, "salesVolume": 18500000, "employeesHere": 34 }],
  "socialLinks": ["https://www.linkedin.com/company/example-trading"],
  "logo": "https://logos.example-provider.com/example.be.png",
  "raw": { "uniqueID": "BE0000123456", "businessName": "Example Trading" }
}

Pricing and the credit model

This actor uses pay-per-result pricing. You are charged a fixed price for each company delivered to the dataset, after duplicates are removed. A search that matches nothing costs nothing. Set maxResults to cap how many rows a run can collect, and set a run spending limit as a second safety net.

Your own provider plan meters separately. Because the provider charges for records extracted from a saved search, use the required-data-point filters and the deduplication options to narrow the result set before extraction rather than filtering the rows afterwards.

Bring your own API key

This actor connects to a third-party global company data provider (InfobelPRO) on your behalf and requires your own provider credentials. You can supply them two ways: paste an access token you already hold into the apiKey field, or fill in the account username and password and the actor will request a token for you. Credentials are stored securely and never logged, and the actor never ships with or shares credentials.

Frequently asked questions

What data does this actor return?

Record id, business name, company name and trade name, website with a normalised domain, email, phone, mobile and fax, the full street address split into street, house number, postal code, city, province, region and country, latitude and longitude with the geocoding precision level, national registration number and whether it doubles as a VAT number, legal form, location status, founding year, employees at the location and in total, sales volume in local currency along with dollar and euro conversions, the registered executive's name and title, four sets of industry categories, import and export agent status, website status and crawl date, detected social links and logo, opening hours and building details, corporate linkage to the direct parent and the domestic and global ultimate parents, and filed financial history. Every record also carries the untouched provider payload.

Which countries does it cover?

More than 200. This is the reason to reach for this API rather than a United States focused database: it carries registry-sourced records for markets where most B2B databases are thin, and it uses one schema across all of them, so a record from one country has the same field names as a record from another.

How do the four industry classifications differ?

International categories are the provider's default cross-border scheme. NACE codes are the European statistical classification, exposed by the provider as its alternate international categories. Directory categories are the provider's own taxonomy, which is the most granular. Local categories are country-specific and differ per country, so a local code from one country means nothing in another. If you do not have a code, use categoryKeywords instead and match by keyword.

Why is website presence a dropdown instead of a checkbox?

Because the provider models it as three states, not two: ignore the field entirely, require that a website exists, or require that none exists. That third state is genuinely useful, since companies with no web presence are a real segment for web design and digital agencies. The registration-number filter works the same way.

What is the radius search measured in?

Metres. Set centerLatitude, centerLongitude and radiusMeters together, and only records inside that circle are returned. A five kilometre radius is 5000, not 5.

How does deduplication work?

The provider can collapse duplicates while the search runs, keeping the best record from each group. Each option requires its matching presence filter to be set as well, so deduplicating on email also needs the email filter turned on. Doing it this way means duplicates never reach your dataset and are never charged for. The actor also deduplicates across pages on its own, keyed on record id then registration number then domain then name.

What is the difference between employees here and employees total?

Employees here counts the people at that individual location. Employees total counts the whole company across every location. A branch of a large group will show a small number for the first and a large one for the second, which is exactly how you tell a branch office from a headquarters.

Can I find subsidiaries of foreign companies?

Yes. Filter on globalUltimateCountryCodes to get every company in your target country whose ultimate parent sits in another one. You can also pass a specific parent's record id to globalUltimateUniqueIds, parentUniqueIds or domesticUltimateUniqueIds to pull that group's members directly.

What does the geocoding precision level mean?

It records how the coordinates were derived, for example an interpolated point along a street segment rather than a surveyed rooftop. Filter on it when the coordinates drive routing or territory assignment and a street-level approximation is not good enough.

How does the actor handle rate limits?

It throttles requests, honours the retry-after signal on a rate-limited response, and backs off exponentially. A response saying the account is out of credits or is not licensed for a country stops the run early and keeps everything already collected.

How am I charged?

You pay a fixed price per company returned to the dataset. Duplicates are removed before charging and empty runs cost nothing. Use maxResults and the run spending limit to control cost.

What output formats are available?

The dataset can be exported as JSON, CSV, Excel, HTML or RSS, or read through the API for pushing into a CRM or warehouse.

Keyword map

global company database api, international company data api, worldwide business directory api, company firmographics api, nace code company search, european company data api, business registry data api, company registration number lookup, vat number company data, international b2b data api, company data by country, local business data api, radius search business api, geocoded company data, corporate group structure api, parent company subsidiary data, company sales volume data, employee count company database, international lead generation data, b2b prospecting api worldwide.