Company Search

Search companies with industry, employee, location, and technology filters.

Company Search

POST /company_search

Company Search costs 0.20 credit per company returned.

Search companies by industry, size, location, technologies, and more. Results are paginated. Use the helper lookups (Search Keywords, Search City Codes, Search States Codes, Search Country Codes) to resolve the slug codes these filters expect.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
industries	array[string]	Optional. Industry slugs to include (see Search Keywords).
not_industries	array[string]	Optional. Industry slugs to exclude.
ai_keywords	array[string]	Optional. Keyword terms, merged into industries.
company_names	array[string]	Optional. Exact company-name matches.
employee_buckets	array[string]	Optional. Size buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+.
business_types	array[string]	Optional. e.g. private, public.
country_codes	array[string]	Optional. HQ countries (ISO-3166 alpha-2/alpha-3 or full name).
city_codes	array[string]	Optional. HQ city slug codes (see Search City Codes).
technologies	array[string]	Optional. Active technology slugs.
year_founded_min	integer	Optional. Minimum year founded.
year_founded_max	integer	Optional. Maximum year founded.
query	array[object]	Optional. Raw query conditions to append.
search	string	Optional. Fuzzy search against company name/domain.
domains_to_exclude	array[string]	Optional. Domains to exclude from results.
size	integer	Optional. Page size 1–100 (default 10).
page	integer	Optional. Page number, 1-based. Minimum 1, defaults to 1.
simplified	boolean	Optional. Return a slim payload (default false).

Response

The rows are under data. See Response Format for the fields every endpoint returns.

Field	Description
organization_name	Company name.
domain	Bare domain, no scheme and no www..
company_website	Website URL.
company_linkedin_url	LinkedIn company page.
industry	Primary industry.
industries	All industries on the record.
company_size	Headcount bucket, e.g. 501-1000.
headcount	Exact headcount when known.
headquarters	Object with city, state, country, country_code and raw.
company_description	Short description of the company.
company_tech_stack	Technologies currently in use.
year_founded	Year the company was founded.
business_type	e.g. private, public.
revenue_range	Revenue band.
monthly_visitors	Estimated monthly website visitors.
naics_codes	NAICS industry codes.
sic_codes	SIC industry codes.
email_patterns	Known company email patterns.
socials	Social profile URLs by network.
careers_url	Careers page URL.
extra	Any remaining provider fields that have no canonical name.

Alongside the rows, the response carries total (companies matching the search), page, page_size and credits_per_row.

Example

Input

{
  "api_key": "your_api_key",
  "industries": ["software-development"],
  "country_codes": ["us"],
  "size": 2
}

Output

{
  "status": "success",
  "data": [
    {
      "organization_name": "Whole Foods Market",
      "domain": "wholefoodsmarket.com",
      "company_website": "https://wholefoodsmarket.com",
      "company_linkedin_url": "https://www.linkedin.com/company/wholefoods",
      "industry": "retail",
      "industries": ["retail-groceries", "online-and-mail-order-retail"],
      "company_size": "501-1000",
      "headcount": 780,
      "headquarters": {
        "city": "Austin",
        "state": "Texas",
        "country": "United States",
        "country_code": "us",
        "raw": "550 Bowie St, Austin, TX 78703"
      },
      "company_description": "Natural and organic grocery retailer.",
      "company_tech_stack": ["cloudflare", "google-analytics"],
      "year_founded": 1980,
      "business_type": "public",
      "revenue_range": "over-1b",
      "monthly_visitors": 12000000,
      "naics_codes": ["445110"],
      "sic_codes": ["5411"],
      "email_patterns": ["{first}.{last}"],
      "socials": { "linkedin": "https://www.linkedin.com/company/wholefoods" },
      "careers_url": "https://www.wholefoodsmarket.com/careers"
    }
  ],
  "credits_used": 0.4,
  "credits_remaining": 4000.6,
  "total": 41774,
  "page": 1,
  "page_size": 2,
  "credits_per_row": 0.2,
  "success": true
}

Error

{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "page: Input should be greater than or equal to 1"
  },
  "success": false
}