Company Revenue → Companies

POST /search/companies · Credits charged per results returned · v1, v2 · Part of the Company Search API

Introduction

Target companies by estimated annual revenue band. Combine it with any other filter in the same request (AND logic).

AI agent prompt

Read https://docs.seamless.ai/api-catalog/company-filters/company-revenue. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/companies with the `companyRevenue` filter to find companies matching: <your target>. Page with nextToken and keep each searchResultId.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/companies \
  -H "Token: $SEAMLESS_API_KEY" -H "Content-Type: application/json" \
  -d '{"companyRevenue": ["$20M - $50M"], "limit": 25}'

import os, requests
rows = requests.post("https://api.seamless.ai/api/client/v1/search/companies",
    headers={"Token": os.environ["SEAMLESS_API_KEY"]},
    json={"companyRevenue": ["$20M - $50M"], "limit": 25}).json()["data"]

Reference

Parameter	Type	Required	Description
`companyRevenue`	string[]	Yes	Revenue range bands to match estimated company revenue. Up to 10 values.
`limit`	integer	No	Results per page, up to 500. Default `50`.
`nextToken`	string	No	Cursor from `supplementalData.nextToken` to fetch the next page.

Allowed values for companyRevenue: $0 - $100K, $100K - $1M, $1M - $5M, $5M - $20M, $20M - $50M, $50M - $100M, $100M - $500M, $500M - $1B, $1B+

Response

Rows are company previews with searchResultId, companyName, domain, address, industry, size, revenue, and technologies. Send searchResultId to Company Research for the full record. Fields: Company Search. Auth: Token header (API keys) · Errors: status codes · Billing: rate limits and credits

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Company Revenue → Companies

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response