Sign in

v1

latestOpenAPI 3.0.02026-07-1390307.4 KB
Company Search

Search companies

post/search/companies

Request body

nextTokenstring

Opaque cursor token from a previous /search/companies response. Use this to fetch the next page of results.

limitinteger

Number of companies to return per page before credit-based trimming is applied.

companyNamestring[]

Company names to match. Use this when you know full company names or key name fragments.

companyNameSearchType'default' | 'related' | 'exact'

Matching strategy for companyName (default = standard matching, related = include aliases/related names, exact = exact company name only).

companyDomainstring[]

Company website domains to match (for example root domains without protocol).

companyStatestring[]

Company location state filters. Combined with country/zip filters as part of location matching.

companyCountrystring[]

Company location country filters. Combined with state/zip filters as part of location matching.

companyZipCodestring[]

Company postal/zip code filters for location-based matching.

industrystring[]

Industry categories to include in results. Valid values are the fixed industry list below.

companyKeywordstring[]

Free-text keywords used to match company profile text (name, description, and related indexed company data).

companySizestring[]

Employee size bands to match against company headcount ranges.

companyRevenuestring[]

Revenue range bands to match estimated company revenue.

technologiesstring[]

Technologies used by the company. Sample enum values for documentation only (not exhaustive; actual values come from API/typeahead).

technologiesIsOrboolean

If true, matches companies using any of the specified technologies (OR). If false, matches only companies using all specified technologies (AND).

companyType'Public' | 'Private' nullable

Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.

foundedOnstring[]

Company age buckets based on founding date.

newsTypesstring[]

Filter companies by news/event classification type.

newsTypeDatesstring[]

Limit news/event results to a rolling day window (60, 90, 180, or 365 days). Only the first value is applied.

latestFundingDatesstring[]

Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).

latestFundingClassificationsstring[]

Filter companies based on the classifications of their latest funding round.

latestFundingTotalsstring[]

Filter companies based on the total funding amount they have raised.

Example request

{
  "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6IjEyMzQ1In0=",
  "limit": 50,
  "companyName": [
    "Seamless AI"
  ],
  "companyNameSearchType": "related",
  "companyDomain": [
    "seamless.ai"
  ],
  "companyState": [
    "CA"
  ],
  "companyCountry": [
    "United States"
  ],
  "companyZipCode": [
    "94105"
  ],
  "industry": [
    "Information Technology and Services"
  ],
  "companyKeyword": [
    "sales intelligence",
    "B2B SaaS"
  ],
  "companySize": [
    "51 - 200",
    "201 - 500"
  ],
  "companyRevenue": [
    "$20M - $50M"
  ],
  "technologies": [
    "Salesforce",
    "HubSpot"
  ],
  "technologiesIsOr": true,
  "companyType": "Public",
  "foundedOn": [
    "Less than 1 Year",
    "Last 1-3 Years"
  ],
  "newsTypes": [
    "Acquisition",
    "Expansion"
  ],
  "newsTypeDates": [
    "60"
  ],
  "latestFundingDates": [
    "90"
  ],
  "latestFundingClassifications": [
    "Series A",
    "Seed"
  ],
  "latestFundingTotals": [
    "$0 - $100K",
    "$100K - $1M"
  ]
}

Response

Company Search Results

Example response

{
  "data": [
    {
      "searchResultId": "cmp_sr_01J8YQ4FXZQ6N5G2T3A7BC9D1E",
      "name": "Seamless.AI",
      "street1": "800 W El Camino Real",
      "street2": "Suite 180",
      "street3": "Building B",
      "city": "Mountain View",
      "state": "CA",
      "postCode": "94040",
      "country": "United States",
      "domain": "seamless.ai",
      "description": "Seamless.AI is a sales intelligence platform for finding and engaging prospects.",
      "liUrl": "https://www.linkedin.com/company/seamless-ai/",
      "sicCode": "7372",
      "industries": [
        "Information Technology and Services",
        "Computer Software"
      ],
      "revenueRange": "$20M - $50M",
      "annualRevenue": "35000000",
      "staffCountRange": "51 - 200",
      "employeeCount": "125",
      "numContacts": "487",
      "technologies": [
        "Salesforce",
        "HubSpot",
        "Marketo"
      ],
      "linkedInId": "1234567",
      "companyLIURL": "https://www.linkedin.com/company/seamless-ai/",
      "foundedOn": "2015-01-01",
      "fundingTotal": "135000000",
      "latestFundingDate": "2018-01-01",
      "latestFundingClassifications": [
        "Series D"
      ],
      "companyType": "Public",
      "stockTicker": "AAPL"
    }
  ],
  "supplementalData": {
    "isMore": true,
    "total": 150,
    "perPage": 5,
    "nextToken": "eyJwYWdlIjoyLCJzZWFyY2hJZCI6ImFiYzEyMyJ9"
  }
}