Company Enrichment API - Search, Firmographics, Tech Stack

Build a company list from filters, or fill in the firmographics for a list you already have. Returns the company name, domain, website, industry, description, employee count and band, company type, founded year, full address, social profiles and follower count, one flat row per company, with optional tech stack, revenue estimate, fundraising history and office locations.

What this actor does

• Two ways to get companies, one output shape. Search builds a new list from the provider's filters; enrich takes domains, company names or profile URLs you already have. Both write the same columns, so the two can be appended to the same table without any reshaping.
• Filters on the server, not after the fact. Country, state, city, industry, name fragment, employee band, founding window, funding range, revenue range and social follower range are all sent to the provider, so you pay for the companies you asked for rather than filtering a broad pull down afterwards.
• Enriches from whatever identifier you have. A domain, a bare company name or a company profile URL is each a complete lookup on its own. A pasted browser URL is reduced to the hostname or the profile path before the request, so a messy list still resolves.
• Adds the deeper data only when you ask. Tech stack, revenue estimate, fundraising history and office locations are separate endpoints and separate credits, so they are opt-in per run rather than always on.
• Paces itself to the documented rate limit of 100 requests per minute per key, so a long enrichment pass does not trip the limiter and waste credits redoing work.
• Writes each page as it lands. A run stopped halfway still leaves a usable dataset rather than nothing.
• Never charges for a miss. Only rows carrying a resolved company are billed.

Input

Field	What it does
mode	Search for companies by filter, or enrich a list you already have.
country	Country to search in. Required in search mode.
state, city	Narrow the search to a region or a city.
industry	Industry to filter on.
companyNameContains	Return only companies whose name contains this text.
employeeSize	Headcount band, using the provider's own bands.
foundedAfterYear, foundedBeforeYear	Search a founding window.
annualRevenueMin, annualRevenueMax	Revenue range, in millions of US dollars.
fundingAmountMin, fundingAmountMax	Total funding raised, in US dollars.
followersCountMin, followersCountMax	Social follower range.
productsServices	Products or services the company should offer.
isSchool, excludeSchools	Keep only, or leave out, educational institutions.
companyDomains, companyNames, linkedinUrls	The list to enrich.
addOns	Extra endpoints: tech stack, revenue, fundraising, locations.
requestsPerMinute	Pace the run under the provider's per-key ceiling.
skipNotFound	Leave unresolved inputs out of the dataset.
maxResults	Hard cap on rows, and therefore on spend and run time.
apiKey	Your own API key. Stored as a secret.

Example output

{
  "found": true,
  "source": "enrich",
  "query": "stripe.com",
  "confidence": 96,
  "name": "Stripe",
  "domain": "stripe.com",
  "website": "https://stripe.com",
  "industry": "software development",
  "description": "Financial infrastructure for the internet.",
  "companyType": "privately held",
  "foundedYear": "2010",
  "employeeCount": 8000,
  "employeeRange": "5,001-10,000",
  "followersCount": 1000000,
  "country": "united states",
  "state": "california",
  "city": "south san francisco",
  "address": "354 oyster point blvd, south san francisco, 94080, us",
  "linkedinUrl": "linkedin.com/company/stripe",
  "facebookUrl": null,
  "twitterUrl": null,
  "raw": { }
}

Frequently asked questions

What data does the Company Enrichment API return?

Every resolved company returns the name, the domain, the website, the industry, the description, the company type, the founded year, the employee count and the headcount band, the social follower count, the logo URL, the country, state, city and full address, and the social profile URLs. Turning on the add-ons layers the technologies the company uses, its revenue estimate, its fundraising history and its office locations onto the same row.

Do I need my own API key?

Yes. This actor does not include data access. You use your own API key from CUFinder, which is the provider whose company data API this actor calls, created on their dashboard. Your own plan, credit balance and terms apply. Paste the key into the apiKey field, where it is stored as an Apify secret and sent in a request header rather than a URL parameter, so it never appears in a log line or a redirect.

Should I use search mode or enrich mode?

Use search when you want companies you do not have yet and can describe them by filter: a country plus an industry, a headcount band and a founding window is enough to build a territory list from nothing. Use enrich when you already have a list, from a CRM export or a form fill, and what you are missing is the firmographics. Enrich is also the mode that resolves a bare company name into a domain.

What is the minimum input for a search?

A country. The provider requires it on every company search, so a run without one stops immediately with that message rather than pulling the whole database. Every other filter is optional and narrows from there.

How do I find companies in a funding or revenue band?

Set fundingAmountMin and fundingAmountMax in US dollars for total raised, or annualRevenueMin and annualRevenueMax in millions of US dollars for revenue. Both are server side filters, so a search for companies that have raised between one and ten million returns only those and costs credits only for those. Pair either with a founding window to isolate a cohort rather than a size band.

Can I get the technologies a company uses?

Yes. Add techStack to the add-ons and each company row carries the technologies the provider has detected for that domain. Revenue, fundraising and locations work the same way. Each add-on is a separate request and separate provider credits per company, so turn on only what you will actually use.

What happens when a company cannot be resolved?

The row is written with found: false and an error giving the provider's own reason, and the run continues to the next entry. Misses are not charged for. Set skipNotFound to true to leave them out of the dataset entirely.

How does this handle the provider's rate limit?

The documented limit is 100 requests per minute per key, in a fixed window. The actor spaces its requests to stay under that rather than sprinting into the limiter, and requestsPerMinute lets you lower the pace further when the same key is being used by another job at the same time.

How much does a run cost?

Pricing is pay per result: you are charged for each company returned to the dataset, and never for misses or duplicates. Add-ons do not add to the per-result price. Apify platform usage is included. Your own API provider's credits are separate and billed by them.

Keyword map

company enrichment API, company search API, B2B company data API, firmographics API, domain to company data, company lookup by domain, company technographics API, tech stack lookup API, company revenue data, company funding data, employee count data, industry filter company search, CRM enrichment API, lead list building, account intelligence, company profile enrichment, bulk company enrichment, company name to domain