Firmographic Append API - Company Data Enrichment by Domain

Turn a list of domains, business emails, company records, IP addresses, hashed emails or LinkedIn profiles into structured company records: industry, NAICS and SIC codes with descriptions, employee count, sales volume, year founded, postal address, phone and website, one flat row per match.

What this actor does

• Appends firmographics to a domain or a business email, the way you enrich a CRM export, a signup list or a form fill that only captured a work address.
• Appends firmographics to a company name plus address or phone, for the records that never had a domain in the first place.
• Resolves IP addresses to business domains, returning up to three domains per address with the firmographics for each. This is how anonymous website traffic becomes a named account list.
• Resolves hashed emails to business domains, so privacy hashed source data can still be enriched. MD5, SHA1 and SHA256 are supported in upper, lower and natural case.
• Resolves people to their employer, returning job title, seniority, department, business email and the company's firmographics from a LinkedIn URL, a name or a personal email.
• Filters matches server side. A required field value, for example Country=US, drops non-matching records before they are returned, so they never reach the dataset and are never charged for.
• Keeps every field the API returns and layers stable normalized columns on top, so one dataset holds rows from all five lookup types with the same header names.
• Records misses instead of hiding them. An input with no match becomes a row with matched: false, so a list with dead domains still finishes and you can see exactly which inputs resolved.
• Never charges for a miss. Only rows carrying an actual match record are billed.

Input

Field	What it does
domains	Company domains to append firmographics to. A pasted URL is reduced to the bare hostname.
businessEmails	Business email addresses to append firmographics to.
companyRecords	JSON records using business, address, city, state, zip, phone, for lookups by name.
ipAddresses	IPv4 addresses to resolve to business domains.
hashedEmails	MD5, SHA1 or SHA256 hashed emails to resolve to a business domain.
linkedinUrls	LinkedIn profile URLs to resolve to a person's employer and role.
personRecords	JSON records using first, last, email, domain, linkedin_url.
requireValues	Server side filters, one Field Name=Value rule per line.
skipUnmatched	Leave unresolved inputs out of the dataset.
maxRequestSeconds	Cap how long the API may spend on a single lookup.
maxResults	Hard cap on rows, and therefore on spend and run time.
apiKey	Your own API key, sent as a header. Stored as a secret.

Example output

{
  "recordType": "firmographic",
  "matched": true,
  "query": "example.com",
  "businessName": "Example Labs Inc",
  "domain": "example.com",
  "website": "https://www.example.com",
  "phone": "8005550142",
  "address": "500 Market St",
  "city": "Redmond",
  "state": "WA",
  "zip": "98052",
  "country": "US",
  "industry": "Computer Software",
  "naicsCode": "541511",
  "naicsDescription": "Custom Computer Programming Services",
  "sicCode": "7372",
  "sicDescription": "Prepackaged Software",
  "employees": "320",
  "salesVolume": "48000000",
  "yearFounded": "2011",
  "ownership": "Private",
  "queryId": "b2f1c0d4-8a91-4d2e-9f0a-1c7b5e2d3a44",
  "raw": { }
}

Frequently asked questions

What data does the Firmographic Append API return?

Each match carries the standardized business name, postal address, city, state, ZIP and country, the business phone, the company domain and website home page, the industry with its NAICS and SIC codes and descriptions, the employee count, the sales volume, the year founded, and whether the business is public or private. Person lookups additionally return job title, seniority, department, business email and LinkedIn profile URL alongside the employer's firmographics.

Do I need my own API key?

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

What inputs does a firmographic lookup need?

One of four documented combinations: a business email on its own, a company domain on its own, a business name with address, city and state, or a business name with a phone number. Anything less cannot be matched. The actor checks each record against those combinations before it sends anything, so an incomplete record is reported in the dataset and costs you no request.

How do I turn website visitors into company records?

Feed the visitor IP addresses into ipAddresses. Each IPv4 address resolves to up to three business domains, and every domain comes back with full firmographics attached, so a raw server log becomes an account list in one run. Residential and mobile addresses often resolve to nothing, which is expected and shows up as a matched: false row.

Can I enrich data that has already been hashed for privacy?

Yes. Put the hashes into hashedEmails. MD5, SHA1 and SHA256 are supported in upper, lower and natural case, and each hash resolves to the associated business domain without the plain address ever leaving your systems.

How do I only keep records from one country or industry?

Add a rule to requireValues in the form Field Name=Value, for example Country=US. The filter is applied by the API before results are returned, so non-matching records never reach your dataset and are never billed. Add more lines to require more fields at once.

What happens when an input has no match?

The row is written with matched: false and an error explaining the miss, and the run continues to the next input. Misses are not charged for. Set skipUnmatched to true to leave them out of the dataset entirely.

How much does a run cost?

Pricing is pay per result: you are charged for each match record returned to the dataset, and never for misses, rejected records or duplicates. Apify platform usage is included in the per-result price. Your own API provider's match allowance is separate and billed by them.

How many requests does a run make?

One per input, because every data tool here is one record per request. A 500 domain list is 500 requests. The provider documents a limit of 20 queries per second and the actor paces itself well under that, backing off on HTTP 429, so a large list finishes rather than tripping the limiter halfway through.

Keyword map

firmographic append API, company data enrichment, B2B data append, domain to company data, email to company lookup, IP to company API, IP to domain, website visitor identification, hashed email enrichment, HEM to domain, NAICS code lookup, SIC code lookup, employee count data, company revenue data, CRM enrichment API, lead enrichment API, account based marketing data, person to company match