Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Homes.com

1 credit per call7 endpoints29 datapoints

Homes.com API

Homes.com API for US home search, listings, agents, neighborhoods, schools and place autocomplete as JSON, for sale or rent. 1 credit per successful call.

Get a free API keyRun it below
Homes.com
GET/v1/homes-com/search?location=Austin%2C+TX&listing_type=sale&min_beds=3&sort=price_asc
{
  "success": true,
  "data": {
    "location_id": "2.f5xx96v6x6171",
    "applied_filters": {
      "listing_type": "sale",
      "sort": "price_asc",
      "min_beds": "3"
    },
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total": 4617,
      "reachable_total": 700,
      "total_pages": 28,
      "has_next_page": true
    },
    "items": [
      {
        "id": "mddcspkby1g47",
        "listing_id": "nj97f2thtpkfq",
        "url": "https://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-11-5/mddcspkby1g47/",
        "listing_type": "sale",
        "status": "active",
        "price": {
          "value": 32000,
          "currency": "USD",
          "label": "$32,000"
        },
        "original_price": {
          "value": 32000,
          "currency": "USD"
        },
        "address": {
          "street": "8212 Barton Club Dr",
          "unit": "Unit 11-5",
          "city": "Austin",
          "state": "TX",
          "postal_code": "78735",
          "full": "8212 Barton Club Dr Unit 11-5, Austin, TX 78735",
          "coordinates": {
            "latitude": 30.29249,
            "longitude": -97.85977
          }
        },
        "beds": 3,
        "beds_min": 3,
        "beds_max": 3,
        "beds_label": "3 Beds",
        "baths": 3.5,
        "baths_min": 3,
        "baths_max": 3,
        "baths_label": "3.5 Baths",
        "sqft": 2660,
        "sqft_min": 2660,
        "sqft_max": 2660,
        "lot_acres": 0.25,
        "lot_sqft": 10890,
        "year_built": 2001,
        "price_per_sqft": 12,
        "property_type": {
          "code": 1,
          "slug": "house",
          "label": "House"
        },
        "list_date": "2026-01-23T00:00:00+00:00",
        "description": "TIMESHARE!! FRACTIONAL OWNERSHIP! Please make sure you and your buyer understand this before inquiring further! Please see attachments that explain fees, dues and how the reservations process works. Wonderful getaway for 27 days a year at t…",
        "photo_url": "https://images.homes.com/listings/111/9890504574-604919412/8212-barton-club-dr-austin-tx-primaryphoto.jpg",
        "photos": [
          {
            "url": "https://images.homes.com/listings/111/9890504574-604919412/8212-barton-club-dr-austin-tx-primaryphoto.jpg",
            "width": 2048,
            "height": 1536
          },
          {
            "url": "https://images.homes.com/listings/111/7990504574-604919412/8212-barton-club-dr-austin-tx-buildingphoto-2.jpg",
            "width": 2048,
            "height": 1536
          },
          {
            "url": "https://images.homes.com/listings/111/1001504574-604919412/8212-barton-club-dr-austin-tx-buildingphoto-3.jpg",
            "width": 2048,
            "height": 1536
          }
        ],
        "agent": {
          "agent_id": "vqxrvte",
          "name": "Jason Long",
          "agency": "Sky Realty",
          "phone": "(512) 750-6914",
          "photo_url": "https://imagescdn.homes.com/i2/46g_xjAuvAqotwKCmjqvPzVPSfLr3xRhA6oQATYz_Xw/105/image.jpg?t=p&p=1",
          "agency_logo_url": "https://imagescdn.homes.com/i2/vcgWxWjqSqIJJzuE868tmDm3Q4Tz-I6xQLs5M1H4KhU/105/image.png?t=p&p=1"
        }
      },
      {
        "id": "bfnfnntc5nyx7",
        "listing_id": "qpg5fw2gy47tk",
        "url": "https://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-9-10/bfnfnntc5nyx7/",
        "listing_type": "sale",
        "status": "active",
        "price": {
          "value": 32000,
          "currency": "USD",
          "label": "$32,000"
        },
        "original_price": {
          "value": 32000,
          "currency": "USD"
        },
        "address": {
          "street": "8212 Barton Club Dr",
          "unit": "Unit 9-10",
          "city": "Austin",
          "state": "TX",
          "postal_code": "78735",
          "full": "8212 Barton Club Dr Unit 9-10, Austin, TX 78735",
          "coordinates": {
            "latitude": 30.29249,
            "longitude": -97.85977
          }
        },
        "beds": 3,
        "beds_min": 3,
        "beds_max": 3,
        "beds_label": "3 Beds",
        "baths": 3.5,
        "baths_min": 3,
        "baths_max": 3,
        "baths_label": "3.5 Baths",
        "sqft": 2660,
        "sqft_min": 2660,
        "sqft_max": 2660,
        "lot_acres": 0.25,
        "lot_sqft": 10890,
        "year_built": 2001,
        "price_per_sqft": 12,
        "property_type": {
          "code": 1,
          "slug": "house",
          "label": "House"
        },
        "list_date": "2026-01-22T00:00:00+00:00",
        "description": "TIMESHARE!! FRACTIONAL OWNERSHIP! Please make sure you and your buyer understand this before inquiring further! Please see attachments that explain fees, dues and how the reservations process works. Wonderful getaway for 27 days a year at t…",
        "photo_url": "https://images.homes.com/listings/111/5490172574-125438412/8212-barton-club-dr-austin-tx-primaryphoto.jpg",
        "photos": [
          {
            "url": "https://images.homes.com/listings/111/5490172574-125438412/8212-barton-club-dr-austin-tx-primaryphoto.jpg",
            "width": 2048,
            "height": 1536
          },
          {
            "url": "https://images.homes.com/listings/111/9490172574-125438412/8212-barton-club-dr-austin-tx-buildingphoto-2.jpg",
            "width": 2048,
            "height": 1536
          },
          {
            "url": "https://images.homes.com/listings/111/5590172574-125438412/8212-barton-club-dr-austin-tx-buildingphoto-3.jpg",
            "width": 2048,
            "height": 1536
          }
        ],
        "agent": {
          "agent_id": "vqxrvte",
          "name": "Jason Long",
          "agency": "Sky Realty",
          "phone": "(512) 750-6914",
          "photo_url": "https://imagescdn.homes.com/i2/46g_xjAuvAqotwKCmjqvPzVPSfLr3xRhA6oQATYz_Xw/105/image.jpg?t=p&p=1",
          "agency_logo_url": "https://imagescdn.homes.com/i2/vcgWxWjqSqIJJzuE868tmDm3Q4Tz-I6xQLs5M1H4KhU/105/image.png?t=p&p=1"
        }
      },
      {
        "id": "eqyznd4p98c6k",
        "listing_id": "8h76sqvhccnt4",
        "url": "https://www.homes.com/property/11024-lambert-ln-austin-tx/eqyznd4p98c6k/",
        "listing_type": "sale",
        "status": "active",
        "badges": [
          "$2K PRICE DROP"
        ],
        "price": {
          "value": 33000,
          "currency": "USD",
          "label": "$33,000"
        },
        "original_price": {
          "value": 35000,
          "currency": "USD"
        },
        "address": {
          "street": "11024 Lambert Ln",
          "city": "Austin",
          "state": "TX",
          "postal_code": "78719",
          "full": "11024 Lambert Ln, Austin, TX 78719",
          "coordinates": {
            "latitude": 30.116422,
            "longitude": -97.683006
          }
        },
        "beds": 3,
        "beds_min": 3,
        "beds_max": 3,
        "beds_label": "3 Beds",
        "baths": 2,
        "baths_min": 2,
        "baths_max": 2,
        "baths_label": "2 Baths",
        "sqft": 1414,
        "sqft_min": 1414,
        "sqft_max": 1414,
        "year_built": 1992,
        "price_per_sqft": 23,
        "property_type": {
          "code": 64,
          "label": "Manufactured"
        },
        "list_date": "2026-09-28T04:00:00+00:00",
        "description": "(MANUFACTURED HOME THAT IS READY TO BE MOVED TO BUYER'S LAND) 1992 PALM HARBOR DOUBLEWIDE - NEWER ROOF, UPDATED HVAC, VAULTED CEILINGS & GARDEN TUB__________11024 LAMBERT LANE, AUSTIN, TX 78719 | 3 BED 2 BATH | 1,414 SQFT.**********This 199…",
        "photo_url": "https://images.homes.com/listings/116/1142050415-409801732/11024-lambert-ln-austin-tx-primaryphoto.jpg?t=p",
        "photos": [
          {
            "url": "https://images.homes.com/listings/116/1142050415-409801732/11024-lambert-ln-austin-tx-primaryphoto.jpg?t=p",
            "width": 1024,
            "height": 1536
          },
          {
            "url": "https://images.homes.com/listings/116/8142050415-409801732/11024-lambert-ln-austin-tx-buildingphoto-2.jpg?t=p",
            "width": 1200,
            "height": 1600
          },
          {
            "url": "https://images.homes.com/listings/116/1242050415-409801732/11024-lambert-ln-austin-tx-buildingphoto-3.jpg?t=p",
            "width": 1200,
            "height": 1600
          }
        ],
        "agent": {
          "agent_id": "he96qg2",
          "name": "Ivan Mills",
          "agency": "Mobile Bye Bye",
          "phone": "(512) 643-7225",
          "photo_url": "https://imagescdn.homes.com/i2/y2wcZ6qdeAi-RPUkpMY4nKei8KhN8FfamxTTuA9hJMM/105/image.jpg?t=p&p=1"
        }
      }
    ]
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_d951f3772b5a4a89a1c223f7290535a9",
    "credits_charged": 1,
    "credits_remaining": 1862
  }
}
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.

