Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Homely

1 credit per call4 endpoints31 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 keyRun 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 OKJSONX-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.

#idintegerurl_slugstringlisting_typestringproperty_typestringstatusstringtierstringis_exclusivebooleantitlestringdescriptionstringpublished_onstringlast_modifiedstringprice_textstringlisted_onstringunder_offerbooleanbedsintegerbathsintegercarsintegerensuitesintegerliving_areasintegeropen_spacesintegertoiletsintegerarea_sqmnumberis_new_constructionbooleanaddressobjectlatnumberlngnumberimagesobject[]floor_plansobject[]documentsobject[]agentsobject[]officeobject
11369399120-cotes-loop-aintree-vic-3336salehouseavailablebasicfalsePremium Display Home Investment with 8% LeasebackTruewest 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.950Z2026-11-12T12:47:00.760Z$950,000-$1,050,0002026-11-12T12:45:48.950Zfalse4241002475false{7 fields}-37.7162889144.6625658[3 items][1 item][1 item][2 items]{2 fields}
2136939904-35-north-street-midland-wa-6056salehouseavailablebasicfalseLow-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.023Z2026-11-12T12:52:01.814ZOffers Invited in High $600,0002026-11-12T12:45:48.023Zfalse3220000—false{7 fields}-31.8852984116.0070577[3 items][1 item]—[2 items]{2 fields}
3136939779-fremont-crescent-secret-harbour-wa-6173salehouseavailablebasicfalseWhy: Because premium positioning meets carefree living in this fantastic family abodeWhat: 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.723Z2026-11-12T12:33:01.014ZFrom $829,0002026-11-12T12:31:07.723Zfalse4221202539false{7 fields}-32.4104792115.764898[3 items]——[2 items]{2 fields}

Recorded from our API · 3 items shown · 31 datapoints per itemGET /v1/homely/search?mode=buy&property_types[]=house&beds_min=3&price_max=1000000&per_page=20

31 datapoints

Identity

  • idinteger
  • listing_typestring
  • property_typestring
  • statusstring
  • titlestring

Contact

  • url_slugstring
  • agentsobject[]

Location

  • living_areasinteger
  • area_sqmnumber
  • addressobject
  • latnumber
  • lngnumber

Reputation

  • imagesobject[]

Price

  • price_textstring

Other

  • tierstring
  • is_exclusiveboolean
  • descriptionstring
  • published_onstring
  • last_modifiedstring
  • listed_onstring
  • under_offerboolean
  • bedsinteger
  • bathsinteger
  • carsinteger
  • ensuitesinteger
  • open_spacesinteger
  • toiletsinteger
  • is_new_constructionboolean
  • floor_plansobject[]
  • documentsobject[]
  • officeobject

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/homely/listing
id
1 credit
GET/v1/homely/location-autocomplete
q
1 credit
GET/v1/homely/office
id
1 credit
GET/v1/homely/search
mode+13 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs