APIs / Homely / Search

Homely: Search

Search from Homely as JSON. 1 credit per successful call.

GET /v1/homely/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
modestringRequiredbuy, rent
locationstringOptionalUp to 80 characters
postcodestringOptionalAny
property_types[]list of stringOptionalhouse, unit, apartment, townhouse, villa, acreage, retirement, studio, other
beds_minintegerOptionalAny
baths_minintegerOptionalAny
cars_minintegerOptionalAny
price_minintegerOptionalAny
price_maxintegerOptionalAny
land_size_minintegerOptionalAny
land_size_maxintegerOptionalAny
sortstringOptionalnewest, oldest, expensive
pageintegerOptionalAny
per_pageintegerOptionalAny

Example request

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.

Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.