#idstringlisting_idstringurlurllisting_typestringstatusstringpriceobjectoriginal_priceobjectaddressobjectbedsintegerbeds_minintegerbeds_maxintegerbeds_labelstringbathsnumberbaths_minintegerbaths_maxintegerbaths_labelstringsqftintegersqft_minintegersqft_maxintegerlot_acresnumberlot_sqftnumberyear_builtintegerprice_per_sqftintegerproperty_typeobjectlist_datestringdescriptionstringphoto_urlurlphotosobject[]agentobject
1mddcspkby1g47nj97f2thtpkfqhttps://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-11-5/mddcspkby1g47/saleactive{3 fields}{2 fields}{7 fields}3333 Beds3.5333.5 Baths2660266026600.2510890200112{3 fields}2026-01-23T00:00:00+00:00TIMESHARE!! FRACTIONAL OWNERSHIP! Please make sure you and your buyer understand this before inquiring further! Please see attachments that explain fees, dues and how the reservations process works. Wonderful getaway for 27 days a year at t…https://images.homes.com/listings/111/9890504574-604919412/8212-barton-club-dr-austin-tx-primaryphoto.jpg[3 items]{6 fields}
2bfnfnntc5nyx7qpg5fw2gy47tkhttps://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-9-10/bfnfnntc5nyx7/saleactive{3 fields}{2 fields}{7 fields}3333 Beds3.5333.5 Baths2660266026600.2510890200112{3 fields}2026-01-22T00:00:00+00:00TIMESHARE!! FRACTIONAL OWNERSHIP! Please make sure you and your buyer understand this before inquiring further! Please see attachments that explain fees, dues and how the reservations process works. Wonderful getaway for 27 days a year at t…https://images.homes.com/listings/111/5490172574-125438412/8212-barton-club-dr-austin-tx-primaryphoto.jpg[3 items]{6 fields}
3eqyznd4p98c6k8h76sqvhccnt4https://www.homes.com/property/11024-lambert-ln-austin-tx/eqyznd4p98c6k/saleactive{3 fields}{2 fields}{6 fields}3333 Beds2222 Baths141414141414——199223{2 fields}2026-09-28T04:00:00+00:00(MANUFACTURED HOME THAT IS READY TO BE MOVED TO BUYER'S LAND) 1992 PALM HARBOR DOUBLEWIDE - NEWER ROOF, UPDATED HVAC, VAULTED CEILINGS & GARDEN TUB__________11024 LAMBERT LANE, AUSTIN, TX 78719 | 3 BED 2 BATH | 1,414 SQFT.**********This 199…https://images.homes.com/listings/116/1142050415-409801732/11024-lambert-ln-austin-tx-primaryphoto.jpg?t=p[3 items]{5 fields}

