List Locations

Search for US locations by name. Use this endpoint to find FIPS codes for counties, place IDs for cities, look up ZIP codes, or browse states so you can pass the right code values to your property and people searches.

Not sure what FIPS code to use for a county? Search by name here, then pass the returned code directly into your search request's locations array.

For interactive address or city entry, use Autocomplete Addresses. It is bounded to 10 suggestions, skips the count query, and can return both address components and normalized DealMachine locations.

Query Parameters

query qstringrequired

Search query. Matches against location names, location codes, state abbreviations, and common place-name abbreviations. Minimum 1 character.

Examples: "Harris", "Travis County", "St. Louis", "saint louis", "9021", "MO", "Missouri"

query typestring

Filter results to a specific location type.

Options: county, city, zip_code, state

When omitted, all matching location types are returned.

query statestring

Filter results to a specific state. Two-letter state abbreviation (e.g., "TX", "CA").

Useful when searching for common county names that exist in multiple states (e.g., "Washington County" exists in 30 states).

query per_pageintegerdefault: 25

Number of results to return per page. Maximum 100.

query pageintegerdefault: 1

Page number for paginated results.

Response Fields

Location Object

The shape of each location object depends on its type:

All Types

Field	Type	Description
`location_id`	string	Unique DealMachine location identifier (e.g., `"loc_county_48201"`, `"loc_city_7333"`, `"loc_zip_code_90210"`, `"loc_state_FL"`)
`type`	string	Location type: `"state"`, `"county"`, `"city"`, or `"zip_code"`
`code`	string	The code to use in search location objects (state abbreviation, FIPS code, city place ID, or ZIP code)
`name`	string	Human-readable name (e.g., `"Harris County"`, `"Florida"`, `"Beverly Hills"`)
`property_count`	integer	Approximate number of properties in this location

County-specific

Field	Type	Description
`state`	string	Two-letter state abbreviation
`state_name`	string	Full state name

ZIP Code-specific

Field	Type	Description
`state`	string	Two-letter state abbreviation
`state_name`	string	Full state name

City-specific

Field	Type	Description
`state`	string	Two-letter state abbreviation
`state_name`	string	Full state name

Pagination

Field	Type	Description
`page`	integer	Current page number
`per_page`	integer	Results per page
`total_results`	integer	Total matching locations
`total_pages`	integer	Total number of pages

Using Results in Searches

The code returned for each location is the exact value you pass into a search request's locations array:

1234567891011// 1. Search for "Harris" to find the FIPS code
// GET /v1/locations?q=Harris&type=county
// → Returns { "location_id": "loc_county_48201", "code": "48201", "name": "Harris County", ... }

// 2. Use the code in a property search
{
  "locations": [
    { "type": "county", "code": "48201" }
  ],
  "filters": [...]
}

Credits

This endpoint does not consume credits. Location lookups are included with your API plan.

Notes

Search is case-insensitive and matches partial names, codes, state abbreviations, and state names. Searching "MO" with type=state returns Missouri. Searching "har" will match "Harris County", "Harrison County", "Hardeman County", etc.
Common place-name abbreviations are normalized across location types. Searching "saint louis" and "st louis" returns the same matching city and county names.
Results are ranked by relevance: exact matches appear first, followed by prefix matches, then partial matches.
The property_count is an approximate count and is updated periodically. Use Count Properties for precise counts with filters applied.
When the state query parameter is used with type=state, it filters to that specific state.
ZIP codes that span multiple counties return the primary county.