Lookalike Audience

Find companies similar to a set of seed companies, one page at a time.

POST /lookalike

Lookalike Audience costs 0.2 credits per similar company returned. The seed companies are never charged and never returned. A search that finds nothing is free.

Give a few companies you like, such as your best customers, as domains and get back one page of similar companies. Each company comes back with the same fields as Company Search.

Your balance must cover page_size × 0.2 credits before the search runs, or the call is refused with HTTP 402 and nothing is charged. You are then charged only for the companies on the page that comes back.

To save the results into a list, or to get more than 100 at once, use Lookalike Audience List. A large seed set can take up to 60 seconds here. A slower search answers HTTP 504 and charges nothing.

Headers

Name	Value
Content-Type	application/json

Body

Name	Type	Description
api_key	string	Your API Key.
seed_domains	array[string]	1 to 200 company domains, e.g. ["stripe.com", "adyen.com"]. URLs, www. hosts and email addresses are cut down to the bare domain. Free-mail domains such as gmail.com, and duplicates, are dropped.
page	integer	Optional. Page of results, from 1. Default 1.
page_size	integer	Optional. Companies per page, 1 to 100. Default 25.

Response

See Response Format for the fields every endpoint returns.

Field	Description
status	success, or not_found when no similar companies were found (free).
data	The similar companies: organization_name, domain, company_website, company_linkedin_url, industry, company_size, headcount, headquarters, company_description, company_tech_stack, year_founded, revenue_range and more.
total	How many similar companies the search found in all.
page, page_size	The page you asked for.
seed_count	How many seeds were used after clean-up.
credits_per_row	Credits per company returned.
credits_used	Credits charged for this page.
credits_remaining	Your balance after the call.

Example

Input

{
  "api_key": "your_api_key",
  "seed_domains": ["gusto.com", "rippling.com"],
  "page": 1,
  "page_size": 3
}

Output

{
  "status": "success",
  "data": [
    {
      "organization_name": "Paychex",
      "domain": "paychex.com",
      "company_website": "https://paychex.com",
      "company_linkedin_url": "https://linkedin.com/company/paychex",
      "industry": "human-resources-services",
      "industries": ["payroll-services", "hr-technology-software", "benefits-administration"],
      "company_size": "10001+",
      "headcount": 15240,
      "headquarters": {
        "city": "Rochester",
        "state": "New York",
        "country": "United States",
        "country_code": "us",
        "raw": "911 panorama trail south"
      },
      "company_description": "Paychex, Inc. (NASDAQ: PAYX) is a leading provider of integrated human capital management solutions for payroll, HR, retirement, and insurance services...",
      "company_tech_stack": [],
      "year_founded": 1971,
      "business_type": "public-company",
      "revenue_range": "over-1b",
      "monthly_visitors": "1m-10m",
      "careers_url": null
    }
  ],
  "credits_used": 0.6,
  "credits_remaining": 4322.8,
  "total": 1801,
  "page": 1,
  "page_size": 3,
  "credits_per_row": 0.2,
  "seed_count": 2,
  "success": true
}

Error: no usable seeds

Returned with HTTP 422 when no company domain is left after clean-up. Nothing is charged.

{
  "status": "error",
  "error": {
    "code": "http_error",
    "message": "None of the seed_domains is a company domain (free-mail domains such as gmail.com are dropped). Nothing was charged."
  },
  "success": false
}

Results lean towards larger, well-known companies, and seeds from one clear niche give the closest matches. Look at a small page before saving hundreds into a list.