Recorded from our API · 3 items shown · 29 datapoints per itemGET /v1/homes-com/search?location=Austin%2C+TX&listing_type=sale&min_beds=3&sort=price_asc

29 datapoints

Identity

  • idstring
  • listing_idstring
  • listing_typestring
  • statusstring
  • property_typeobject

Contact

  • urlurl
  • photo_urlurl
  • agentobject

Location

  • addressobject

Reputation

  • photosobject[]

Price

  • priceobject
  • original_priceobject
  • price_per_sqftinteger

Other

  • bedsinteger
  • beds_mininteger
  • beds_maxinteger
  • beds_labelstring
  • bathsnumber
  • baths_mininteger
  • baths_maxinteger
  • baths_labelstring
  • sqftinteger
  • sqft_mininteger
  • sqft_maxinteger
  • lot_acresnumber
  • lot_sqftnumber
  • year_builtinteger
  • list_datestring
  • descriptionstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/homes-com/search?location=Austin%2C+TX&listing_type=sale&min_beds=3&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

Homes.com · 7 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/homes-com/agent
id
1 credit
GET/v1/homes-com/agent-autocomplete
query+1 optional
1 credit
GET/v1/homes-com/autocomplete
query+3 optional
1 credit
GET/v1/homes-com/listing
none+2 optional
1 credit
GET/v1/homes-com/neighborhood
id
1 credit
GET/v1/homes-com/school
id
1 credit
GET/v1/homes-com/search
none+21 optional
1 credit

