Skip to main contentSkip to main content
PropRadarAPI
Get free key

Recent sold comparables (Hobby+; lat/lng mode Pro+)

GET/v1/comparables2 credits

Costs 2 credits. Sold properties within a radius and time window of a reference point, ranked by distance. `property_type` is exact-match, case-insensitive: pass "House" for houses only, not "Townhouse". Use `pagination.next_cursor` to walk deeper than the offset cap. Requires Hobby or higher; Free keys get 403 plan_upgrade_required (credits refunded). Specify the reference point EITHER as `property_id` (Hobby+) OR as `lat`+`lng` (Pro+); sending both is a 400. Reach for `lat`/`lng` when the subject property is not in our data: address lookup covers on-market listings and properties with a sold record, so a long-held, never-listed home resolves in neither and 404s on the `property_id` path. That is a coverage limit, not a plan gate (upgrading does not change it), so geocode the address yourself and pass the point.

Parameters

NameInRequiredDescription
property_idquerynoReference property already in the dataset. Mutually exclusive with lat/lng.
latquerynoLatitude of your own reference point (Pro+). Requires lng. Australia only (-44 to -9); out of range returns 400, which also catches a swapped pair.
lngquerynoLongitude of your own reference point (Pro+). Requires lat. Australia only (112 to 154).
radius_mquerynoSearch radius in metres (default 1000, max 5000)
monthsquerynoLook-back window in months (default 12, max 24)
property_typequerynoExact match, case-insensitive. e.g. House, Apartment, Townhouse, Unit, Villa. If omitted, Land and Commercial are excluded (not comparable to a dwelling); pass the type explicitly to get them.
bedsquerynoMatch exact bedroom count
limitquerynoPage size (default 20, max 20). Use `cursor` for deeper walks.
cursorquerynoOpaque cursor from the previous response's `pagination.next_cursor`. Preferred for deep pagination.
offsetquerynoLegacy offset pagination. Capped at 100: use `cursor` to walk deeper or narrow `radius_m`/`months`.

Example request

curl "https://api.propradar.com.au/v1/comparables?lat=-32.059&lng=115.957&radius_m=1000&months=12" \
  -H "X-API-Key: pr_live_..."

Example response

// lat/lng mode: property_id is null, geo echoes your own point.
{
  "reference": { "property_id": null, "address": null,
                 "geo": { "lat": -32.059, "lng": 115.957 } },
  "comparables": [{ "property_id": "...", "distance_m": 280, "sold_price": 712000, ... }],
  "pagination": { "limit": 20, "offset": 0,
                  "next_cursor": "eyJkbSI6MjgwLCJpIjoiYTFiMmMzZDQifQ", "next_offset": 20 }
}

Get an API key

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

Get a free API keyFull API documentation

Other endpoints