Property Search
Property Search is the list-building endpoint: 150+ filters over the nationwide parcel file, with paging, sorting, and three cost-saving result modes. Take a count first to size a search for free, then page through results and enrich the ones you want with Property Detail.
Run count first. A count query returns the size of the result set without
spending credits, so you can compare searches before committing to one. See
Paging and result modes.
Search properties
Request attributes
- Name
count- Type
- boolean
- Description
Return only the number of matches. Does not spend credits — use it to size a search before running it.
- Name
ids_only- Type
- boolean
- Description
Return only property IDs, for cheap multi-step workflows that enrich later.
- Name
summary- Type
- boolean
- Description
Return predefined geographic summary statistics instead of records.
- Name
size- Type
- integer
- Description
Results per page, up to 250.
- Name
resultIndex- Type
- integer
- Description
Offset to start from. Combine with
sizeto page.
- Name
ids- Type
- array
- Description
Restrict the search to a specific set of property IDs.
- Name
sort- Type
- object
- Description
Sort clause over any sortable field.
- Name
obfuscate- Type
- boolean
- Description
Mask owner personal information in the response.
- Name
city- Type
- string
- Description
City to search. One geo field is required.
- Name
state- Type
- string
- Description
Two-character state code.
- Name
county- Type
- string
- Description
County to search.
- Name
zip- Type
- string
- Description
Five-digit ZIP code.
- Name
latitude- Type
- number
- Description
Latitude for a radius search, paired with
longitudeandradius.
- Name
longitude- Type
- number
- Description
Longitude for a radius search.
- Name
radius- Type
- number
- Description
Radius in miles around the given point.
- Name
polygon- Type
- array
- Description
Array of lat/lon points bounding the search area.
- Name
multi_polygon- Type
- array
- Description
Multiple polygons, for non-contiguous areas.
- Name
property_type- Type
- string
- Description
Property type to filter on.
- Name
property_use_code- Type
- integer
- Description
One or more property use codes.
- Name
mls_active- Type
- boolean
- Description
Only properties currently active on the MLS.
- Name
mls_days_on_market_min- Type
- integer
- Description
Minimum days on market.
- Name
mls_listing_price_max- Type
- integer
- Description
Maximum current listing price.
Request
curl -X POST https://api.realestateapi.com/v2/PropertySearch \
-H "x-api-key: $REALESTATEAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"city": "Austin", "state": "TX", "count": true}'
The full response schema for this endpoint — every field and enum — lives in the canonical reference. That content has not been ported to this site yet.