Homes.com Search API returns US homes for sale, for rent or sold as JSON. Pass a location text or a location_id from autocomplete. Filter by price, bedrooms, bathrooms, living area, year built, property type, status and open houses, sort, and page through the results. Every item has the price (with a rent range for apartments), address with coordinates, beds, baths, size, lot, year built, property type, status, photos and the listing agent. Item ids work in the listing route and agent_id works in the agent route.
Result cap. Homes.com returns at most the first 700 matches of a query. pagination.total is the full count and pagination.reachable_total is what you can page through. A page beyond that returns a 422 error and is never filled with other data. To go deeper, narrow the search with a bounding_box inside the area, or set facets=true to get listing counts per price band and split the search by price.
Rent. Apartment buildings show a rent range (rent_min to rent_max). A range can overlap the price filter band. Bathroom filters count full bathrooms: match them with baths_min and baths_max (baths adds half baths). Filters are never ignored: values that Homes.com does not honour are rejected with a 422 error. Failed requests are not billed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
21 optional filters available.
string
Optional
City, ZIP, neighborhood or address text. Send location or location_id. Example: Austin, TX.
Austin, Texas
string
Optional
Area id from the autocomplete route. Example: 2.f5xx96v6x6171.
1234567890
string
Optional
north,east,south,west inside the area. Splits a large search. Example: 30.4,-97.7,30.3,-97.8.
example
string
Optional
sale (default) or rent.
example
string
Optional
active (default) or sold. Sold needs listing_type sale.
example
boolean
Optional
true to return only homes with an open house.
true
integer
Optional
Minimum price in USD (rent: per month).
10
integer
Optional
Maximum price in USD.
10
integer
Optional
Minimum bedrooms.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum full bathrooms (a half bath does not count).
10
integer
Optional
Maximum full bathrooms (a half bath does not count).
10
integer
Optional
Minimum living area in square feet.
10
integer
Optional
Maximum living area in square feet.
10
integer
Optional
Earliest year built.
10
integer
Optional
Latest year built.
10
string
Optional
Comma separated: house, townhouse, condo, multifamily.
example
string
Optional
recommended (default), price_asc, price_desc, newest, beds_desc, sqft_desc or baths_desc. Rent: recommended or rent_asc.
relevance
integer
Optional
One-based page number. Default 1.
1
integer
Optional
Results per page, 1 to 25. Default 25.
10
boolean
Optional
true to add listing counts per price band (one more lookup).
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"items": [
{
"id": "gc95tmcstsspt",
"url": "https://www.homes.com/property/6413-jennings-dr-austin-tx/gc95tmcstsspt/",
"beds": 3,
"sqft": 1297,
"agent": {
"name": "Hiran Marin",
"phone": "(512) 413-4663",
"agency": "Monumental Realty",
"agent_id": "y9800qv",
"photo_url": null,
"agency_logo_url": null
},
"baths": 2,
"price": {
"label": "$300,000",
"value": 300000,
"currency": "USD"
},
"badges": [],
"photos": [
{
"url": "https://images.homes.com/listings/111/8452416515-295566732/6413-jennings-dr-austin-tx-primaryphoto.jpg",
"width": 1024,
"height": 768,
"caption": null
},
{
"url": "https://images.homes.com/listings/116/5552416515-295566732/6413-jennings-dr-austin-tx-buildingphoto-2.jpg?t=p",
"width": 768,
"height": 1024,
"caption": null
}
],
"status": "active",
"address": {
"city": "Austin",
"full": "6413 Jennings Dr, Austin, TX 78727",
"unit": null,
"state": "TX",
"street": "6413 Jennings Dr",
"building": null,
"coordinates": {
"latitude": 30.439204,
"longitude": -97.752399
},
"postal_code": "78727"
},
"builder": null,
"beds_max": 3,
"beds_min": 3,
"lot_sqft": null,
"rent_max": null,
"rent_min": null,
"sqft_max": 1297,
"sqft_min": 1297,
"baths_max": 2,
"baths_min": 2,
"community": null,
"list_date": "2026-10-09T00:00:00+00:00",
"lot_acres": null,
"photo_url": "https://images.homes.com/listings/111/8452416515-295566732/6413-jennings-dr-austin-tx-primaryphoto.jpg",
"sold_date": null,
"beds_label": "3 Beds",
"highlights": [],
"listing_id": "e9yrn03ft4mwl",
"year_built": 1984,
"baths_label": "2 Baths",
"description": "A great home in a wonderful area.",
"open_houses": [],
"units_count": null,
"listing_type": "sale",
"property_type": {
"code": 1,
"slug": "house",
"label": "House"
},
"days_on_market": null,
"original_price": {
"label": null,
"value": 300000,
"currency": "USD"
},
"price_per_sqft": 231,
"property_manager": null,
"available_units_count": null
}
],
"pagination": {
"page": 1,
"total": 1709,
"per_page": 25,
"total_pages": 28,
"has_next_page": true,
"reachable_total": 700
},
"location_id": "2.f5xx96v6x6171",
"applied_filters": {
"sort": "price_asc",
"min_beds": 3,
"listing_type": "sale"
}
},
"meta": {
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a range is invalid, or the page is beyond the first 700 results. This response is not billable.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Homes.com could not be reached or returned data that does not match the request. This response is not billable and is retryable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Homes.com could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.