[August 4, 2025] Property API v2 Enhancements

v0.37.0

Important: SDK upgrade (v1.15.0) required to access new features.

This release introduces the enhanced /v2/property_search endpoint, which consolidates the v1 two-step workflow (find properties → get events) into a single configurable POST request. Users can now retrieve property metadata and housing-event history in one call with precise filtering.

Unified property search and event retrieval

The /v2/property_search endpoint replaces the previous two-step process with a single POST request that can return both property metadata and event history based on your configuration.

Search scope options

The endpoint supports three distinct search methods:

parcl_property_ids

Search specific properties by their unique identifiers. This search method supports up to 10,000 properties per request.

parcl_ids

Search entire markets (city, county, ZIP, metro) by market identifier.

geo_coordinates

Search within a custom radius around specified coordinates. Maximum radius of 10 miles.

Additional search filters

Control what data is returned to customize and optimize response:

include_property_details

Set to 1 to return full property metadata including address, geocode, beds/baths, year built, ownership status, etc. Set to 0 for ID and event-only responses.

include_events

Set to 1 to include any events  filtered by your event criteria. Set to 0 for metadata-only responses.

include_full_event_history

Set to 1 to return all recorded events for each property. Set to 0 to return only events matching your filters. include_events must be set to 1 as well in order to return the full event history.

Filtering capabilities

Current-state filters

Filter properties by current characteristics using new filtering capabilities introduced in v0.38.0.

These filters capture properties that currently meet specific criteria, including beds, baths, square footage, year built, on-market status, current owner name, investor/owner-occupied flags, and new-construction status.

Historical filters

• event_filters: Filter by event types, date ranges, and price ranges
• owner_filters: Filter properties by historical ownership or owner type

Pagination

Use limit parameter to control response size, supporting up to 50,000 properties per request.

Migration note: v1 endpoints remain available, but v2 offers improved performance and flexibility. Migration to v2 is recommended.

For questions, contact [email protected], post on the community forum, or check the full Property API v2 reference.