Company Intelligence API

Turn a list of domains, DUNS numbers or company names into structured company profiles, and keep a watchlist current by pulling every company newly profiled in a date range.

Most enrichment tools take a domain and give you back a firmographic row. This actor wraps a company intelligence API that also carries registration country, DUNS and FIGI identifiers, stock listing, parent company, office locations and government prohibited list entries, which makes it as useful for supplier screening and entity resolution as it is for prospecting.

Two modes

Mode	What it does	What you give it
company-lookup	Resolves identifiers into full company profiles	Domains, DUNS numbers, FIGIs, provider ids or names
newly-added	Lists every company the provider profiled in a date range	A from date and a to date

Identifiers are routed by shape, so a mixed list works without sorting it first: a domain or website URL goes to the domain lookup, a nine digit number to the DUNS lookup, a code starting BBG to the FIGI lookup, any other number to the provider id lookup, and anything else to a name search. Set identifierType to force one type when your list is all company names.

Choosing fields

This provider is a GraphQL API, which means the caller chooses the fields and one unknown field fails the entire query rather than just that column. The default selection is a verified set of company profile fields, and two extra blocks are one toggle away: office locations and US government prohibited list entries.

Everything else in the schema, including financials, funding rounds, human capital, technology stack, website traffic, court filings, sustainability metrics and risk ratings, is reachable through extraSelection, a raw GraphQL fragment merged into the query. Give the field with its own subfields, for example technologies { name }. Check the subfield names against your provider's field reference before running a large job, because a wrong name fails the whole query.

Example output

{
  "recordType": "company",
  "matched": true,
  "companyId": "12345",
  "name": "Example Industrial Group",
  "homepage": "https://example.com",
  "domain": "example.com",
  "shortDescription": "Contract manufacturer of precision components.",
  "companyType": "PRIVATE",
  "status": "ACTIVE",
  "countryOfRegistration": "United States",
  "foundedYear": "1998",
  "duns": "123456789",
  "stockTicker": null,
  "parentCompany": "Example Holdings",
  "locationsCount": 7,
  "headquartersCity": "Cleveland",
  "headquartersCountry": "United States",
  "tags": ["Manufacturing", "Aerospace"],
  "linkedin": "https://www.linkedin.com/company/example",
  "queriedIdentifier": "example.com",
  "queriedAs": "domain"
}

Every row also carries raw, the untouched provider record, so anything you added through extraSelection survives the flattening even though it is not modelled by name.

Pricing

Pay per result. You are charged once per company profile saved to the dataset. Duplicates are removed before charging, and an identifier that resolves to nothing is stored with matched: false free of charge, so a list of dead domains costs you nothing. Apify platform usage is included in the per-result price. Your own provider plan is billed separately by the provider.

Bring your own API key

This actor does not include data access. You use your own API key from Craft, which is the provider whose company data API this actor calls. The key is sent as a request header and never logged.

FAQ

What is a company intelligence API?

A company intelligence API returns a structured profile for a company rather than a single data point: identity and registration details, corporate hierarchy, locations, listings, and depending on your plan, financials, headcount, technology and risk signals. This actor wraps one and turns its results into a dataset you can export as CSV, JSON or Excel, or pull from another tool.

Can I look companies up by DUNS number?

Yes. Paste the DUNS numbers into companyIdentifiers and they are routed to the DUNS lookup automatically, because a nine digit value is unambiguous. Set identifierType to duns if your numbers arrive with formatting that makes the shape less obvious.

How do I get fields the actor does not return by default?

Use extraSelection and give a raw GraphQL fragment, for example employees { count } websiteTraffic { visits }. It is merged into the generated query. The returned values land in the raw column of each row. If you would rather control the whole document, use rawQuery instead: it receives one variable named value holding the identifier, and must return the company under a top-level company field.

What happens if I ask for a field my plan does not include?

The provider answers with a GraphQL error rather than an HTTP failure, and the actor tells you when the error text reads like an entitlement problem rather than a typo. Remove the field from the selection and rerun. Because GraphQL fails the whole query on one bad field, test a new selection against a single identifier before running it across a long list.

Can I pull more than 30 days of newly profiled companies?

Yes. The provider accepts a window of at most 30 days per request, and a longer range is split automatically into consecutive 30 day windows and walked in order, so asking for a whole quarter works in one run. Both ends of the range are inclusive.

Why are some rows marked matched false?

Because the identifier resolved to nothing. Those rows are stored so you can see exactly which inputs failed, and they are never charged for. Set skipUnmatched to true to leave them out of the dataset entirely.

How many results can one run return?

Up to 25,000 per run. The lookup mode makes one provider call per identifier, so run time scales with your list. The newly profiled mode pages at up to 100 records per call, which is the provider's maximum.

Do I need my own API key?

Yes. This actor is bring your own key, and your usage is billed on your own provider plan. The actor charges separately for each result it returns.

Keyword map

company intelligence API, company data API, company enrichment API, domain to company API, DUNS lookup API, company profile API, firmographics API, entity resolution API, supplier screening API, company hierarchy data, parent company lookup, GraphQL company API, company watchlist API, newly added companies feed