B2B API

Search companies

Discover companies using identity, location, firmographic, classification, hierarchy, and diversity attributes. Search by name, website, ticker, geography, industry, employee count, revenue, business structure, and more.

POST /companies Requires bearer token Max 50 results per page At least 1 search filter required

What you can search for

Company Search is best when you know an account's identity, market, size, location, organizational structure, or ownership characteristics.

Identity

Find a specific company

Search by company name, website, or stock ticker.

Location

Find companies by geography

Filter by city, state, country ID, ZIP code, region, street, or area code.

Size

Target an account segment

Set minimum and maximum employee or annual revenue ranges.

Industry

Find companies by market

Search with Demandbase industry IDs, sub-industry IDs, NAICS codes, SIC codes, or keywords.

Organization

Target company structures

Filter by business type, company status, Fortune ranking, or hierarchy such as global parent and subsidiary.

Diversity

Apply ownership criteria

Use gender, ethnicity, and supported business-diversity indicators to refine results.

Common searches

Find a company by name

Body

{

"name": "Demandbase",

"page": "1",

"perPage": "10"

}

Find a company by website

Body

{

"website": "demandbase.com",

"page": "1",

"perPage": "10"

}

Find companies by size

Body

{

"minEmployees": "100",

"maxEmployees": "1000",

"minRevenue": "10",

"maxRevenue": "100",

"page": "1",

"perPage": "10"

}

Find software companies

Body

{

"naics": ["511210"],

"primaryIndustryOnly": "true",

"page": "1",

"perPage": "10"

}

Find global parent companies

Body

{

"businessStructure": "globalParent",

"companyStatus": ["operating"],

"page": "1",

"perPage": "10"

}

Find women-owned businesses

Body

{

"wbe": "true",

"country": "1",

"page": "1",

"perPage": "10"

}

↑ Back to top

Quickstart

Send a POST request to /companies with at least one search filter. This example searches for companies in Idaho.

Step 1

Send the request

Request

curl --request POST \

--url https://uapi.demandbase.com/data/b2b/v1/companies \

--header "Authorization: Bearer YOUR_ACCESS_TOKEN" \

--header "Content-Type: application/json" \

--header "Accept: application/json" \

--data '{

"state": "ID",

"page": "1",

"perPage": "10"

}'

Step 2

Read the response

Response

{

"companies": [

{

"name": "Northgate Logistics LLC",

"city": "New Plymouth",

"state": "ID",

"country": "US",

"companyId": 406321

}

],

"totalCount": 165,

"pageNo": 1,

"pageSize": 10

}

↑ Back to top

Request anatomy

Identity and organization

`name`	Company name
`website`	Company website
`ticker`	Stock ticker
`businessTypes`	Business types
`companyStatus`	Operating status
`businessStructure`	Hierarchy type

Location filters

`cities`	Comma-separated cities
`state`	State or province
`country`	Country ID
`regions`	Geographic regions
`zipCodes`	Postal codes
`areaCodes`	Telephone area codes

Firmographic filters

`industries`	Industry IDs
`subIndustries`	Sub-industry IDs
`naics`	NAICS codes
`sicCodes`	SIC codes
`minEmployees`	Minimum employees
`minRevenue`	Minimum revenue in millions

↑ Back to top

Response anatomy

Each result contains a compact company record. Use companyId to fetch the company's full profile or use it with related B2B API endpoints.

companies

Matching company records

Contains the company identifier, name, and primary location attributes for every match on the current page.

`companyId`	Demandbase company identifier
`name`	Company name
`city`	Primary city
`state`	Primary state or province
`country`	Primary country

Pagination

Result-set metadata

Use the total count, current page, and page size to retrieve the remaining matches.

`totalCount`	Total matching companies
`pageNo`	Current page number
`pageSize`	Results requested per page

↑ Back to top

Important rules

Required

Include one search filter

You must include at least one company-search parameter other than sorting and pagination.

Pagination

Use 1–50 results per page

perPage must be between 1 and 50. page must be 1 or greater.

Sorting

Sort only supported fields

Use employeeCount, businessType, companyRevenue, or location with asc or desc.

Ranges

Keep minimums below maximums

minEmployees and minRevenue cannot exceed their corresponding maximums. Revenue values are in millions.

↑ Back to top

Filter reference

