State or Region → Companies

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

Introduction

Target companies headquartered in US states or non-US regions. Combine it with any other filter in the same request (AND logic).

AI agent prompt

Read https://docs.seamless.ai/api-catalog/company-filters/state. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/companies with the `companyState` 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 '{"companyState": ["CA"], "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={"companyState": ["CA"], "limit": 25}).json()["data"]

Reference

Parameter	Type	Required	Description
`companyState`	string[]	Yes	US state names or abbreviations and non-US subdivisions (`"CA"`, `"California"`, `"Ontario"`). A company matches if it is in any of these states, narrowed by `companyCountry` when supplied. Prefix a value with `-` to exclude it. Non-US regions use the English spelling — `"Bavaria"`, not `"Bayern"`. Unknown values match nothing and come back under `warnings` with suggestions. Up to 10 values.
`locationRadius`	string	No	Widen the company location filters by a radius in miles: `25`, `50`, `100`, or `250`.
`limit`	integer	No	Results per page, up to 500. Default `50`.
`nextToken`	string	No	Cursor from `supplementalData.nextToken` to fetch the next page.

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

State or Region → Companies

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response