--- title: "Homes.com API: JSON data, 7 endpoints, 1 credit per call" description: "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." url: https://perceptlayer.com/apis/homes-com --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Homes.com 1 credit per call 7 endpoints 29 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 key](https://perceptlayer.com/signup) Run 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 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 string | listing\_id string | url url | listing\_type string | status string | price object | original\_price object | address object | beds integer | beds\_min integer | beds\_max integer | beds\_label string | baths number | baths\_min integer | baths\_max integer | baths\_label string | sqft integer | sqft\_min integer | sqft\_max integer | lot\_acres number | lot\_sqft number | year\_built integer | price\_per\_sqft integer | property\_type object | list\_date string | description string | photo\_url url | photos object\[\] | agent object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | mddcspkby1g47 | nj97f2thtpkfq | https://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-11-5/mddcspkby1g47/ | sale | active | {3 fields} | {2 fields} | {7 fields} | 3 | 3 | 3 | 3 Beds | 3.5 | 3 | 3 | 3.5 Baths | 2660 | 2660 | 2660 | 0.25 | 10890 | 2001 | 12 | {3 fields} | 2026-01-23T00:00:00+00:00 | 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… | https://images.homes.com/listings/111/9890504574-604919412/8212-barton-club-dr-austin-tx-primaryphoto.jpg | \[3 items\] | {6 fields} | | 2 | bfnfnntc5nyx7 | qpg5fw2gy47tk | https://www.homes.com/property/8212-barton-club-dr-austin-tx-unit-9-10/bfnfnntc5nyx7/ | sale | active | {3 fields} | {2 fields} | {7 fields} | 3 | 3 | 3 | 3 Beds | 3.5 | 3 | 3 | 3.5 Baths | 2660 | 2660 | 2660 | 0.25 | 10890 | 2001 | 12 | {3 fields} | 2026-01-22T00:00:00+00:00 | 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… | https://images.homes.com/listings/111/5490172574-125438412/8212-barton-club-dr-austin-tx-primaryphoto.jpg | \[3 items\] | {6 fields} | | 3 | eqyznd4p98c6k | 8h76sqvhccnt4 | https://www.homes.com/property/11024-lambert-ln-austin-tx/eqyznd4p98c6k/ | sale | active | {3 fields} | {2 fields} | {6 fields} | 3 | 3 | 3 | 3 Beds | 2 | 2 | 2 | 2 Baths | 1414 | 1414 | 1414 | — | — | 1992 | 23 | {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 item GET /v1/homes-com/search?location=Austin%2C+TX&listing\_type=sale&min\_beds=3&sort=price\_asc 29 datapoints ### Identity - id string - listing\_id string - listing\_type string - status string - property\_type object ### Contact - url url - photo\_url url - agent object ### Location - address object ### Reputation - photos object\[\] ### Price - price object - original\_price object - price\_per\_sqft integer ### Other - beds integer - beds\_min integer - beds\_max integer - beds\_label string - baths number - baths\_min integer - baths\_max integer - baths\_label string - sqft integer - sqft\_min integer - sqft\_max integer - lot\_acres number - lot\_sqft number - year\_built integer - list\_date string - description string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/homes-com/agent`](https://perceptlayer.com/apis/homes-com/agent) | `id` | 1 credit | | [GET `/v1/homes-com/agent-autocomplete`](https://perceptlayer.com/apis/homes-com/agent-autocomplete) | `query` +1 optional | 1 credit | | [GET `/v1/homes-com/autocomplete`](https://perceptlayer.com/apis/homes-com/autocomplete) | `query` +3 optional | 1 credit | | [GET `/v1/homes-com/listing`](https://perceptlayer.com/apis/homes-com/listing) | none +2 optional | 1 credit | | [GET `/v1/homes-com/neighborhood`](https://perceptlayer.com/apis/homes-com/neighborhood) | `id` | 1 credit | | [GET `/v1/homes-com/school`](https://perceptlayer.com/apis/homes-com/school) | `id` | 1 credit | | [GET `/v1/homes-com/search`](https://perceptlayer.com/apis/homes-com/search) | none +21 optional | 1 credit | Overview ## About the Homes.com API ## 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 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 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)