B2B Company Search API - Firmographics, Revenue, Employees

Search a B2B company database and export structured account records. Filter by company name, website, industry and SIC or NAICS code, revenue band, employee count, location, technologies used, funding and employee growth rate, then stream the matching companies straight to a dataset. You pay only for the records you actually receive.

This actor is built for account-based marketing list building, territory and market sizing, CRM account enrichment, and any sales or research workflow that starts with "find every company that looks like this".

What you can do with it

• Build target account lists that match an exact firmographic profile.
• Size a territory or a metro area by revenue band and employee count.
• Find companies inside a set of SIC or NAICS codes, in a country, state or metro.
• Screen for fast-growing companies using one-year and two-year employee growth rates.
• Filter by technologies a company uses, or exclude companies using a technology.
• Pull a corporate family by parent or ultimate parent company ID.
• Export everything as JSON, CSV or Excel, or push it into your CRM or warehouse.

Features

• Identity filters: company name, website, description keywords, company ID.
• Industry filters: industry tags, industry keywords with AND and OR, SIC codes, NAICS codes, primary-industry-only mode.
• Size filters: revenue bands or an exact revenue range, employee bands or an exact employee range.
• Location filters: country, state, ZIP code with a radius in miles, metro area, continent, excluded regions, and a location match type that targets the headquarters or any employee location.
• Growth and funding filters: funding amount range, funding date range, one-year and two-year employee growth rates.
• Technographic filters: technologies used and technologies to exclude.
• Corporate structure filters: parent and ultimate parent company ID.
• Sorting by revenue, employee count or company name, ascending or descending.
• Automatic page-based pagination at 100 records per page, with duplicate suppression.
• Advanced raw criteria passthrough for criteria 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. All are optional individually, but at least one search criterion must be set.

Field	Type	Description
companyName	string	Company name to match.
companyWebsite	string	Company website, comma-separated list allowed.
companyDescription	string	Space-separated words matched against the description.
industryCodes / industryKeywords	string	Industry tags, or keywords with AND and OR.
sicCodes / naicsCodes	string	Comma-separated four-digit industry codes.
primaryIndustriesOnly	boolean	Match the primary industry only.
revenue	string	Revenue bands, comma-separated.
revenueMin / revenueMax	integer	Revenue range in thousands of USD.
employeeCount	string	Employee bands, comma-separated.
employeeRangeMin / employeeRangeMax	string	Exact employee-count range.
country / state / zipCode / metroRegion / continent	string	Location filters.
zipCodeRadiusMiles	integer	Radius around the ZIP code, in miles.
excludedRegions	string	States and metro areas to exclude.
locationSearchType	string	Headquarters, employee location, or a combination.
companyType	string	Company types, e.g. private or public.
businessModel	array	Any of B2B, B2C, B2G.
companyRanking	string	Ranking list IDs.
fundingAmountMin / fundingAmountMax	integer	Funding range in thousands of USD.
fundingStartDate / fundingEndDate	string	Funding date range, YYYY-MM-DD.
oneYearEmployeeGrowthRateMin / Max	string	One-year employee growth range, percent.
twoYearEmployeeGrowthRateMin / Max	string	Two-year employee growth range, percent.
techAttributeTagList	string	Technology tag IDs the company must use.
excludeTechAttributeTagList	string	Technology tag IDs to exclude.
excludeDefunctCompanies	boolean	Drop companies flagged as defunct.
companyId / parentId / ultimateParentId	string	Direct and corporate-family lookups.
sort	string	Sort by revenue, employee count or name.
maxResults	integer	Stop after this many records (1 to 5,000).
rawAttributes	object	Advanced JSON criteria merged over the fields above.
clientId	string	Your OAuth2 client ID. Required.
apiKey	string	Your OAuth2 client secret. Required, stored securely.
scope	string	Optional space-delimited OAuth scopes.

Advanced raw criteria

Criteria that are not exposed as dedicated fields can be passed through rawAttributes as a JSON object, merged over the built-in criteria verbatim. For example:

{
  "itDepartmentBudgetMin": 500,
  "companyTicker": ["ACME"],
  "subUnitTypes": "subsidiary",
  "hashTagString": "hiring"
}

Example output

Each dataset item is one company. The search endpoint returns the core identity fields; the complete provider payload is kept under raw:

{
  "companyId": "344589814",
  "name": "Acme Robotics",
  "website": "www.acmerobotics.com",
  "city": "Austin",
  "state": "Texas",
  "country": "United States",
  "revenueThousandsUsd": "42000",
  "employeeCount": "180",
  "logo": "https://example.com/logo/acmerobotics.com",
  "managementStatus": "NotUnderManagement",
  "raw": {
    "id": "344589814",
    "type": "Company",
    "attributes": { "name": "Acme Robotics", "website": "www.acmerobotics.com" }
  }
}

Revenue is reported in thousands of US dollars, so a 42 million USD company is returned as 42000.

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 B2B company data provider (ZoomInfo) on your behalf and requires your own provider OAuth2 credentials. Generate a client ID and client secret in the provider's admin portal, then paste them into the clientId and apiKey inputs. The actor exchanges them for a short-lived access token at the start of each run and refreshes it automatically. It never ships with or shares credentials, and your secret is stored securely and never logged.

Frequently asked questions

What data does this actor return?

Company search returns the core identity and sizing fields for each match: company ID, name, website, city, state, country, revenue, employee count, logo URL and management status. Every record also carries the complete raw provider payload, so nothing the API sends is lost.

How do I get credentials?

The underlying data API is a paid subscription. Once your subscription is active, an administrator generates an OAuth2 client ID and client secret in the provider's admin portal under the integrations settings. Paste both into the actor input.

Are revenue and funding values in dollars?

No, they are in thousands of US dollars, which is how the underlying API expresses them. Enter 1000 to mean 1 million USD in revenueMin, revenueMax, fundingAmountMin and fundingAmountMax.

How does pagination work?

Results are paged automatically at 100 records per page using page-based pagination, until your maxResults is reached, the provider returns a short page, or the last page is signalled. Records are de-duplicated by company ID as they stream in.

Does the search consume data credits?

Company search is a request-metered endpoint on the provider side rather than a record-metered one, but every request still counts against your request limit. Check your own subscription terms before running large jobs.

How am I charged on this actor?

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.

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

Yes. Use the advanced rawAttributes JSON object to pass any additional criteria, including departmental budget ranges, stock tickers, sub-unit types and engagement filters, which are merged over the built-in criteria.

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

b2b company data, company search api, account based marketing data, firmographic search, company revenue data, employee count data, sic code search, naics code search, technographic data, company funding data, employee growth rate, target account list, abm account list, crm enrichment, sales prospecting data, company database api, metro area company search, corporate hierarchy data, market sizing data, lead generation api.