Company Information API - Domain Lookup and Search

Turn a list of domains, work email addresses or company names into full company records, or discover new companies from filters. Lookup mode enriches what you already have. Search mode finds what you do not: filter by industry, SIC and NAICS code, employee band, revenue band, country, state, city, world region and business type. You pay only for the companies actually matched and returned.

This actor is built for enriching a CRM or signup list with firmographics, building target account lists, and cleaning up a spreadsheet of domains into something a sales team can use.

What you can do with it

• Enrich a list of domains or work email addresses into full company records.
• Turn a column of company names into domains, logos and firmographics.
• Build a target account list by industry, headcount band, revenue band and country.
• Segment by business type: private, public, subsidiary, government, education or non profit.
• Pull social profiles and identifiers for every account, including LinkedIn, Crunchbase and stock ticker.
• Export everything as JSON, CSV or Excel, or push it into a CRM or warehouse.

Features

• Two modes in one actor: bulk lookup for a list you already have, and filtered search for discovery.
• Lookup accepts domains, full URLs and work email addresses, reducing an address such as jane@example.com to its domain automatically.
• A value the provider cannot match is stored as a row with matched: false and is never charged, so a lookup list keeps its shape and you can see exactly what failed.
• skipUnmatched drops those rows entirely when you would rather have a clean file.
• Every documented search filter is a real input field, with region and business type as proper dropdowns.
• Search pagination follows the provider's own next-page pointer, and treats a short page as the end rather than guessing.
• Duplicate companies are removed across pages and across lookup values, keyed on domain then id then name, before anything is charged.
• Remaining provider credits are read from every response and reported at the end of the run.
• The untouched provider payload is kept under raw, so nothing is lost.
• Rate limits are handled with retry-after aware backoff, and a run that hits a limit keeps everything already collected.
• Pay-per-result pricing with a hard result cap so a run can never surprise you.

Input

Field	Type	Description
mode	string	lookup to enrich a list, search to discover by filters.
domains	array	Lookup: domains, URLs or work email addresses.
companyNames	array	Lookup: company names to resolve.
companyIds	array	Lookup: the provider's own company ids.
searchText	string	Search: free text across the company record.
companyNameFilter	string	Search: company name contains this text.
searchDomains	array	Search: restrict to these domains.
industries / industryIds	array	Search: industry names or ids.
sicCodes / naicsCodes	array	Search: classification codes.
employees / revenues	array	Search: employee and revenue bands.
countries / states / cities / regions	array	Search: location filters.
businessTypes	array	Education, government, non profit, public, private, subsidiary.
excludeEu	boolean	Leave out companies based in the European Union.
rawFilters	object	Any extra search filter, merged last.
skipUnmatched	boolean	Drop unmatched lookup rows instead of keeping them.
maxResults	integer	Stop after this many companies (1 to 20,000).
pageSize	integer	Search: companies per API call (1 to 100).
apiKey	string	Your API key. Required, stored securely.

Lookup mode needs at least one domain, name or id. Search mode needs at least one filter.

Example output

Each dataset item is one company. Fields are populated where the provider has data, and the untouched payload is kept under raw:

{
  "id": "1234567",
  "name": "Example Analytics",
  "domain": "example.com",
  "website": "https://example.com",
  "description": "Example Analytics builds revenue forecasting software for subscription businesses.",
  "industry": "Computer Software",
  "sicCode": "7372",
  "sicDescription": "Prepackaged Software",
  "naicsCode": "541511",
  "naicsDescription": "Custom Computer Programming Services",
  "employees": 310,
  "revenue": 44000000,
  "yearFounded": 2013,
  "type": "private",
  "ticker": null,
  "exchange": null,
  "phoneNumber": "+1 617-555-0188",
  "faxNumber": null,
  "address": "88 Example Avenue",
  "city": "Boston",
  "state": "MA",
  "zip": "02110",
  "county": "Suffolk",
  "country": "United States",
  "logo": "https://logo.uplead.com/example.com",
  "linkedinUrl": "https://www.linkedin.com/company/example-analytics",
  "twitterUrl": "https://twitter.com/exampleanalytics",
  "facebookUrl": null,
  "youtubeUrl": null,
  "instagramUrl": null,
  "crunchbaseUrl": "https://www.crunchbase.com/organization/example-analytics",
  "yelpUrl": null,
  "alexaRank": 184052,
  "matched": true,
  "requestedValue": "example.com",
  "raw": { "company_name": "Example Analytics", "domain": "example.com" }
}

