---
title: "Search companies"
method: POST
path: "/search/companies"
tags: ["Company Search"]
---

# Search companies

`POST /search/companies`

## Request body

- object
  - `nextToken` string — Opaque cursor token from a previous `/search/companies` response. Use this to fetch the next page of results.
  - `limit` integer — Number of companies to return per page before credit-based trimming is applied.
  - `companyName` string[] — 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).
  - `companyDomain` string[] — Company website domains to match (for example root domains without protocol).
  - `companyState` string[] — Company location state filters. Combined with country/zip filters as part of location matching.
  - `companyCountry` string[] — Company location country filters. Combined with state/zip filters as part of location matching.
  - `companyZipCode` string[] — Company postal/zip code filters for location-based matching.
  - `industry` string[] — Industry categories to include in results. Valid values are the fixed industry list below.
  - `companyKeyword` string[] — Free-text keywords used to match company profile text (name, description, and related indexed company data).
  - `companySize` string[] — Employee size bands to match against company headcount ranges.
  - `companyRevenue` string[] — Revenue range bands to match estimated company revenue.
  - `technologies` string[] — Technologies used by the company. Sample enum values for documentation only (not exhaustive; actual values come from API/typeahead).
  - `technologiesIsOr` boolean — 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.
  - `foundedOn` string[] — Company age buckets based on founding date.
  - `newsTypes` string[] — Filter companies by news/event classification type.
  - `newsTypeDates` string[] — Limit news/event results to a rolling day window (60, 90, 180, or 365 days). Only the first value is applied.
  - `latestFundingDates` string[] — Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).
  - `latestFundingClassifications` string[] — Filter companies based on the classifications of their latest funding round.
  - `latestFundingTotals` string[] — Filter companies based on the total funding amount they have raised.

## Response `200`

Company Search Results

- object
  - `data` object[] — A list of companies
    - `searchResultId` string — Stable identifier for this search result item, used by enrichment/research endpoints.
    - `name` string — Canonical company name.
    - `street1` string — Primary street line for the company location.
    - `street2` string — Secondary street line for the company location.
    - `street3` string — Additional street/location line when provided.
    - `city` string — City of the company location.
    - `state` string — State or region of the company location.
    - `postCode` string — Postal/zip code of the company location.
    - `country` string — Country of the company location.
    - `domain` string — Primary website domain for the company.
    - `description` string — Short company profile/summary text.
    - `liUrl` string — Public LinkedIn company profile URL when available.
    - `sicCode` string — Standard Industrial Classification (SIC) code associated with the company.
    - `industries` string[] — Industry categories associated with the company.
    - `revenueRange` string — Revenue band bucket assigned to the company.
    - `annualRevenue` string — Estimated annual revenue value, when available.
    - `staffCountRange` string — Employee headcount band for the company.
    - `employeeCount` string — Estimated employee count.
    - `numContacts` string — Number of contacts currently associated with this company in indexed results.
    - `technologies` string[] — Technologies detected for the company.
    - `linkedInId` string — LinkedIn company ID when available.
    - `companyLIURL` string — Alternate LinkedIn company URL source returned from social metadata when available.
    - `foundedOn` string, date — Company founding date.
    - `newsAndEvents` object[] — Recent news articles related to the company.
      - `title` string — The headline of the news article.
      - `url` string — The URL to the full news article.
      - `date` string, date-time — The date the news article was published.
      - `type` string — The type of news article (e.g., "Acquisition").
    - `fundingTotal` string — Most recent total funding amount for the company.
    - `latestFundingDate` string, date — The date of the most recent funding round for the company.
    - `latestFundingClassifications` string[] — The classifications of the most recent funding round for the company.
    - `companyType` 'Public' | 'Private', nullable — Company type — "Public" or "Private" when determined.
    - `stockTicker` string, nullable — Stock ticker symbol of the company, if publicly traded.
  - `supplementalData` object — Pagination metadata for the current search result set.
    - `isMore` boolean — Indicates whether additional pages of results are available beyond the current page.
    - `total` integer — The total number of contacts matching the search criteria.
    - `perPage` integer — The number of results returned per page for this search request.
    - `nextToken` string, nullable — An opaque pagination token. Pass this value in the `nextToken` field of your next request body to retrieve the next page of results. Null or absent when no more pages are available.

## Other responses

- `401` — Unauthorized
- `422` — Insufficient credits or missing license
- `500` — Unexpected error

---

[API](https://skmtc.dev/seamless/apis/seamless-api.md) · [All operations](https://skmtc.dev/seamless/apis/seamless-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/seamless/seamless-api/revisions/447164d1d713/schema)