Company Firmographics API - Business Data Search by Industry

Search a global business firmographics database and export structured company records: registered names, unique business identifiers, addresses, industry codes, employee counts, revenue and corporate linkage. You pay only for the records you actually receive.

This actor is built for building B2B target lists, cleaning and standardising an account database, supplier and vendor research, credit and risk screening, and any workflow that needs verified registered-business data rather than scraped web profiles.

What you can do with it

• Build target lists of registered businesses that match an exact firmographic profile.
• Find every company in a country, region or city inside a set of SIC industry codes.
• Screen a market by employee count and annual revenue bands.
• Pull unique business identifiers so you can join the data to your CRM or ERP.
• Follow corporate linkage up to the global ultimate parent of each company.
• Export everything as JSON, CSV or Excel, or push it into your data warehouse.

Features

• Firmographic filters: SIC industry codes, country, state or region, city, postal code.
• Size filters: minimum and maximum employee count, minimum and maximum yearly revenue.
• Quality filters: marketable records only, include or exclude out-of-business companies.
• Unique business identifier on every record, so results are joinable and de-duplicated.
• Corporate linkage: global ultimate parent identifier and name where available.
• Automatic page-based pagination up to your chosen maximum, with duplicate suppression.
• Advanced raw criteria passthrough for filters not exposed as form fields.
• Pay-per-result pricing with a hard result cap so a run can never surprise you.

Input

Configure a run with these fields. Every field is optional; combine a search term with as many filters as you like to narrow the result set.

Field	Type	Description
searchTerm	string	Free-text term matched against company names and trade styles.
primaryName	string	Match on the registered primary company name.
countryISOAlpha2Code	string	Two-letter ISO country code, chosen from a dropdown.
addressRegion	string	State, province or region.
addressLocality	string	City.
postalCode	string	Postal or ZIP code.
usSicV4	string	Comma-separated four-digit SIC industry codes.
employeesMin / employeesMax	integer	Employee-count range.
yearlyRevenueMin / yearlyRevenueMax	number	Annual revenue range, in USD.
isMarketable	boolean	Return only records flagged as marketable.
isOutOfBusiness	boolean	Include companies flagged as out of business.
rawCriteria	object	Advanced JSON criteria merged over the fields above.
maxResults	integer	Stop after this many records (1 to 5,000).
apiKey	string	Your API key. Required, stored securely.
apiSecret	string	Your API secret. Required, stored securely.

Advanced raw criteria

Criteria that are not exposed as dedicated fields can be passed through rawCriteria as a JSON object, merged over the built-in criteria verbatim. Pagination stays under the actor's control, so a raw object can never make a run loop. For example:

{
  "isStandalone": true,
  "registrationNumbers": ["12345678"]
}

Example output

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

{
  "duns": "804735132",
  "primaryName": "Acme Robotics Incorporated",
  "tradeStyleName": "Acme Robotics",
  "countryISOAlpha2Code": "US",
  "addressCountry": "United States",
  "addressRegion": "Texas",
  "addressLocality": "Austin",
  "streetAddress": "500 Congress Avenue",
  "postalCode": "78701",
  "telephone": "5125550100",
  "website": "acmerobotics.com",
  "primaryIndustryCode": "3559",
  "primaryIndustryDescription": "Special industry machinery",
  "numberOfEmployees": 180,
  "yearlyRevenue": 42000000,
  "isOutOfBusiness": false,
  "isMarketable": true,
  "operatingStatus": "Active",
  "globalUltimateDuns": "804735100",
  "globalUltimateName": "Acme Industrial Group Incorporated",
  "raw": { "organization": { "duns": "804735132" } }
}

Pricing and the credit model

This actor uses pay-per-result pricing. You are charged a fixed price for each company record delivered to the dataset, and nothing for a run that returns no matches. Set maxResults to cap how many records a run can collect, and set a run spending limit as a second safety net. When the spending limit is reached the run stops early and keeps whatever it has already saved.

Bring your own API key

This actor connects to a third-party business firmographics provider (Dun and Bradstreet Direct+) on your behalf and requires your own provider credentials. Enter your apiKey and apiSecret in the input. The actor exchanges them for a short-lived access token at the start of each run, refreshes the token automatically, and never ships with or shares credentials. Both values are stored securely and never logged.

Frequently asked questions

What data does this actor return?

Registered-business firmographics: the primary company name and trade style, a unique business identifier, the primary address, telephone and website, SIC industry code and description, employee count, yearly revenue, operating status, and corporate linkage to the global ultimate parent. Every record also carries the complete raw provider payload.

How do I get an API key?

The underlying data API is a paid subscription product. Once your subscription is active the provider issues an API key and API secret, which you paste into the actor input. The actor never provides credentials of its own.

Which industry codes does it accept?

The usSicV4 field accepts four-digit US SIC codes as a comma-separated list, for example 3661, 3663, 7372. Companies matching any of the listed codes are returned.

How does pagination work?

Results are paged automatically at 50 records per page using page-based pagination, until your maxResults is reached or the provider returns a short page. Records are de-duplicated by their unique business identifier as they stream in.

How am I charged?

You pay a fixed price per company record returned to the dataset. A run that matches nothing costs nothing. Use maxResults and the run spending limit to control cost. Note that your provider subscription may separately meter the search calls the actor makes.

Can I filter on criteria that are not shown in the form?

Yes. Use the advanced rawCriteria JSON object to pass any additional criteria, which are merged over the built-in ones. This is the reliable route for account-specific criteria that your subscription enables.

What happens if the provider rate-limits my key?

The actor honours the retry-after signal, backs off exponentially and retries. If the limit is still in force it stops early and keeps everything already collected rather than failing the whole run.

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

company firmographics, business data api, company search api, firmographic data, business identifier lookup, sic code search, company database, b2b company data, business registry data, company enrichment, employee count data, company revenue data, corporate linkage, ultimate parent company, account data cleansing, crm data enrichment, supplier data, vendor screening, market sizing, b2b prospecting data.