Skip to main contentSkip to main content
PropRadarAPI
Get free key

Batch property lookup (Starter+ tier)

POST/v1/properties/bulk2 credits per address

POST an array of {address, postcode} items; returns each with full property data or found:false. Costs 2 credits per address resolved, the same as looking each up individually. Starter+ plans only. Per-request cap is plan-dependent: Starter = 2, Pro = 3, Growth = 5, Scale = 10, Enterprise = 25. Send an `Idempotency-Key` header to make retries safe; replays return the cached response and refund the credits.

Parameters

NameInRequiredDescription
Idempotency-KeyheadernoOpaque, caller-chosen, <=200 printable-ASCII chars. Stored 24h. Replays return cached response with `Idempotent-Replayed: true`; same key with different body returns 422.

Example request

curl -X POST "https://api.propradar.com.au/v1/properties/bulk" \
  -H "X-API-Key: pr_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "addresses": [
    {
      "address": "1/8 Bristol Rd, Pascoe Vale",
      "postcode": "3044"
    }
  ]
}'

Example response

{ "results": [{ "input": {...}, "property_id": "a1b2c3d4", "found": true, "attributes": {...} }], "summary": { "total": 1, "found": 1, ... } }

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