B2B Company Data API - Search Companies and Contacts

Search a B2B database of companies and the people who work at them, and resolve IP addresses to the companies behind them. Every match comes back as a flat row: company name, domain, logo, full address with coordinates, industries, employee band, revenue and register details, or for contacts the full name, job title, department, seniority, email and company.

What this actor does

• Searches companies by name, alternative name, trade name or domain, by country, city, postal code, region code or street, by a geo radius around a point, by industry code, by employee band, by revenue range, or against your saved ideal customer profiles.
• Filters on data completeness, which is what separates a usable list from a long one: only companies with a phone, an email, a social profile, known revenue, earnings or net worth, or IP data.
• Searches contacts at those companies by name, job title phrase, department, seniority, affiliation, email or company ID, so a company list you already built becomes a people list.
• Resolves IP addresses to companies for visitor identification, when your account carries that subscription.
• Respects how the provider charges. Searches consume no provider credits; full company profiles do. Profile fetching is therefore opt-in, and every run reports the credits the provider says it charged.
• Resolves your account automatically. Leave the account ID empty and the actor asks the API which accounts your key reaches and uses it.

Input

Field	What it does
dataset	Companies, contacts, or IP to company.
searchTerms	Matched against company name, alternative names, trade name and domains.
countryCodes, cities, postalCodes, regionCodes, street	Address narrowing, paired in order rather than crossed.
latitude, longitude, radiusKm	Radius search around a point, capped at 500 km.
industryClassification, industryCodes	Industry codes plus the table they belong to.
employeeRanges	Fixed headcount bands.
revenueMin, revenueMax	Revenue range in euros.
icpIds	Match against saved ideal customer profiles, combined with OR.
has_phone, has_email, and the other presence flags	Data completeness filters.
contactSearchTerms, positions, departments, hierarchyLevels, affiliation, contactEmails, companyIds, buyerPersonaIds	Contact search criteria.
ipAddresses	Addresses to resolve to companies.
fetchFullProfiles	Merge each company's full profile into its row. Spends provider credits.
advancedBody, advancedContactBody	Raw search bodies for anything this form does not list.
accountId, useBearerToken	Account scoping and OAuth support.
pageSize, maxResults	Page size and the hard cap on spend.
apiKey	Your own API key, sent in the X-Api-Key header. Stored as a secret.

Example output

{
  "recordType": "company",
  "matched": true,
  "id": "129011",
  "name": "Beispiel Logistik GmbH",
  "url": "https://www.example.de",
  "domain": "example.de",
  "logoUrl": "https://logos.example.com/example-de.png",
  "street": "Durlacher Allee 73",
  "postalCode": "76131",
  "city": "Karlsruhe",
  "regionCode": "DE1",
  "countryCode": "DE",
  "latitude": 49.01,
  "longitude": 8.43,
  "industries": ["Software", "Marketing services"],
  "employeeRange": "101-500",
  "revenueAmount": 42000000,
  "revenueCurrency": "EUR",
  "raw": { }
}

Frequently asked questions

What data does this B2B company API return?

Company rows carry the provider company ID, name, website URL and bare domain, logo URL, street, postal code, city, region code and country code with latitude and longitude, the industry list, the employee band, revenue amount and currency, the company's role and its trade register ID and name. Contact rows carry the contact ID, full, first and last name, position, department, seniority level, affiliation, email, phone, LinkedIn URL, and the ID and name of the company they work at.

Do I need my own API key?

Yes. This actor does not include data access. You use your own API key from Dealfront, which is the provider whose API this actor calls, found under API tokens in your personal settings. Your own plan, credits and terms apply. Paste the key into the apiKey field, where it is stored as an Apify secret and sent in the X-Api-Key request header rather than as a URL parameter, so it never appears in a log line or a redirect. If you authenticate with an OAuth access token instead, turn on useBearerToken.

Do I have to look up my account ID?

No. Leave accountId empty and the actor lists the accounts your key reaches and uses the first one, logging which it picked. If your key reaches several accounts and you want a specific one, set the ID explicitly.

How do I filter by industry?

Pick the classification table first, then supply codes from that table. internal is the provider's own classification and the right default; nace and wz are there when you specifically need them. These fields take codes, not industry names, so look the codes up in the provider's published list for the classification you chose.

Why must employee ranges be written with a dot?

They are fixed band strings defined by the provider, and the provider writes thousands with a dot: 501-1.000, not 501-1000. The input offers them as a dropdown so you cannot mistype one, and any value outside the documented set is dropped rather than sent.

Does searching cost provider credits?

No. Searches consume no credits. Credits are spent when you retrieve deep data for a company not accessed in the last twelve months, which is why fetchFullProfiles is off by default. Every run logs the credit total the provider reported for the work it did.

How do I go from a company list to the people at those companies?

Run once with dataset set to companies and collect the rows. Then run again with dataset set to contacts and paste those company IDs into companyIds, optionally narrowing by departments, hierarchyLevels or positions.

Why did my IP enrichment run fail with access denied?

IP enrichment is a separate subscription. When the account does not have it, the provider returns HTTP 403 access_denied on every call and retrying will not help. The actor reports that as a final error rather than retrying. Ask your provider to enable the subscription, or use the company and contact searches instead.

How much does a run cost?

Pricing is pay per result: you are charged for each company or contact returned to the dataset. Duplicates and IP addresses that resolve to no company are not charged. Apify platform usage is included in the per-result price. Your own provider credits are separate and billed by them.

Keyword map

B2B company data API, company search API, contact search API, firmographic data, IP to company API, website visitor identification, lead generation API, ICP company list, employee range filter, revenue filter, NACE industry search, company domain lookup, sales prospecting data, job title search API, decision maker contacts, European company data