Pricing and the credit model

This actor uses pay-per-result pricing. You are charged a fixed price for each matched company delivered to the dataset, after duplicates are removed. Unmatched lookups and empty runs cost nothing. Set maxResults to cap how many rows a run can collect, and set a run spending limit as a second safety net. Your own provider plan meters its own credits separately, and the actor logs how many you have left at the end of each run.

Bring your own API key

This actor connects to a third-party B2B company data provider (UpLead) on your behalf and requires your own provider API key. Create a key in your provider account settings and paste it into the apiKey input. It is stored securely and never logged, and the actor never ships with or shares credentials.

Frequently asked questions

What data does this actor return?

Company name, domain and website, description, industry with SIC and NAICS codes and descriptions, employee count, annual revenue, year founded, business type, stock ticker and exchange, phone and fax, the full postal address broken into street, city, state, zip, county and country, logo, and social and reference profiles including LinkedIn, Twitter, Facebook, YouTube, Instagram, Crunchbase and Yelp, plus the global website rank. Every record also carries the untouched provider payload.

What is the difference between lookup and search?

Lookup takes identifiers you already have, one company per domain, work email address, company name or provider id, and is the right mode for enriching a CRM export or a signup list. Search takes filters and pages through everything that matches, and is the right mode for building a new target account list.

Can I look a company up from an email address?

Yes. Put the address in domains and the actor reduces jane@example.com to example.com before calling the provider. Full URLs with a scheme and path are reduced the same way.

What happens when a company cannot be matched?

The row is still written, with matched set to false and requestedValue holding what you asked for, and it is not charged. That keeps a lookup file aligned with its input. Turn on skipUnmatched if you would rather those rows were dropped.

Is a domain or a company name the better lookup key?

A domain, every time. Domains are unique and already normalised, whereas a company name can be ambiguous, abbreviated or shared across unrelated businesses. Use names only where you have no domain.

How do employee and revenue bands work?

They are band labels from the provider rather than free numbers, so a filter takes a value such as 201-500 rather than a minimum and maximum. Pass several bands to widen the range. The returned employees and revenue fields are kept as numbers when the provider sends numbers and as the band text when it sends a label.

How does search pagination work?

The provider returns a meta block with the total, the current page and a next-page pointer. The actor follows that pointer, stops when there is no next page, and treats a page shorter than requested as the end rather than guessing at another call.

How do I know how many provider credits I have left?

Every response carries the remaining credit balance, and the actor logs it when the run finishes. Charging on the actor side and credit consumption on the provider side are separate meters, so watch both.

How does the actor handle rate limits?

It throttles requests, honours the retry-after signal on a rate-limited response, and backs off exponentially. A response saying the account is out of credits stops the run early and keeps everything already collected.

How am I charged?

You pay a fixed price per matched company returned to the dataset. Duplicates and unmatched lookups are not charged and empty runs cost nothing. Use maxResults and the run spending limit to control cost.

What output formats are available?

The dataset can be exported as JSON, CSV, Excel, HTML or RSS, or read through the API for pushing into a CRM or warehouse.

Keyword map

company information api, company data api, domain to company api, company enrichment api, b2b company database api, email to company lookup, company name to domain, firmographic data api, sic naics code lookup, company revenue data api, employee count data api, company logo api, linkedin company url lookup, target account list builder, crm data enrichment, b2b prospecting data, company search by industry, bulk domain enrichment, account based marketing data, company technographics and firmographics.