Developer documentationAPI v1Download OpenAPI ↗

MAKE YOUR FIRST REQUEST

Your window into
the Australian market.

Search observed listing data, follow marketing price changes and build with market signals. One consistent JSON API, with clear boundaries and predictable credit costs.

Open access, verified accounts.

The API requires a key from an SMS-verified account. “Open” means accessible to developers with a free tier; it does not mean anonymous access or unrestricted redistribution.

01

Create & verify

Register your developer account and verify an Australian mobile number.

Create an account ↗
02

Create your key

Generate an API key in your account. Copy it once and keep it in a server-side secret store.

Authentication →
03

Make a request

Use a Bearer token over HTTPS. Check the endpoint’s credit cost before you call it.

View an endpoint →

A first request

This example uses your API key and consumes the selected endpoint’s published credits. It returns the limited public property view.

cURL
curl --get 'https://www.listingdata.com.au/api/v1/properties' \
  --header "Authorization: Bearer $LISTINGDATA_API_KEY" \
  --header 'Accept: application/json' \
  --data-urlencode 'state=QLD' \
  --data-urlencode 'per_page=10'

Explore the reference

GETSearch properties

Search observed Australian sale listings by public address, location, type and attributes.

1 credit per call →
GETGet a listing

Retrieve the public fields for one observed listing.

1 credit per call →
GETNewly observed listings

Listings first observed in the last seven days; this is not an asserted original listing date.

1 credit per call →
GETRecently updated listings

Listings updated or observed in the last seven days, newest observation first.

1 credit per call →
GETConfirmed withdrawn listings

Listings explicitly labelled withdrawn by the source. A missing page alone is not a withdrawal.

1 credit per call →
GETNo longer observed

Records archived or removed from observation. They may be sold, relisted or temporarily unavailable; withdrawal is not inferred.

1 credit per call →
GETUnder-offer listings

Observed listings flagged under offer; status can change before the next index refresh.

1 credit per call →
GETUnder-contract listings

Observed listings flagged under contract.

1 credit per call →
GETReported sold listings

Source-reported sold status. Does not provide settled sale prices or settlement evidence.

1 credit per call →
GETMarketing-price changes

Observed changes to public advertised price text. A wording change is not necessarily a numeric reduction.

3 credits per call →
GETListing marketing-price history

Public marketing-price changes for a listing within the last 90 days.

3 credits per call →
GETObserved market summary

Counts of observed listings, grouped by status and property type; not a census of the Australian property market.

5 credits per call →
GETListings by state

Facet counts from the public index for the selected filters. Groups capped at 100; counts reflect observed coverage.

5 credits per call →
GETListings by property type

Facet counts from the public index for the selected filters. Groups capped at 100; counts reflect observed coverage.

5 credits per call →
GETListings by status

Facet counts from the public index for the selected filters. Groups capped at 100; counts reflect observed coverage.

5 credits per call →
GETListings by agency

Facet counts from the public index for the selected filters. Groups capped at 100; counts reflect observed coverage.

5 credits per call →
GETListings by suburb

Facet counts from the public index for the selected filters. Groups capped at 100; counts reflect observed coverage.

5 credits per call →
GETBrowse agencies

Agency names and identifiers with observed listing counts. No contact information.

2 credits per call →
GETAgency summary

Public agency name and observed listing count, without agent names, contacts or source credentials.

2 credits per call →
GETAgency listings

Search observed public listings for a specific agency.

1 credit per call →
GETSearch suburbs

Search Australian postcode locality reference data. Not a full address-validation service.

1 credit per call →
GETPostcode localities

Find Australian reference localities for an exact postcode. Postcodes can contain several localities.

1 credit per call →
GETProperty type reference

Supported public property-type values.

0 credits per call →
GETListing status reference

Supported statuses and their evidence limits.

0 credits per call →
GETCoverage and index freshness

Observed index counts, last completed refresh and coverage caveats. No claim of complete national coverage.

0 credits per call →
GETAccount credits and limits

Current credit balance and account-wide request limits. This call costs zero credits but still respects request delays.

0 credits per call →

Use the observations responsibly

ListingData reflects the sources and observations available to it. A listing disappearing from a source is not proof of a sale. Marketing price text is not a valuation. Data may lag a change, and missing fields stay unknown rather than being inferred.

Read about coverage and freshness →