Overview

What you can get

The Homes.com API returns US property data from Homes.com as JSON through 7 endpoints.

  • Search: search takes a location, location_id or bounding_box, with listing_type (sale or rent), status (active or sold), open_houses, min_price, max_price, min_beds, max_beds, min_baths, max_baths, min_sqft, max_sqft, min_year_built, max_year_built, a repeatable property_type[] (house, townhouse, condo or multifamily), sort (recommended, price_asc, price_desc, newest, beds_desc, sqft_desc, baths_desc or rent_asc), page, per_page and facets.
  • Listings: listing takes an id or a url.
  • Agents: agent takes an id; agent-autocomplete takes a query, with limit.
  • Places: neighborhood and school take an id; autocomplete takes a query, with limit, type (place, neighborhood, school, building, community or address) and listing_type.

The recorded search for homes for sale in Austin, TX with at least 3 beds, cheapest first, returns data.items, each with id, listing_id, url, listing_type, status, price, original_price, address, beds, baths, sqft, lot_acres, lot_sqft, year_built, price_per_sqft, property_type, list_date, description, photos and agent. It also returns the resolved location_id, applied_filters, and pagination with total (4,617), reachable_total (700), total_pages and has_next_page.

How a call works

Search a city: GET /v1/homes-com/search?location=Austin, TX&listing_type=sale&min_beds=3&sort=price_asc with your key in the X-API-Key header. Each item's id goes to listing, and its agent carries the agent_id that agent takes as id. Reuse the returned location_id to page the same area with page. 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 price cuts against `original_price` in a US city

Use the Homes.com API to track asking prices and price cuts against `original_price` in a US city

Pull sold homes for comparables with `status=sold`

Use the Homes.com API to pull sold homes for comparables with `status=sold`

Compare `price_per_sqft` across neighborhoods

Use the Homes.com API to compare `price_per_sqft` across neighborhoods

Find open houses with `open_houses`

Use the Homes.com API to find open houses with `open_houses`

FAQ

Questions

Do I need a Homes.com account?

No. You call this Homes.com API with your Perceptlayer key in the `X-API-Key` header, with no Homes.com login.

How much does the Homes.com 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.

How many results can one search return?

The recorded Austin search reports a `total` of 4,617 and a `reachable_total` of 700. Narrow the price, beds or area, or use `bounding_box`, to reach the rest.

Should I build a Homes.com scraper instead?

You can, but a Homes.com scraper is code you maintain: page changes break it, requests get blocked, and Homes.com's terms govern how you collect data. The Homes.com 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 Homes.com API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs