Business Firmographics API - US Company Data, SIC and NAICS

Turn a list of web addresses, phone numbers, stock tickers or company addresses into structured US business records: standardized company name, verified postal address, phone, employee count, sales volume, EIN, SIC and NAICS codes with descriptions, location type, geocode and named contacts, one flat row per business.

What this actor does

• Looks up a business from whichever identifier you actually have. A web address, a 10 digit phone number, a stock ticker or a freeform address string is each a complete lookup on its own, so a messy list still enriches without being cleaned up first.
• Looks up a business by company name and address, with a search pivot you can point at whichever field your data is strongest on.
• Sends up to 100 records per request. The provider has a real batch protocol, so a 5,000 row list is 50 requests rather than 5,000, and the actor paces itself to the records-per-second ceiling of your plan.
• Returns the data groups you ask for: employee count, sales volume, EIN with up to three NAICS and SIC codes and their descriptions, location type, ZIP+4 and address keys, latitude and longitude, county and census geography, and named contacts with titles and emails.
• Reads the provider's own result codes. A row is only counted as a match when the response reports one, and a miss carries the documented reason, so you can tell a genuine no-match from an input that never met the minimum requirements.
• Pairs every answer back to the right input by the record ID that travels with each record, not by array position, so a reordered or short batch still lands each row against the query that produced it.
• Never charges for a miss. Only rows whose result codes report a matched business are billed.

Input

Field	What it does
domains	Company web addresses. A pasted URL is reduced to the bare hostname.
phones	10 digit business phone numbers.
stockTickers	Stock exchange ticker symbols, for example MSFT.
freeformQueries	Whole addresses or other minimum inputs as single unsplit strings.
businessRecords	JSON records using comp, a1, city, state, postal, phone, web, stock.
columns	Which extra data groups to return on top of the defaults.
centricHint	Which input the search centres on: address, company or phone.
maxContacts	Upper limit on contacts returned per business.
returnDominantBusiness	Whether to return the dominant business at an address when the name does not match.
sicNaicsConfidence	Loose returns any industry code; strict returns only high confidence codes.
batchSize	Records per request, up to the provider's maximum of 100.
recordsPerSecond	Pace the run to your plan's documented throughput.
skipUnmatched	Leave unresolved inputs out of the dataset.
maxResults	Hard cap on rows, and therefore on spend and run time.
apiKey	Your own licence key. Stored as a secret.

Example output

{
  "matched": true,
  "query": "example.com",
  "companyName": "Example Labs Inc",
  "enterpriseKey": "323318841",
  "addressLine1": "500 Market St",
  "suite": "Ste 300",
  "city": "Rancho Santa Margarita",
  "state": "CA",
  "postalCode": "92688-2112",
  "plus4": "2112",
  "countryCode": "US",
  "phone": "9497654321",
  "webAddress": "example.com",
  "stockTicker": "",
  "employeesEstimate": "320",
  "salesEstimate": "48000000",
  "locationType": "Headquarters",
  "locationTypeCode": "1",
  "ein": "954321098",
  "naicsCodes": ["541511", "541512"],
  "naicsDescriptions": ["Custom Computer Programming Services", "Computer Systems Design Services"],
  "sicCodes": ["7372"],
  "sicDescriptions": ["Prepackaged Software"],
  "latitude": "33.640",
  "longitude": "-117.601",
  "countyName": "Orange",
  "totalContacts": "8",
  "contacts": [
    { "NameFirst": "Jane", "NameLast": "Doe", "Title": "Chief Executive Officer", "Email": "jane@example.com" }
  ],
  "resultCodes": ["AS01", "FS01", "FS07", "GS05"],
  "raw": { }
}

Frequently asked questions

What data does the Business Firmographics API return?

Every matched business returns the standardized company name, the current company name on file at that address, a unique enterprise key, the verified postal address with suite and ZIP+4, and the result codes for the match. Requesting the optional data groups adds the employee count estimate, the sales volume estimate, the phone, the web address, the stock ticker, the location type, the EIN with up to three NAICS and SIC codes and their descriptions, address keys and country, latitude and longitude, county, FIPS, census tract and block, and named contacts with first name, last name, gender, job title, phone and email.

Do I need my own API key?

Yes. This actor does not include data access. You use your own licence key from Melissa, which is the provider whose Business Coder API this actor calls, created on their developer portal. 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 the request body rather than a URL parameter, so it never appears in a log line or a redirect.

What is the minimum input for a lookup?

Any one of five combinations: an address with city and state or postal code, a freeform string containing one of the others, a phone number, a stock ticker, or a web address. A company name alone is not enough, which is why company records need an address or a phone alongside the name. When a record falls short the provider says so with code FE02 and the actor writes that reason into the row.

How fast can a large list run?

The provider accepts up to 100 records per request, so throughput is set by your plan rather than by request count: roughly 5 records per second on pay-as-you-go, 12 on self-service, 50 on business and 100 on enterprise. Set recordsPerSecond to match your plan and the actor paces to it. The default of 5 is safe on every plan.

How do I get decision-grade industry codes?

Set sicNaicsConfidence to strict. The provider then returns only the SIC and NAICS codes it is confident are correct and returns nothing where it is not, instead of returning any loosely associated code. That is the setting you want when the codes drive lead routing, scoring or territory assignment, because a null is more useful than a wrong code.

Can I get contact names at each business?

Yes. Add Contacts to the data groups and each matched business returns an array of people with first name, last name, gender, job title, phone and email. Use maxContacts to raise or lower the number returned per business; the provider defaults to five.

What is the difference between a match and a dominant business?

A match means the provider found the specific business you asked about. A dominant business is the main occupant of an address, returned when the company name is missing or does not match what is on file there. That behaviour is on by default and is usually what you want when enriching addresses. Turn returnDominantBusiness off when you only want exact company matches and would rather see a miss than a neighbour.

What happens when an input matches no business?

The row is written with matched: false, the provider's result codes, and an error giving the documented reason: no match, minimum input not met, or multiple matches with no way to choose. The run continues to the next record. 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 matched business returned to the dataset, and never for misses or duplicates. Apify platform usage is included in the per-result price. Your own API provider's credits are separate and billed by them.

Keyword map

business firmographics API, US company data API, company lookup by phone, domain to company data, SIC code lookup, NAICS code lookup, EIN lookup API, employee count data, company revenue estimate, business address verification, B2B data append, CRM enrichment API, business contact data, stock ticker to company, company geocoding, headquarters vs branch data, batch company enrichment