--- title: "Realestateview API: 7 endpoints, 1 credit per call" description: "Realestateview API for Australian homes to buy, rent or sold, listing details, agents, agencies and suburb lookups as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/realestateview --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Realestateview 1 credit per call 7 endpoints 25 datapoints # Realestateview API Realestateview API for Australian homes to buy, rent or sold, listing details, agents, agencies and suburb lookups as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Realestateview GET /v1/realestateview/search?mode=buy&state=vic&suburb=Melbourne&postcode=3000&beds\_min=2 ``` { "success": true, "total_results": 330, "total_results_is_estimate": false, "returned": 25, "filtered_out_count": 0, "pagination": { "page": 1, "per_page": 25, "total_pages": 9, "max_pages": 9, "has_next_page": true }, "applied_filters": { "mode": "buy", "state": "vic", "suburb": "Melbourne", "postcode": "3000", "beds_min": 2, "sort": "recommended" }, "listings": [ { "id": 18280542, "status": "On Market", "listing_type": "sale", "sale_method": "Sale", "listing_path": "/property/vic/melbourne-3000/3202-63-la-trobe-street-18280542/", "price_text": "$950,000", "is_price_hidden": true, "is_sold_price_hidden": false, "beds": 2, "baths": 2, "cars": 0, "property_type": "Apartment & Unit", "property_types": [ "Apartment & Unit" ], "source_property_type": "Apartment", "is_new_construction": false, "is_home_and_land": false, "address": { "unit_number": "3202", "street_number": "63", "street": "La Trobe Street", "suburb": "Melbourne", "postcode": "3000", "state": "VIC", "city": "Melbourne", "region": "Melbourne", "lga": "Melbourne Council", "gnaf_id": "GAVIC721180715", "is_street_hidden": false }, "lat": -37.808177, "lng": 144.969767, "images": [ { "sequence": 1, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18280542-1-14D42C8.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18280542-1-14D42C8.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18280542-1-14D42C8.jpg" }, { "sequence": 2, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18280542-2-02F3677.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18280542-2-02F3677.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18280542-2-02F3677.jpg" }, { "sequence": 3, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18280542-3-B652683.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18280542-3-B652683.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18280542-3-B652683.jpg" } ], "created_at": "2026-11-12 03:21:23", "updated_at": "2026-11-12 05:24:59", "on_market_at": "2026-11-12 03:21:23", "agents": [ { "id": 21953, "name": "Robert Eggers", "first_name": "Robert", "last_name": "Eggers", "position": "Director - Licensed Estate Agent AREI (REIV)", "phone": "03 9614 6688", "mobile": "0412329340", "photo_url": "https://view.com.au/viewstatic/images/listing/200-w/df111763950c47cba138c3051dfbed3b.jpg", "profile_path": "/agent-profile/robert-eggers-21953/", "sold_listings": 35, "average_sold_price": 578114.2857 } ], "agency": { "id": 4902, "name": "Dingle Partners Pty Ltd", "slug": "dingle-partners-melbourne", "address": "39 Queen Street, Melbourne, VIC 3000", "suburb": "Melbourne", "logo_url": "https://view.com.au/viewstatic/images/listing/300-min/0004902-o-D7n1XO4.jpg", "brand_colour": "0F1F2E", "profile_path": "/real-estate-agency/dingle-partners-melbourne-4902/" } }, { "id": 18279630, "status": "Under Contract", "listing_type": "sale", "sale_method": "Sale", "listing_path": "/property/vic/melbourne-3000/4507-81-a-beckett-street-18279630/", "price_text": "$445,000 - $475,000", "price_numeric": 450000, "is_price_hidden": false, "is_sold_price_hidden": false, "beds": 2, "baths": 1, "cars": 0, "property_type": "Apartment & Unit", "property_types": [ "Apartment & Unit" ], "source_property_type": "Apartment", "is_new_construction": false, "is_home_and_land": false, "address": { "unit_number": "4507", "street_number": "81", "street": "A'beckett Street", "suburb": "Melbourne", "postcode": "3000", "state": "VIC", "city": "Melbourne", "region": "Melbourne", "lga": "Melbourne Council", "gnaf_id": "GAVIC719458403", "is_street_hidden": false }, "lat": -37.809361, "lng": 144.961212, "images": [ { "sequence": 1, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18279630-1-EA94380.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18279630-1-EA94380.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18279630-1-EA94380.jpg" }, { "sequence": 2, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18279630-2-C36E268.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18279630-2-C36E268.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18279630-2-C36E268.jpg" }, { "sequence": 3, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18279630-3-85E0CB1.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18279630-3-85E0CB1.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18279630-3-85E0CB1.jpg" } ], "created_at": "2026-11-12 00:17:15", "updated_at": "2026-11-12 00:17:23", "agents": [ { "id": 191177, "name": "Lizzie Zhang", "first_name": "Lizzie", "last_name": "Zhang", "mobile": "0493705802", "profile_path": "/agent-profile/lizzie-zhang-191177/", "sold_listings": 22, "average_sold_price": 613636.3636 } ], "agency": { "id": 29558, "name": "Forge Group Australia Melbourne", "slug": "forge-group-australia-melbourne", "address": "Level 39 385 Bourke Street, Melbourne, VIC 3000", "suburb": "Melbourne", "logo_url": "https://view.com.au/viewstatic/images/listing/300-min/cb5fcfb183024216b2794882bfa84a33.png", "brand_colour": "0A2542", "profile_path": "/real-estate-agency/forge-group-australia-melbourne-29558/" } }, { "id": 18277759, "status": "On Market", "listing_type": "sale", "sale_method": "Sale", "listing_path": "/property/vic/melbourne-3000/1408a-8-franklin-street-18277759/", "price_text": "$450,000 - $480,000", "is_price_hidden": true, "is_sold_price_hidden": false, "beds": 2, "baths": 1, "cars": 0, "property_type": "Apartment & Unit", "property_types": [ "Apartment & Unit" ], "source_property_type": "Apartment", "is_new_construction": false, "is_home_and_land": false, "address": { "unit_number": "1408A", "street_number": "8", "street": "Franklin Street", "suburb": "Melbourne", "postcode": "3000", "state": "VIC", "city": "Melbourne", "region": "Melbourne", "lga": "Melbourne Council", "gnaf_id": "GAVIC424044036", "is_street_hidden": false }, "lat": -37.80742, "lng": 144.96199, "images": [ { "sequence": 1, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18277759-1-731F211.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18277759-1-731F211.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18277759-1-731F211.jpg" }, { "sequence": 2, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18277759-2-40564E3.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18277759-2-40564E3.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18277759-2-40564E3.jpg" }, { "sequence": 3, "url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/750-w/18277759-3-6808C59.jpg", "thumbnail_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/400-w/18277759-3-6808C59.jpg", "large_url": "https://view.com.au/viewstatic/images/listing/2-bedroom-apartment-in-melbourne-vic-3000/1200-w/18277759-3-6808C59.jpg" } ], "inspections": [ { "starts_at": "2026-11-14 11:10:00", "ends_at": "2026-11-14 11:30:00" } ], "created_at": "2026-11-11 04:20:35", "updated_at": "2026-11-11 04:20:37", "on_market_at": "2026-11-11 04:20:35", "agents": [ { "id": 112789, "name": "Sophia Zhu", "first_name": "Sophia", "last_name": "Zhu", "phone": "0433 962 828", "mobile": "0433 962 828", "photo_url": "https://view.com.au/viewstatic/images/listing/200-w/76e8ba7437f94930a24ae5d16c448496.png", "profile_path": "/agent-profile/sophia-zhu-112789/", "sold_listings": 27, "average_sold_price": 609314.8148 } ], "agency": { "id": 5953, "name": "Melcorp Real Estate", "slug": "melcorp-real-estate-melbourne", "address": "477 Swanston St, Melbourne, VIC 3000", "suburb": "Melbourne", "logo_url": "https://view.com.au/viewstatic/images/listing/300-min/16b6367d648b40e582b8121cb1746190.png", "brand_colour": "#FF5F45", "profile_path": "/real-estate-agency/melcorp-real-estate-melbourne-5953/" } } ], "meta": { "endpoint_family": "search", "attempts": 1, "request_id": "req_3a33d077279a45998b0422df1c9e147e", "credits_charged": 1, "credits_remaining": 1818 } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `search`: the fields and shapes you will get, shortened to 3 items. | # | id integer | status string | listing\_type string | sale\_method string | listing\_path string | price\_text string | is\_price\_hidden boolean | is\_sold\_price\_hidden boolean | beds integer | baths integer | cars integer | property\_type string | property\_types string\[\] | source\_property\_type string | is\_new\_construction boolean | is\_home\_and\_land boolean | address object | lat number | lng number | images object\[\] | created\_at string | updated\_at string | on\_market\_at string | agents object\[\] | agency object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 18280542 | On Market | sale | Sale | /property/vic/melbourne-3000/3202-63-la-trobe-street-18280542/ | $950,000 | true | false | 2 | 2 | 0 | Apartment & Unit | \[1 item\] | Apartment | false | false | {11 fields} | \-37.808177 | 144.969767 | \[3 items\] | 2026-11-12 03:21:23 | 2026-11-12 05:24:59 | 2026-11-12 03:21:23 | \[1 item\] | {8 fields} | | 2 | 18279630 | Under Contract | sale | Sale | /property/vic/melbourne-3000/4507-81-a-beckett-street-18279630/ | $445,000 - $475,000 | false | false | 2 | 1 | 0 | Apartment & Unit | \[1 item\] | Apartment | false | false | {11 fields} | \-37.809361 | 144.961212 | \[3 items\] | 2026-11-12 00:17:15 | 2026-11-12 00:17:23 | — | \[1 item\] | {8 fields} | | 3 | 18277759 | On Market | sale | Sale | /property/vic/melbourne-3000/1408a-8-franklin-street-18277759/ | $450,000 - $480,000 | true | false | 2 | 1 | 0 | Apartment & Unit | \[1 item\] | Apartment | false | false | {11 fields} | \-37.80742 | 144.96199 | \[3 items\] | 2026-11-11 04:20:35 | 2026-11-11 04:20:37 | 2026-11-11 04:20:35 | \[1 item\] | {8 fields} | Recorded from our API · 3 items shown · 25 datapoints per item GET /v1/realestateview/search?mode=buy&state=vic&suburb=Melbourne&postcode=3000&beds\_min=2 25 datapoints ### Identity - id integer - status string - listing\_type string - property\_type string - property\_types string\[\] - source\_property\_type string ### Contact - agents object\[\] ### Location - address object - lat number - lng number ### Reputation - images object\[\] ### Price - price\_text string - is\_price\_hidden boolean - is\_sold\_price\_hidden boolean ### Other - sale\_method string - listing\_path string - beds integer - baths integer - cars integer - is\_new\_construction boolean - is\_home\_and\_land boolean - created\_at string - updated\_at string - on\_market\_at string - agency object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/realestateview/search?mode=buy&state=vic&suburb=Melbourne&postcode=3000&beds_min=2" \ -H "X-API-Key: $API_KEY" ``` Realestateview · 7 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/realestateview/agency`](https://perceptlayer.com/apis/realestateview/agency) | `id` | 1 credit | | [GET `/v1/realestateview/agency-listings`](https://perceptlayer.com/apis/realestateview/agency-listings) | `id` +1 optional | 1 credit | | [GET `/v1/realestateview/agent`](https://perceptlayer.com/apis/realestateview/agent) | `id` | 1 credit | | [GET `/v1/realestateview/agent-listings`](https://perceptlayer.com/apis/realestateview/agent-listings) | `id` +1 optional | 1 credit | | [GET `/v1/realestateview/listing`](https://perceptlayer.com/apis/realestateview/listing) | `id` | 1 credit | | [GET `/v1/realestateview/location-autocomplete`](https://perceptlayer.com/apis/realestateview/location-autocomplete) | `q` | 1 credit | | [GET `/v1/realestateview/search`](https://perceptlayer.com/apis/realestateview/search) | `mode` `state` `suburb` `postcode` +14 optional | 1 credit | Overview ## About the Realestateview API ## What you can get The Realestateview API returns Realestateview property data as JSON through 7 endpoints. - **Search:** `search` takes a `mode` (buy, rent or sold), a `state` (act, nsw, nt, qld, sa, tas, vic or wa), a `suburb` and a `postcode`, with `property_types[]` (repeatable), `price_min`, `price_max`, `land_size_min`, `land_size_max`, `exclude_under_contract`, `beds_min`, `beds_exact`, `baths_min`, `baths_exact`, `cars_min`, `cars_exact`, `page` and `sort` (recommended, price\_asc, price\_desc, newest, recently\_updated, bedrooms\_asc or bedrooms\_desc). - **Listings:** `listing` takes an `id`. - **Agents and agencies:** `agent` and `agency` take an `id`; `agent-listings` and `agency-listings` take an `id`, with `page`. - **Locations:** `location-autocomplete` takes a `q`. The recorded `search` for homes to buy in Melbourne 3000 with `beds_min=2` returns a `total_results` of 330 and `listings`, each with `id`, `status`, `listing_type`, `sale_method`, `price_text`, `beds`, `baths`, `cars`, `property_type`, `address`, `lat`, `lng`, `images`, `on_market_at`, `agents` and `agency`. It also returns `pagination` with `per_page` (25), `total_pages` and `has_next_page`, and the `applied_filters`. ## How a call works Search a suburb: `GET /v1/realestateview/search?mode=buy&state=vic&suburb=Melbourne&postcode=3000&beds_min=2` with your key in the `X-API-Key` header. Each listing's `id` is what `listing` takes. The `id` inside its `agents` feeds `agent` and `agent-listings`, and the `id` inside its `agency` feeds `agency` and `agency-listings`. Check `has_next_page` before asking for the next `page`. Every successful call costs 1 credit; failed calls cost nothing. Real estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) Use cases ### Track asking prices and new listings in a suburb, to buy or rent `Use the Realestateview API to track asking prices and new listings in a suburb, to buy or rent` ### Pull sold listings by suburb and postcode for comparables `Use the Realestateview API to pull sold listings by suburb and postcode for comparables` ### Follow an agency's or agent's stock with \`agency-listings\` and \`agent-listings\` `` Use the Realestateview API to follow an agency's or agent's stock with `agency-listings` and `agent-listings` `` ### Compare agents by the \`sold\_listings\` and \`average\_sold\_price\` returned with each listing `` Use the Realestateview API to compare agents by the `sold_listings` and `average_sold_price` returned with each listing `` FAQ ## Questions **Do I need a Realestateview account?** No. You call this Realestateview API with your Perceptlayer key in the \`X-API-Key\` header, with no Realestateview login. **How much does the Realestateview API cost?** Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Which states does it cover?** Set \`state\` to act, nsw, nt, qld, sa, tas, vic or wa. \`search\` also needs a \`suburb\` and its \`postcode\`. **Should I build a Realestateview scraper instead?** You can, but a Realestateview scraper is code you maintain: page changes break it, requests get blocked, and Realestateview's terms govern how you collect data. The Realestateview API gives you 7 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first. ## Try the Realestateview API with 100 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)