--- title: "Homely API: JSON data, 4 endpoints, 1 credit per call" description: "Homely API for Australian property search, listings, agency offices and location autocomplete as JSON, to buy or rent. 1 credit per successful call." url: https://perceptlayer.com/apis/homely --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Homely 1 credit per call 4 endpoints 31 datapoints # Homely API Homely API for Australian property search, listings, agency offices and location autocomplete as JSON, to buy or rent. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Homely GET /v1/homely/search?mode=buy&property\_types\[\]=house&beds\_min=3&price\_max=1000000&per\_page=20 ``` { "success": true, "total_results": 55447, "total_results_is_estimate": false, "returned": 20, "filtered_out_count": 0, "pagination": { "page": 1, "per_page": 20, "total_pages": 2773, "has_next_page": true }, "applied_filters": { "mode": "buy", "property_types": [ "house" ], "beds_min": 3, "price_max": 1000000, "sort": "newest" }, "listings": [ { "id": 13693991, "url_slug": "20-cotes-loop-aintree-vic-3336", "listing_type": "sale", "property_type": "house", "status": "available", "tier": "basic", "is_exclusive": false, "title": "Premium Display Home Investment with 8% Leaseback", "description": "Truewest Real Estate is proud to present an exceptional investment opportunity with this beautifully presented Hunter 26 display home, located in the sought-after Woodlea Estate in Aintree.\n\nThoughtfully designed to combine comfort, functio…", "published_on": "2026-11-12T12:45:48.950Z", "last_modified": "2026-11-12T12:47:00.760Z", "price_text": "$950,000-$1,050,000", "listed_on": "2026-11-12T12:45:48.950Z", "under_offer": false, "beds": 4, "baths": 2, "cars": 4, "ensuites": 1, "living_areas": 0, "open_spaces": 0, "toilets": 2, "area_sqm": 475, "is_new_construction": false, "address": { "full": "20 Cotes Loop, Aintree VIC 3336", "street_number": "20", "street": "Cotes Loop", "suburb": "Aintree", "suburb_id": 6218482, "state": "VIC", "postcode": "3336" }, "lat": -37.7162889, "lng": 144.6625658, "images": [ { "identifier": "l-VaultRE-13693991-1", "version": "WbrAfB6oM1MW79A6PSI1Ch5cJnyrtAcx", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693991-1.jpg?version=WbrAfB6oM1MW79A6PSI1Ch5cJnyrtAcx" }, { "identifier": "l-VaultRE-13693991-2", "version": "FAH821Aiy8g06HUwkU.2ZO5EloCHpPoS", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693991-2.jpg?version=FAH821Aiy8g06HUwkU.2ZO5EloCHpPoS" }, { "identifier": "l-VaultRE-13693991-3", "version": "Fel5p1TFelgxbXRV566tiJDvNQ5XCze8", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693991-3.jpg?version=Fel5p1TFelgxbXRV566tiJDvNQ5XCze8" } ], "floor_plans": [ { "identifier": "fp-VaultRE-13693991-1", "version": "vPM1S1x3D_RhfGF9z93WB_8qV.ZcEZi0", "url": "https://www.homely.com.au/img-variant/fp-VaultRE-13693991-1.jpg?version=vPM1S1x3D_RhfGF9z93WB_8qV.ZcEZi0" } ], "documents": [ { "title": "Statement of Information", "url": "https://storage.homely.com.au/documents/statement-of-information-20-cotes-loop-aintree-vic-3336-id13693991" } ], "agents": [ { "id": 1210028, "name": "Chandan Dang", "email": "chandan@truewest.com.au", "mobile": "0433760072" }, { "id": 1059868, "name": "Manu Dang", "email": "manu@truewest.com.au", "mobile": "0414172072" } ], "office": { "id": 38397, "name": "Truewest Truewest" } }, { "id": 13693990, "url_slug": "4-35-north-street-midland-wa-6056", "listing_type": "sale", "property_type": "house", "status": "available", "tier": "basic", "is_exclusive": false, "title": "Low-Maintenance Living in a Convenient Location - No Strata Fees!", "description": "Imagine enjoying the comfort of your own private sanctuary, with generous outdoor space, secure surroundings and everyday conveniences just moments away - all without the burden of strata fees!\n\nWelcome to 4/35 North Street, Midland, an inv…", "published_on": "2026-11-12T12:45:48.023Z", "last_modified": "2026-11-12T12:52:01.814Z", "price_text": "Offers Invited in High $600,000", "listed_on": "2026-11-12T12:45:48.023Z", "under_offer": false, "beds": 3, "baths": 2, "cars": 2, "ensuites": 0, "living_areas": 0, "open_spaces": 0, "toilets": 0, "is_new_construction": false, "address": { "full": "4/35 North Street, Midland WA 6056", "street_number": "4/35", "street": "North Street", "suburb": "Midland", "suburb_id": 5717782, "state": "WA", "postcode": "6056" }, "lat": -31.8852984, "lng": 116.0070577, "images": [ { "identifier": "l-VaultRE-13693990-1", "version": "ng4sXK2LXXQq5seO0EkWaLl7u4..rBMn", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693990-1.jpg?version=ng4sXK2LXXQq5seO0EkWaLl7u4..rBMn" }, { "identifier": "l-VaultRE-13693990-2", "version": "fS2.PNfniY5gzEQMnfOPPrJqQ053pmam", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693990-2.jpg?version=fS2.PNfniY5gzEQMnfOPPrJqQ053pmam" }, { "identifier": "l-VaultRE-13693990-3", "version": "KxottpT6wahmkAHOqiFzToyM8tvg0mE3", "url": "https://www.homely.com.au/img-variant/l-VaultRE-13693990-3.jpg?version=KxottpT6wahmkAHOqiFzToyM8tvg0mE3" } ], "floor_plans": [ { "identifier": "fp-VaultRE-13693990-1", "version": "tw.mXTDDZIgYmyKX0MLPb6agel9Dqsys", "url": "https://www.homely.com.au/img-variant/fp-VaultRE-13693990-1.jpg?version=tw.mXTDDZIgYmyKX0MLPb6agel9Dqsys" } ], "agents": [ { "id": 893512, "name": "Jassi Malik", "email": "jassi.malik@jasandco.com.au", "mobile": "0423596948" }, { "id": 1208760, "name": "Vik Rathee", "email": "vik.rathee@jasandco.com.au", "phone": "0423596948", "mobile": "0499989054" } ], "office": { "id": 37302, "name": "Jas & Co. Property Group Jas & Co. Property Group" } }, { "id": 13693977, "url_slug": "9-fremont-crescent-secret-harbour-wa-6173", "listing_type": "sale", "property_type": "house", "status": "available", "tier": "basic", "is_exclusive": false, "title": "Why: Because premium positioning meets carefree living in this fantastic family abode", "description": "What: A 4 bedroom, 2 bathroom family home, with large living areas, a gabled roof patio, and a secure double carport with access to the backyard \nWho: Families, professionals or investors seeking a move-in ready home, with the added appeal …", "published_on": "2026-11-12T12:31:07.723Z", "last_modified": "2026-11-12T12:33:01.014Z", "price_text": "From $829,000", "listed_on": "2026-11-12T12:31:07.723Z", "under_offer": false, "beds": 4, "baths": 2, "cars": 2, "ensuites": 1, "living_areas": 2, "open_spaces": 0, "toilets": 2, "area_sqm": 539, "building_sqm": 160, "is_new_construction": false, "address": { "full": "9 Fremont Crescent, Secret Harbour WA 6173", "street_number": "9", "street": "Fremont Crescent", "suburb": "Secret Harbour", "suburb_id": 5717846, "state": "WA", "postcode": "6173" }, "lat": -32.4104792, "lng": 115.764898, "inspections": [ { "starts_on": "2026-11-14T05:00:00.000Z", "ends_on": "2026-11-14T05:30:00.000Z" } ], "images": [ { "identifier": "l-Rex-13693977-1", "version": "PiSKF_PUpf9G8qX.DaK5sYA1_YvrAkK4", "url": "https://www.homely.com.au/img-variant/l-Rex-13693977-1.jpg?version=PiSKF_PUpf9G8qX.DaK5sYA1_YvrAkK4" }, { "identifier": "l-Rex-13693977-2", "version": "m3sa8qy1.SHyxztR1pCrrhbQBgy1CHEB", "url": "https://www.homely.com.au/img-variant/l-Rex-13693977-2.jpg?version=m3sa8qy1.SHyxztR1pCrrhbQBgy1CHEB" }, { "identifier": "l-Rex-13693977-3", "version": "X9zQPTMhtaY.suXWMkm.0oDX7M0.zR4s", "url": "https://www.homely.com.au/img-variant/l-Rex-13693977-3.jpg?version=X9zQPTMhtaY.suXWMkm.0oDX7M0.zR4s" } ], "agents": [ { "id": 1152321, "name": "Nikki de Rijcke", "email": "nikki@jwresidential.com.au", "phone": "(08) 9568 0876", "mobile": "0448 651 888" }, { "id": 1263879, "name": "Mikayla Bettencourt", "email": "mikayla@jwresidential.com.au", "mobile": "0405199983" } ], "office": { "id": 38385, "name": "JW Residential JW Residential" } } ], "meta": { "endpoint_family": "search", "attempts": 1, "request_id": "req_5616c329e96e48c2a7c7c02dddffea0e", "credits_charged": 1, "credits_remaining": 1864 } } ``` 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 | url\_slug string | listing\_type string | property\_type string | status string | tier string | is\_exclusive boolean | title string | description string | published\_on string | last\_modified string | price\_text string | listed\_on string | under\_offer boolean | beds integer | baths integer | cars integer | ensuites integer | living\_areas integer | open\_spaces integer | toilets integer | area\_sqm number | is\_new\_construction boolean | address object | lat number | lng number | images object\[\] | floor\_plans object\[\] | documents object\[\] | agents object\[\] | office object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 13693991 | 20-cotes-loop-aintree-vic-3336 | sale | house | available | basic | false | Premium Display Home Investment with 8% Leaseback | Truewest Real Estate is proud to present an exceptional investment opportunity with this beautifully presented Hunter 26 display home, located in the sought-after Woodlea Estate in Aintree. Thoughtfully designed to combine comfort, functio… | 2026-11-12T12:45:48.950Z | 2026-11-12T12:47:00.760Z | $950,000-$1,050,000 | 2026-11-12T12:45:48.950Z | false | 4 | 2 | 4 | 1 | 0 | 0 | 2 | 475 | false | {7 fields} | \-37.7162889 | 144.6625658 | \[3 items\] | \[1 item\] | \[1 item\] | \[2 items\] | {2 fields} | | 2 | 13693990 | 4-35-north-street-midland-wa-6056 | sale | house | available | basic | false | Low-Maintenance Living in a Convenient Location - No Strata Fees! | Imagine enjoying the comfort of your own private sanctuary, with generous outdoor space, secure surroundings and everyday conveniences just moments away - all without the burden of strata fees! Welcome to 4/35 North Street, Midland, an inv… | 2026-11-12T12:45:48.023Z | 2026-11-12T12:52:01.814Z | Offers Invited in High $600,000 | 2026-11-12T12:45:48.023Z | false | 3 | 2 | 2 | 0 | 0 | 0 | 0 | — | false | {7 fields} | \-31.8852984 | 116.0070577 | \[3 items\] | \[1 item\] | — | \[2 items\] | {2 fields} | | 3 | 13693977 | 9-fremont-crescent-secret-harbour-wa-6173 | sale | house | available | basic | false | Why: Because premium positioning meets carefree living in this fantastic family abode | What: A 4 bedroom, 2 bathroom family home, with large living areas, a gabled roof patio, and a secure double carport with access to the backyard Who: Families, professionals or investors seeking a move-in ready home, with the added appeal … | 2026-11-12T12:31:07.723Z | 2026-11-12T12:33:01.014Z | From $829,000 | 2026-11-12T12:31:07.723Z | false | 4 | 2 | 2 | 1 | 2 | 0 | 2 | 539 | false | {7 fields} | \-32.4104792 | 115.764898 | \[3 items\] | — | — | \[2 items\] | {2 fields} | Recorded from our API · 3 items shown · 31 datapoints per item GET /v1/homely/search?mode=buy&property\_types\[\]=house&beds\_min=3&price\_max=1000000&per\_page=20 31 datapoints ### Identity - id integer - listing\_type string - property\_type string - status string - title string ### Contact - url\_slug string - agents object\[\] ### Location - living\_areas integer - area\_sqm number - address object - lat number - lng number ### Reputation - images object\[\] ### Price - price\_text string ### Other - tier string - is\_exclusive boolean - description string - published\_on string - last\_modified string - listed\_on string - under\_offer boolean - beds integer - baths integer - cars integer - ensuites integer - open\_spaces integer - toilets integer - is\_new\_construction boolean - floor\_plans object\[\] - documents object\[\] - office object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/homely/search?mode=buy&property_types[]=house&beds_min=3&price_max=1000000&per_page=20" \ -H "X-API-Key: $API_KEY" ``` Homely · 4 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/homely/listing`](https://perceptlayer.com/apis/homely/listing) | `id` | 1 credit | | [GET `/v1/homely/location-autocomplete`](https://perceptlayer.com/apis/homely/location-autocomplete) | `q` | 1 credit | | [GET `/v1/homely/office`](https://perceptlayer.com/apis/homely/office) | `id` | 1 credit | | [GET `/v1/homely/search`](https://perceptlayer.com/apis/homely/search) | `mode` +13 optional | 1 credit | Overview ## About the Homely API ## What you can get The Homely API returns Australian property data from Homely as JSON through 4 endpoints. - **Search:** `search` takes a `mode` (buy or rent), with `location`, `postcode`, a repeatable `property_types[]` (house, unit, apartment, townhouse, villa, acreage, retirement, studio or other), `beds_min`, `baths_min`, `cars_min`, `price_min`, `price_max`, `land_size_min`, `land_size_max`, `sort` (newest, oldest or expensive), `page` and `per_page`. - **Listings:** `listing` takes an `id`. - **Offices:** `office` takes an `id`. - **Locations:** `location-autocomplete` takes a `q`. The recorded `search` for houses to buy with at least 3 bedrooms up to 1,000,000 returns `listings`, each with `id`, `url_slug`, `listing_type`, `property_type`, `status`, `title`, `description`, `price_text`, `listed_on`, `under_offer`, `beds`, `baths`, `cars`, `ensuites`, `toilets`, `area_sqm`, `address` (with `suburb`, `state` and `postcode`), `lat`, `lng`, `images`, `floor_plans`, `documents`, `agents` and `office`. It also returns `total_results` (55,447, with `total_results_is_estimate` false), `returned`, `pagination` with `total_pages` and `has_next_page`, and `applied_filters`. ## How a call works Search for houses: `GET /v1/homely/search?mode=buy&property_types[]=house&beds_min=3&price_max=1000000&per_page=20` with your key in the `X-API-Key` header. Each listing's `id` goes to `listing`, and its `office` carries the `id` that `office` takes. Page with `page` while `has_next_page` is true. 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 by suburb or postcode `Use the Homely API to track asking prices and new listings by suburb or postcode` ### Watch homes going under offer with \`under\_offer\` `` Use the Homely API to watch homes going under offer with `under_offer` `` ### Compare rentals and sales in the same area with \`mode\` `` Use the Homely API to compare rentals and sales in the same area with `mode` `` ### Pull floor plans and documents for a set of listings `Use the Homely API to pull floor plans and documents for a set of listings` FAQ ## Questions **Do I need a Homely account?** No. You call this Homely API with your Perceptlayer key in the \`X-API-Key\` header, with no Homely login. **How much does the Homely 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. **Can I search by postcode?** Yes. Pass \`postcode\` to \`search\`, or a place name as \`location\`. \`location-autocomplete\` takes a partial name in \`q\`, such as bondi. **Should I build a Homely scraper instead?** You can, but a Homely scraper is code you maintain: page changes break it, requests get blocked, and Homely's terms govern how you collect data. The Homely API gives you 4 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 Homely 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)