Location → Companies

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

Introduction

Free-form city, state, or country targeting for company headquarters, with an optional 25-250 mile radius. Combine it with any other filter in the same request (AND logic).

AI agent prompt

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

Reference

Parameter	Type	Required	Description
`locations`	string[]	Yes	Free-form location filter — city, state/region, or country — and the only filter that reaches city-level matching. Use a single place (`"Austin"`) or comma-separated to disambiguate (`"Austin, Texas"`). Prefix a value with `-` to exclude it. A company matches if it is in any of these places, or in any `companyState`. Use `GET /search/locations` to find a city and pass the returned `location` verbatim. Up to 10 values.
`locationRadius`	string	No	Widen `locations`, `companyState`, and `companyZipCode` to everything within a radius of each value, in miles. Only geocodable values get a radius — a city or zip code does, a country does not. The label `25 miles` and legacy options `1`-`4` (25, 50, 100, 250 miles) are accepted too.
`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 locationRadius: 25, 50, 100, 250

Resolve city spellings first with the Location Lookup API.

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

Location → Companies

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response