> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seamless.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Company Search API

> Build target account lists by industry, SIC/NAICS, headcount, revenue, location, technologies, funding, and company news.

The Company Search API returns companies that match your ideal customer profile. Each result carries a `searchResultId` that you pass to the [Company Research API](https://docs.seamless.ai/api-catalog/company-enrichment.md) for the full firmographic record.

> [card] Endpoint
>
> `POST /search/companies`

> [card] Credits
>
> Charged per results returned. Empty pages are free.
> [Details](https://docs.seamless.ai/core-concepts/credits.md)

> [card] Page size
>
> Up to 500 per page. Paginate with `nextToken`.

## Use it for

* Building a total addressable market (TAM) list for a territory or segment.
* Finding companies that use, or recently adopted, specific technologies.
* Timing outreach to funding rounds, expansions, leadership changes, and acquisitions.
* Matching a list of company names or domains to Seamless records.

## Filters

| Category | Filters |
| - | - |
| Identity | `companyName`, `companyNameSearchType`, `companyDomain`, `companyKeyword`, `keywordsIsOr` |
| Firmographics | `companySize`, `companyRevenue`, `foundedOn`, `companyType` |
| Industry | `industry`, `industrySicCodes`, `industryNaicsCodes` |
| Location | `locations`, `locationRadius`, `companyState`, `companyCountry`, `companyZipCode` |
| Technology | `technologies`, `technologiesIsOr` |
| Signals | `newsTypes`, `newsTypeDates`, `latestFundingDates`, `latestFundingClassifications`, `latestFundingTotals` |
| Paging | `limit`, `nextToken`, `page`, `savedSearchId` |

See the [API reference](https://docs.seamless.ai/api-reference/v1/company-search/search-companies.md) for every allowed value.

## Example

```bash theme={null}
curl -X POST https://api.seamless.ai/api/client/v1/search/companies \
  -H "Token: $SEAMLESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": ["Computer Software"],
    "companySize": ["51 - 200", "201 - 500"],
    "technologies": ["Salesforce"],
    "newsTypes": ["Investment"],
    "newsTypeDates": ["90"],
    "limit": 50
  }'
```

```json Response (trimmed) theme={null}
{
	"data": [
		{
			"searchResultId": "a1b2c3d4-e5f6-3a4b-8c9d-1e2f3a4b5c6d",
			"companyName": "Acme Corp",
			"domain": "acme.com",
			"industries": ["Computer Software"],
			"companySize": "201 - 500",
			"employeeCount": "340",
			"fundingTotal": "$24M",
			"companyRevenue": "$20M - $50M",
			"technologies": ["Salesforce", "HubSpot"],
			"latestFundingDate": "2026-08-14",
			"numContacts": "212",
			"city": "Austin",
			"state": "Texas",
			"country": "United States"
		}
	],
	"supplementalData": { "isMore": true, "total": 812, "nextToken": "..." }
}
```

> [!TIP]
>
> Want the people too? Pass the same domains to the [Contact Search
> API](https://docs.seamless.ai/api-catalog/contact-search.md) with `companyDomain` and persona filters.

For Python, JavaScript, and other languages, see [Search companies](https://docs.seamless.ai/api-reference/v1/company-search/search-companies.md) in the API reference.

## Related

* [Company Research API](https://docs.seamless.ai/api-catalog/company-enrichment.md)
* [Location Lookup API](https://docs.seamless.ai/api-catalog/location-lookup.md)
* [API reference: Search companies](https://docs.seamless.ai/api-reference/v1/company-search/search-companies.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.