Company / Enrichment

Enrich by domain

Cost: 1 credit per call

Enriches a company using its domain name as lookup parameter.

We map each domain to a unique company so lookups via domain are fast and reliable. It is the preferred way to enrich a company.

In case the domain name could not be enriched, the API will return a 404 error.

Set waitForEnrichment=false to skip waiting for on-demand enrichment. Already stored company data is returned immediately. When the company is not stored yet, the API returns a 404 error without charging any credits and schedules the enrichment in the background, so a later call can return the company quickly.

get/companies/enrich

Request

  • Base URL: https://api.companyenrich.com
  • URL: https://api.companyenrich.com/companies/enrich
  • Auth: API key in header Authorization

Query parameters

domainstring required
expandstring[]

Expandable response fields. Repeat the parameter to request multiple expansions.

Supported values:

  • workforce: costs 5 credits per company and adds the workforce field to CompanyInfo.
waitForEnrichmentboolean

Whether to wait for on-demand enrichment when the company is not stored yet. When false, stored company data is returned immediately; a company that is not stored yet results in a 404 without charging credits, and its enrichment is scheduled in the background so a later call can return it quickly.

Response

OK

idstring uuid required

The unique identifier of the company

namestring nullable

The name of the company

domainstring nullable

The primary domain name of the company

websitestring uri nullable

The website URL of the company

typeunknown
legalNamestring nullable

The legal name of the company

industrystring nullable

The main industry of the company

industriesstring[] nullable

The industries associated with the company

categoriesCompanyCategory[] nullable

The categories of the company from most to least specific.

employeesunknown
reported_employeesunknown
revenueunknown
descriptionstring nullable

The description of the company

keywordsstring[] nullable

The search keywords of the company

technologiesstring[] nullable

The technologies associated with the company

subsidiariesstring[] nullable

The subsidiaries associated with the company

founded_yearinteger nullable

The year the company was founded

naics_codesstring[] nullable

The NAICS codes associated with the company

page_ranknumber float nullable

The page rank of the company

logo_urlstring nullable

The logo URL of the company

seo_descriptionstring nullable

The SEO description of the company

updated_atstring date-time

The last updated timestamp of the company

Changes

No recorded changes to this operation across all 1 revision of this API.