Filter	Use it to	Example
`name`	Find companies by name.	`Demandbase`
`website`	Find a company by domain.	`demandbase.com`
`ticker`	Find a public company by stock ticker.	`MSFT`
`state`	Find companies in a state or province.	`CA`
`cities`	Find companies in one or more comma-separated cities.	`San Francisco,New York`
`country`	Find companies using a country ID.	`"1"`
`regions`	Find companies in supported geographic regions.	`["northamerica"]`
`businessTypes`	Filter by business type.	`["public", "private"]`
`companyStatus`	Filter by operating status.	`["operating"]`
`businessStructure`	Filter by organizational hierarchy.	`globalParent`
`fortuneRanking`	Find Fortune 500 or Fortune 1000 companies.	`fortune500`
`industries`	Filter by Demandbase industry IDs.	`["1", "2"]`
`subIndustries`	Filter by Demandbase sub-industry IDs.	`["1_1", "2_1"]`
`naics`	Filter by NAICS codes or supported wildcard patterns.	`["511210", "5415*"]`
`sicCodes`	Filter by SIC codes.	`["7375"]`
`minEmployees`	Set the minimum employee count.	`"100"`
`maxEmployees`	Set the maximum employee count.	`"1000"`
`minRevenue`	Set minimum annual revenue in millions.	`"10"`
`maxRevenue`	Set maximum annual revenue in millions.	`"100"`
`primaryIndustryOnly`	Match only the primary industry classification.	`"true"`
`primarySICOnly`	Match only the primary SIC classification.	`"true"`
`companyIdsToExclude`	Exclude specific Demandbase company IDs.	`["726263"]`
`wbe`	Apply the supported women-owned business indicator.	`"true"`
`mbe`	Apply the supported minority-owned business indicator.	`"true"`

↑ Back to top

Empty results

If no companies match the query, the API returns a successful response with an empty companies array.

200 Response

{

"companies": [],

"totalCount": 0,

"pageNo": 1,

"pageSize": 10

}

Common errors

Status	Error	How to fix it
`400-102`	At least one parameter must be provided for company search.	Add a search filter such as `name`, `website`, `state`, or `industries`.
`400-101`	`perPage` must be between 1 and 50.	Set `perPage` to a value from 1 to 50.
`400-100`	Page number must be greater than or equal to 1.	Set `page` to `1` or greater.
`400-135`	Invalid sort field.	Use `employeeCount`, `businessType`, `companyRevenue`, or `location`.
`400-109`	Invalid sort order.	Use `asc` or `desc`.
`400-214`	Invalid country ID.	Use a valid country ID in `country`.
`400-114`	Invalid industry ID.	Provide integer values in `industries`.
`400-126`	Invalid employee range.	Use non-negative values and make `minEmployees` less than or equal to `maxEmployees`.
`400-127`	Invalid revenue range.	Use non-negative values and make `minRevenue` less than or equal to `maxRevenue`.
`400-128`	Invalid business structure.	Use `uncategorized`, `globalParent`, `subsidiary`, `group`, `branch`, or `independent`.
`400-129`	Invalid business type.	Use `public`, `private`, `school`, `government`, or `organization`.
`400-130`	Invalid company status.	Use a supported status such as `operating`, `acquired`, or `outOfBusiness`.
`400-133`	Invalid region.	Use one of the supported values, such as `northamerica`, `europe`, or `asia`.
`401`	Authentication failed.	Generate a valid token and send it in the `Authorization: Bearer YOUR_ACCESS_TOKEN` header.
`403`	Forbidden.	Your token is valid, but does not have access to this endpoint or the requested resource. Confirm your API Key Set includes B2B API access.
`429`	Too many requests.	You exceeded the rate limit. Retry after waiting, reduce request volume, and use backoff for automated jobs.

↑ Back to top

Search Companies

Search companies

What you can search for

Find a specific company

Find companies by geography

Target an account segment

Find companies by market

Target company structures

Apply ownership criteria

Common searches

Find a company by name

Find a company by website

Find companies by size

Find software companies

Find global parent companies

Find women-owned businesses

Quickstart

Send the request

Read the response

Request anatomy

Response anatomy

Matching company records

Result-set metadata

Important rules

Include one search filter

Use 1–50 results per page

Sort only supported fields

Keep minimums below maximums

Filter reference

Empty results

Common errors

Next steps