realestate APIrealestate.com.au ↗
Access Australian property listings for sale, rent, and recently sold via the realestate.com.au API. Includes property details, school proximity, and location search.
What is the realestate API?
The realestate.com.au API exposes 4 endpoints covering active listings, sold properties, detailed property records, and nearby schools across Australia. The search endpoint accepts a location string — suburb, postcode, city, or state — and returns paginated summaries of buy or rent listings, while get_property_details delivers address, price, bed/bath/parking counts, media URLs, and inspection times for a specific listing ID.
curl -X GET 'https://api.parse.bot/scraper/16eea48f-8e4a-4bcc-b631-3cd9a0152e60/search?page=1&purpose=buy&location=melbourne' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for property listings for sale or rent. Returns paginated results with property summaries. Supports location-based search by suburb, city, postcode, or state. Each page returns up to ~25 listings. The total count reflects server-side matches for the location and purpose. When listed_since is provided, results are automatically sorted by date (newest first) and filtered to only include properties listed within the specified time period; listings older than the period or without listing date information are excluded from results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| purpose | string | Listing type: 'buy' or 'rent' |
| locationrequired | string | Suburb, city, postcode, or state to search in (e.g. 'melbourne', 'sydney', '2000') |
| listed_since | string | Filter results to only properties listed within the specified time period. When provided, results are sorted by date newest first. Listing date availability is limited to approximately the most recent 7 days of listings. |
{
"type": "object",
"fields": {
"total": "integer total number of matching listings",
"listings": "array of property listing summaries including listed_date field"
},
"sample": {
"data": {
"total": 3851,
"listings": [
{
"id": "149037324",
"url": "https://www.realestate.com.au/property-149037324",
"price": "Contact Agent",
"state": "Vic",
"suburb": "Melbourne",
"address": "1202/60 A'beckett Street, Melbourne, Vic 3000",
"parking": 1,
"bedrooms": 1,
"postcode": "3000",
"bathrooms": 1,
"property_type": "Apartment",
"short_address": "1202/60 A'beckett Street"
}
]
},
"status": "success"
}
}About the realestate API
Search and Sold Listings
The search endpoint accepts a required location parameter (e.g. 'sydney', '2000', 'richmond') and an optional purpose of 'buy' or 'rent'. Results are paginated at roughly 25 listings per page; the total field reflects the full server-side match count for that location and purpose, so you can calculate page depth before iterating. The get_sold_properties endpoint mirrors this interface but targets recently sold properties, returning sold_price, sold_date, and standard property summary fields — useful for building comparable sales datasets by suburb or postcode.
Property Details
get_property_details takes a property_id string obtained from search results and returns a single listing record. The response includes the full address, suburb, state, postcode, price as display text, bedrooms, parking, and a media object containing separate arrays for images, floorplans, and videos. Inspection times and the listing company are also returned, making the endpoint sufficient for building a full property detail view without a follow-up call.
Nearby Schools
get_nearby_schools accepts a lat/lon coordinate pair and returns up to 5 schools in each of three arrays: all, primary, and secondary. Each school record includes name, sector, type, year range, street address, coordinates, and distance from the queried point. Coordinates for any listing can be derived from the address fields returned by get_property_details, and the school data is categorised so you can surface the right tier without client-side filtering.
The realestate API is a managed, monitored endpoint for realestate.com.au — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when realestate.com.au changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official realestate.com.au API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate suburb-level rental listings by iterating
searchwithpurpose: 'rent'across multiple postcodes - Build a sold-price history dataset for comparable market analysis using
get_sold_propertiesfiltered by suburb - Populate a property detail page with images, floorplans, price, and inspection times from
get_property_details - Display the nearest primary and secondary schools on a listing map using
get_nearby_schoolswith listing coordinates - Monitor new listings in a target postcode by polling
searchand tracking changes in thetotalcount - Compile bed/bath/parking distribution statistics across a suburb by paginating
searchresults - Support a school-catchment filter in a property search tool by combining
get_nearby_schoolsdata with listing addresses
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does realestate.com.au have an official developer API?+
What does the `search` endpoint return, and how does pagination work?+
total integer and a listings array of up to roughly 25 property summaries. To retrieve all results for a location, increment the page parameter starting from 1 and continue until you have collected total listings. The purpose parameter controls whether you see buy or rent listings; omitting it may return a default set.Does the API return auction results or price history for individual properties?+
get_sold_properties endpoint returns sold price and sold date at the listing level, and get_property_details returns the current asking price as display text. Historical price series or auction clearance data per property are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting that data.Is there a limit on how many schools `get_nearby_schools` returns per category?+
all, primary, secondary). If you need a broader radius or more results per category, the current response cap applies and cannot be adjusted via parameters. You can fork this API on Parse and revise it to modify the result limit or add a radius parameter.Does the `search` endpoint support filtering by price range, number of bedrooms, or property type?+
location, purpose, and page as inputs. Filters for price range, bedroom count, or property type (house, unit, land) are not exposed as parameters. The listings array does include fields like bedrooms and price that you can filter client-side after retrieval. You can fork this API on Parse and revise it to add those filter parameters.