Skip to main contentSkip to main content

Recently-modified event feed (Starter+ tier)

GET/v1/properties/recently-modified3 credits

Costs 3 credits per call, so poll at a sensible interval (every 15 minutes is 8,640 credits a month). Mirror-sync feed for listing mutations, newly matched sold records, and withdrawals since an ISO timestamp. Use it to keep your local copy fresh without re-walking every suburb. `since` must be within the last 30 days. **`withdrawn` is how you learn a listing ended.** A property that stops being advertised simply disappears from the suburb endpoints, so polling those can never tell you it is gone: without this event a synced copy accumulates listings that are no longer live. It is REVERSIBLE: a relist produces a later `listing_update` for the same property_id, so apply events in `event_date` order and let the latest win rather than treating a withdrawal as final. Withdrawn events carry the last known asking price from before the listing was pulled. **Filter to your area.** Pass `state` and/or `postcode` (up to 50, comma-separated) so you only pay for the events you keep.

Parameters

NameInRequiredDescription
sincequeryyesISO 8601 timestamp within the last 30 days
event_typequerynoall (default), listing_update, sold, or withdrawn
statequerynoOnly events in this state (e.g. NSW)
postcodequerynoOnly events in these postcodes, comma-separated, up to 50 (e.g. 2500,2502)
limitquerynoPage size (default 20, max 20; larger values are reduced to 20)
cursorquerynoOpaque cursor from the previous response's `pagination.next_cursor`

Example request

curl "https://api.propradar.com.au/v1/properties/recently-modified?since=2026-05-29T00%3A00%3A00Z&event_type=all&limit=20" \
  -H "X-API-Key: pr_live_..."

Example response

{ "query": { "since": "2026-05-29T00:00:00.000Z", "event_type": "all", "limit": 20 },
  "events": [{ "event_type": "listing_update", "event_date": "2026-05-31T02:12:00.000Z",
               "property_id": "a1b2c3d4", "summary": { "suburb": "PASCOE VALE" } },
             { "event_type": "withdrawn", "event_date": "2026-05-30T22:40:00.000Z",
               "property_id": "e5f6a7b8", "summary": { "suburb": "COBURG",
               "asking_price_low": 780000, "asking_price_high": 830000 } }],
  "pagination": { "limit": 20, "next_cursor": "eyJk..." } }

Get an API key

Every endpoint takes an X-API-Key header. The free tier needs no credit card.

Other endpoints