[February 19, 2025] Address Intelligence, Beta Flexible Property Queries, Price Cut Metric Update

v0.28.0

This release transforms address search from simple validation to rich property intelligence, introduces a powerful unified property and event query engine in beta, and enhances price reduction tracking capabilities.

What's New & Why It Matters:

🔍 Smarter Address Search: Complete property context with every address-level property search → available here: /v1/property/search_address

🎯 Unified Query Engine (Beta): Property and event analysis through a single, flexible endpoint → available here: /v2/property_search

📉 Enhanced Price Cut Metrics: New percentage-based tracking of inventory price reductions → available here: /v1/for_sale_market_metrics/{parcl_id}/for_sale_inventory_price_changes

Added Address Search Enhancements

Address Search now delivers comprehensive property intelligence through /v1/property/search_address. Our enhanced resolution engine transforms each address query into detailed property insights. Each search returns:

Unique identifier: parcl_property_id for additional API queries
Physical attributes: bedrooms, bathrooms, square footage, year built
Location intelligence: precise geospatial coordinates plus full geographic hierarchy with associated market identifiers
Event analytics: flags for past sales, rentals, and listings since 2010
Current ownership status: owner occupancy, investor ownership, institutional owner
Optional mapping: maintain your system IDs via source_id

Expanded response payload now includes comprehensive property details:

{
  "items": [{
    "parcl_property_id": 12345,
    "address": "123 Main St",
    "unit": "4B",
    "city": "New York",
    "zip_code": "10001",
    "state_abbreviation": "NY",
    "county": "New York County",
    "cbsa": "New York-Newark-Jersey City",
    "latitude": 40.7505,
    "longitude": -73.9965,
    "property_type": "CONDO",
    "bedrooms": 2,
    "bathrooms": 2.0,
    "square_footage": 1200,
    "year_built": 1930,
    "cbsa_parcl_id": 2900187,
    "county_parcl_id": 2899750,
    "city_parcl_id": 2899625,
    "zip_parcl_id": 2899500,
    "event_count": 5,
    "event_history_sale_flag": 1,
    "event_history_rental_flag": 0,
    "event_history_listing_flag": 1,
    "current_new_construction_flag": 0,
    "current_owner_occupied_flag": 1,
    "current_investor_owned_flag": 0,
    "current_entity_owner_name": null,
    "source_id": "internal_id_123"
  }],
  "account": {
    "est_credits_used": 1,
    "est_remaining_credits": 9999
  }
}

Beta Release: Unified Property Query Engine (Premium Feature)

New /v2/query endpoint combines and enhances property search and event history capabilities:

Before: Two-step process
1. Search properties via /v1/property/search with limited filtering
2. Pull events via /v1/property/events for each property
Now: Single unified query
- One request combines property search and event history
- Rich filtering across all dimensions:
  - Property attributes (beds, baths, sqft, year built)
  - Event details (type, date ranges, price thresholds)
  - Ownership characteristics (investor status, institutional owners)
- Support for focused queries AND bulk operations
- Optimize credit usage with sorting and limit parameters

Example request:

{
  "event_filters": {
    "event_names": [
      "SOLD",
      "PENDING_SALE",
      "LISTED_RENT"
    ],
    "is_new_construction": false,
    "max_event_date": "2024-12-31",
    "max_price": 800000,
    "min_event_date": "2023-01-01",
    "min_price": 100000
  },
  "owner_filters": {
    "is_investor_owned": true,
    "is_owner_occupied": false,
    "owner_name": [
      "PROGRESS_RESIDENTIAL"
    ]
  },
  "parcl_ids": [
    2899625,
    2900187
  ],
  "property_filters": {
    "include_property_details": true,
    "max_beds": 5,
    "max_year_built": 2020,
    "min_baths": 1,
    "min_beds": 1,
    "min_sqft": 1000,
    "min_year_built": 2010,
    "property_types": [
      "SINGLE_FAMILY"
    ]
  },
  "query_type": "property_events"
}

Available to paid subscribers during beta period. We are actively seeking feedback on this new endpoint to guide future enhancements - please share your experience in our forum or email us directly at [email protected].

Added Price Reduction Metrics Enhancement

New pct_inventory_price_drop field added to /v1/for_sale_market_metrics/{parcl_id}/for_sale_inventory_price_changes endpoint.

Shows percentage of active inventory with price reductions
Complements existing price change metrics to provide clearer view of downward price pressure

Example response now includes:


{
  "date": "2025-02-14",
  "count_price_change": 150,
  "count_price_drop": 120,
  "median_days_bt_change": 28,
  "median_price_change": -15000,
  "median_pct_price_change": -3.2,
  "pct_inventory_price_change": 15.5,
  "pct_inventory_price_drop": 12.4 // New field showing % of inventory with price cuts
}

The addition of pct_inventory_price_drop makes it easier to track market-level price reduction trends by isolating properties with price cuts from those with any price changes.