Skip to main content
Location filters match a fixed vocabulary of hundreds of thousands of cities and postal codes. A misspelled place returns an empty result that looks like a market with no contacts. The Location Lookup API returns the exact spelling to send, and how many contacts sit behind each match.

Endpoint

GET /search/locations

Credits

Free

Results

Up to 100 per request, most contacts first

Parameters

Allowed values for types: city-state-country, state-country, city-country, country, postcode Which type goes with which filter:

Example

Response
Use count to tell apart places that share a name: the Canadian province has far more contacts behind it than the California city. Send the location string exactly as returned, for example "Austin, Texas, United States".
You don’t need a lookup for US state names and abbreviations, or for the country aliases US, USA, and United States of America.
For Python, JavaScript, and other languages, see Look up location filter values in the API reference.