Location → Contacts

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

Introduction

Free-form city, state, or country targeting, and the only filter that matches at city level. Widen any city with a 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/contact-filters/location. Using SEAMLESS_API_KEY, call POST https://api.seamless.ai/api/client/v1/search/contacts with the `locations` filter to find contacts matching: <your target>. Page with nextToken and keep each searchResultId.

Example

curl -X POST https://api.seamless.ai/api/client/v1/search/contacts \
  -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/contacts",
    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. Values may be a single place (`"Austin"`) or comma-separated to disambiguate (`"Austin, Texas"`, `"Ontario, Canada"`). Prefix a value with `-` to exclude it. Behavior depends on the `locationType` parameter, and values are combined with `contactCountry` rather than replacing it. Cities are the largest part of the vocabulary and the part no list can enumerate — use `GET /search/locations` to find one, and pass the returned `location` string verbatim. Its `count` is what separates a name meaning several places: `"Ontario"` is a Canadian province and a larger California city. Up to 10 values.
`locationRadius`	string	No	Widen `locations` (and `contactCountry`) to everything within a radius of each value. The value is the radius in miles, sent as a string or a number. Only geocodable values get a radius — a city or zip code resolves to coordinates, a country does not. Use `zipCodesRadius` for `contactZipCode`. The spelled-out label (`25 miles`) is accepted too, as are the legacy options `1`, `2`, `3`, and `4`, which mean 25, 50, 100, and 250 miles.
`locationType`	string	No	Determines how location filters (`locations`, `contactState`, `contactCountry`, `contactZipCode`) are applied. `contact` matches the contact’s personal location only. `company` matches the company’s headquarters location only. `bothOR` matches if either the contact or the company location matches (default). `bothAND` matches only when both match. Default `"bothOR"`.
`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 Allowed values for locationType: bothOR, bothAND, company, contact

Resolve city spellings first with the Location Lookup API.

Response

Rows are contact previews with searchResultId, name, title, seniority, company, location, and LinkedIn URL, but no emails or phones. Send searchResultId to Contact Research to get them. Fields: Contact 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 → Contacts

Introduction

AI agent prompt

Example

Reference

Response

​Introduction

​AI agent prompt

​Example

​Reference

​Response

Introduction

AI agent prompt

Example

Reference

Response