MARKET EVENTS
Marketing-price changes
Returns only public marketing-price text changes, within the last 90 days. Hidden numeric search ranges and private price history are excluded. Contact details embedded in text are suppressed. Empty or redacted values remain null.
/api/v1/events/price-changes3 credits / callParameters
| Parameter | Type | Description |
|---|---|---|
state | string | Australian state or territory code.ACT, NSW, NT, QLD, SA, TAS, VIC, WA |
postcode | string | Exact four-digit postcode. |
property_type | string | Normalised public property type.house, apartment, unit, townhouse, villa, land, rural, commercial, other |
agency_id | integer | Agency identifier from the agency endpoint. |
updated_since | string | UTC ISO 8601 timestamp; at most 90 days ago. |
page | integer | Page number, 1–20. Deep exports are unavailable. |
per_page | integer | Records per page, 1–50. |
MAKE IT YOUR OWN
Build a request
Edit the parameters to generate a ready-to-use code example. No request runs until you select Send request. Python uses the requests package; PHP requires cURL; JavaScript examples run on your backend with Node.js 18 or later.
Example response
Illustrative structure, not a live property record. Fields may be null when the source has not supplied a value.
{
"data": [
{
"id": "event_123",
"property_id": "123456",
"old_marketing_price": "Offers over $950,000",
"new_marketing_price": "Offers over $900,000",
"observed_at": "2026-11-07T00:30:00Z",
"state": "QLD",
"postcode": "4000",
"property_type": "house",
"agency_id": "12"
}
],
"meta": {
"example": true,
"credit_cost": 3
}
}Also available through MCP
Use the listingdata_price_changes tool with the same documented inputs. Calls share your REST API credit balance and rate limits. Connect your MCP client →
Errors and retrying
| Status | Meaning | Recommended handling |
|---|---|---|
400 / 422 | Invalid or unsupported parameters. | Correct the input using the error response. |
401 / 403 | Invalid key or ineligible account. | Check key status and account verification. |
404 | The requested record is not available. | Check the ID; do not infer a property’s status. |
402 | Monthly credit allowance exhausted. | Wait for the next UTC calendar month. |
429 | Minimum interval or daily request allowance exceeded. | Honour Retry-After and reset details. |
503 | A required data service is unavailable. | Back off and retry later. Service-side charges are refunded. |
Property descriptions, internal search price bands and agent contact email or telephone numbers are never included. Source status and timestamps describe observations, not a guarantee of current availability. Future-dated source times are withheld. A record’s indexed_at is its last public index write; use the coverage endpoint for the last completed refresh cycle. Read the field policy.