Homes.com Listing API returns the full record of one listing. Pass the property id from search or autocomplete, or the full homes.com listing URL. The record has the price and estimated payment, address with coordinates, beds, baths, size, lot, year built, description, key facts, feature groups, photos, price history, tax history, deeds, assigned schools with ratings, walk, transit, bike and sound scores, parks, transit stops, neighborhood facts, the listing agents, the home estimate (sold and off-market homes), mortgage rates, listing views and nearby listings. The MLS source and disclaimer are part of the data and are always returned. Sections Homes.com does not have for a listing come back as null or an empty list. An unknown listing returns 404 and is not billed.
Run this endpoint
Homes.com Listing API Documentation
1 credit/request
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.
2 optional filters available.
id
string
Optional
Property id from search, autocomplete or a listing URL. Use either id or url. Example: gc95tmcstsspt.
Example value
1234567890
url
string
Optional
Full homes.com listing URL. Use either id or url.
Example value
https://example.com/product
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"id": "gc95tmcstsspt",
"mls": {
"source": "Unlock MLS (Austin Board of REALTORS\u00ae)",
"logo_url": "https://images.homes.com/brands/104/1743_aspect.png",
"disclaimer": "Based on information from the Austin Board of REALTORS\u00ae (alternatively, from ACTRIS). Neither the Board nor ACTRIS guarantees or is in any way responsible for its accuracy. All ...",
"listing_number": "ACT6976892"
},
"url": "https://www.homes.com/property/6413-jennings-dr-austin-tx/gc95tmcstsspt/",
"beds": 3,
"sqft": 1297,
"agent": {
"name": "Hiran Marin",
"role": "Listing Agent",
"phone": "(512) 413-4663",
"agency": "Monumental Realty",
"agent_id": "y9800qv",
"photo_url": null,
"profile_url": "https://www.homes.com/real-estate-agents/hiran-marin/y9800qv/",
"agency_phone": "(512) 459-9600",
"license_number": "0482555"
},
"baths": 2,
"deeds": [
{
"date": "12/11/15",
"type": "Deed",
"buyers": [
"Dashevski Vladislav"
],
"sellers": [
"Dashevskay Sonnet"
],
"sale_price": null,
"title_company": "None Available"
},
{
"date": "09/10/97",
"type": "Warranty Deed",
"buyers": [
"Dashevski Vladislav I",
"Dashevski Sonnet"
],
"sellers": [
"Johnson Sandra M"
],
"sale_price": null,
"title_company": "Longhorn Title Co Inc"
}
],
"parks": [
{
"name": "Yett Creek Neighborhood Park",
"photos": [
"https://imagescdn.homes.com/i2/KFgcmfnPpBRDhh6Jxnsu7GeUtb7_MrDwf_dw_RO3AYk/111/yett-creek-neighborhood-park-austin-tx.jpg?p=1",
"https://imagescdn.homes.com/i2/34aZOd81M5Fs5HnqrjB93vEZkNMjroh-P0nlB7XSYW0/111/image.jpg?p=1"
],
"seconds": 220,
"distance": "3 min drive",
"amenities": [
"Bike Trails",
"Trails"
],
"coordinates": {
"latitude": 30.4304916,
"longitude": -97.7352832
}
},
{
"name": "Rattan Creek Park",
"photos": [
"https://imagescdn.homes.com/i2/3B2vX2Zn7w0DvpgAogOMPT4xtxMulNFUy1f6w26Tq-s/111/rattan-creek-park-austin-tx.jpg?p=1",
"https://imagescdn.homes.com/i2/0myvZ_h4e3jDAkBKxm6TS3DGBtcxXiy3_O2sK-U4_oc/111/image.jpg?p=1"
],
"seconds": 280,
"distance": "4 min drive",
"amenities": [
"Basketball",
"Pool"
],
"coordinates": {
"latitude": 30.44921,
"longitude": -97.754693
}
}
],
"price": {
"label": "$300,000",
"value": 300000,
"currency": "USD"
},
"agents": [
{
"name": "Hiran Marin",
"role": "Listing Agent",
"phone": "(512) 413-4663",
"agency": "Monumental Realty",
"agent_id": "y9800qv",
"photo_url": null,
"profile_url": "https://www.homes.com/real-estate-agents/hiran-marin/y9800qv/",
"agency_phone": "(512) 459-9600",
"license_number": "0482555"
}
],
"photos": [
{
"url": "https://images.homes.com/listings/111/8452416515-295566732-original.jpg",
"width": 1024,
"height": 768,
"caption": "Front exterior featuring light blue vinyl siding, stone veneer accents, and two-car garage."
},
{
"url": "https://images.homes.com/listings/116/5552416515-295566732-original.jpg?t=p",
"width": 768,
"height": 1024,
"caption": "Living room featuring vaulted ceiling, built-in shelving, and reddish-brown wood flooring."
}
],
"scores": {
"bike": {
"label": "Fairly bikeable",
"score": 50
},
"walk": {
"label": "Fairly walkable",
"score": 50
},
"sound": {
"label": "Active",
"score": 78
},
"environmental": [
{
"type": 1,
"label": "Active",
"score": 78
},
{
"type": 2,
"label": "Minimal",
"score": 1
}
]
},
"status": "active",
"address": {
"city": "Austin",
"unit": null,
"state": "TX",
"county": "Travis County",
"street": "6413 Jennings Dr",
"coordinates": {
"latitude": 30.43923,
"longitude": -97.75241
},
"postal_code": "78727"
},
"schools": [
{
"url": "https://www.homes.com/school/austin-tx/jollyville-elementary-school/tvy63b8lylm0g/",
"city": "Austin",
"name": "Jollyville Elementary School",
"type": "Public",
"state": "TX",
"grades": "PK to 5th",
"rating": 8,
"distance": "8 min walk",
"photo_url": "https://imagescdn.homes.com/i2/QZxFLdnjcMMC7nfa_QJhbJ9F5zdR3TycAsrmqPxbO-Y/111/jollyville-elementary-school-austin-tx-schoolphoto.jpg?p=1",
"school_id": "tvy63b8lylm0g",
"niche_grade": "A-",
"in_attendance_zone": true
},
{
"url": "https://www.homes.com/school/austin-tx/canyon-vista-middle-school/3qlsk78jx310k/",
"city": "Austin",
"name": "Canyon Vista Middle",
"type": "Public",
"state": "TX",
"grades": "6th to 8th",
"rating": 10,
"distance": "4 min drive",
"photo_url": "https://imagescdn.homes.com/i2/wRv6j9mje5CdUf9L5stoKFiXxqQuc2HAGfB6a0n90-4/111/canyon-vista-middle-austin-tx-schoolphoto.jpg?p=1",
"school_id": "3qlsk78jx310k",
"niche_grade": "A",
"in_attendance_zone": true
}
],
"building": null,
"features": [
{
"group": "Listing Details",
"items": [
{
"name": "Property Type",
"value": "Residential"
},
{
"name": "Property Sub Type",
"value": "Single Family Residence"
}
]
},
{
"group": "Interior Features",
"items": [
{
"name": "Interior Amenities",
"value": "Ceiling-Vaulted"
},
{
"name": "View",
"value": "None"
}
]
}
],
"lot_size": {
"text": "0",
"unit": "Sq Ft Lot",
"acres": 0
},
"mortgage": {
"loan_amount": 240000,
"down_payment": 60000,
"interest_rates": [
{
"rate": 0.0732,
"label": "30-Year Fixed",
"years": 30
},
{
"rate": 0.0668,
"label": "15-Year Fixed",
"years": 15
}
]
},
"community": null,
"key_facts": [
{
"name": "Home Type",
"value": "Single Family"
},
{
"name": "Year Built",
"value": "Built in 1984"
}
],
"list_date": "2026-10-09T00:00:00+00:00",
"plan_name": null,
"transport": [
{
"type": "Bus",
"stops": [
{
"name": "12550 Research & Oak Knoll",
"photos": [],
"seconds": 1165,
"distance": "19 min walk",
"amenities": [],
"coordinates": {
"latitude": 30.43024,
"longitude": -97.76044
}
},
{
"name": "12550 Research/Oak Knoll",
"photos": [],
"seconds": 1165,
"distance": "19 min walk",
"amenities": [],
"coordinates": {
"latitude": 30.43024,
"longitude": -97.76044
}
}
]
},
{
"type": "Airport",
"stops": [
{
"name": "Austin-Bergstrom International",
"photos": [
"https://imagescdn.homes.com/i2/pviErNx0nh-xzF_nriIds8wnnUH11pI8NHGysiFEqV4/104/image.png?p=1"
],
"seconds": 2213,
"distance": "36 min drive",
"amenities": [],
"coordinates": {
"latitude": 30.1945324,
"longitude": -97.6698685
}
}
]
}
],
"highlights": [
"Jollyville Elementary School Rated A-",
"Wooded Lot"
],
"listing_id": "e9yrn03ft4mwl",
"year_built": 1984,
"breadcrumbs": [
{
"url": "https://www.homes.com/texas/",
"text": "Texas"
},
{
"url": "https://www.homes.com/travis-county-tx/",
"text": "Travis County"
}
],
"description": "A great home in a wonderful area.",
"performance": {
"views": 1871,
"shares": 1,
"favorites": 1
},
"tax_history": [
{
"tax": {
"label": "$7,292",
"value": 7292,
"currency": "USD"
},
"land": {
"label": "$128,799",
"value": 128799,
"currency": "USD"
},
"year": 2025,
"assessment": {
"label": "$361,983",
"value": 361983,
"currency": "USD"
},
"improvements": {
"label": "$233,184",
"value": 233184,
"currency": "USD"
}
},
{
"tax": {
"label": "$5,673",
"value": 5673,
"currency": "USD"
},
"land": null,
"year": 2023,
"assessment": {
"label": "$343,628",
"value": 343628,
"currency": "USD"
},
"improvements": null
}
],
"last_updated": "October 9, 2026",
"listing_type": "sale",
"neighborhood": {
"url": "https://www.homes.com/austin-tx/milwood-neighborhood/",
"city": "Austin",
"name": "Milwood"
},
"status_label": "Unknown",
"videos_count": 0,
"garage_spaces": 2,
"home_estimate": {
"low": 368000,
"date": null,
"high": 395000,
"value": {
"label": null,
"value": 378960,
"currency": "USD"
}
},
"parcel_number": "173973",
"price_history": [
{
"date": "10/09/2026",
"event": "For Sale",
"price": {
"label": "$300,000",
"value": 300000,
"currency": "USD"
},
"listing_id": "e9yrn03ft4mwl",
"source_number": "ACT6976892",
"change_percent": 0,
"price_per_sqft_label": "$231 / Sq Ft"
},
{
"date": "05/31/2025",
"event": "Rented",
"price": {
"label": "$1,875",
"value": 1875,
"currency": "USD"
},
"listing_id": "r0j2yks4fhfpg",
"source_number": "ACT7288529",
"change_percent": 0,
"price_per_sqft_label": null
}
],
"property_type": {
"code": 1,
"slug": "house"
},
"days_on_market": 16,
"price_per_sqft": 231,
"sold_date_text": null,
"nearby_listings": [
{
"id": "4b020xwvk7nm5",
"url": "https://www.homes.com/property/8825-capitol-view-dr-austin-tx/4b020xwvk7nm5/",
"beds": 3,
"sqft": 1605,
"agent": {
"name": "Karla Trejo",
"phone": null,
"agency": "Vortex Realty",
"agent_id": null,
"photo_url": null,
"agency_logo_url": null
},
"baths": 2,
"price": {
"label": "$335,000",
"value": 335000,
"currency": "USD"
},
"badges": [
"$20K PRICE DROP"
],
"photos": [
{
"url": "https://images.homes.com/listings/111/2366551805-700553332/8825-capitol-view-dr-austin-tx-primaryphoto.jpg",
"width": 1620,
"height": 1080,
"caption": null
},
{
"url": "https://images.homes.com/listings/111/8366551805-700553332/8825-capitol-view-dr-austin-tx-buildingphoto-2.jpg",
"width": 1620,
"height": 1080,
"caption": null
}
],
"status": "active",
"address": {
"city": "Austin",
"full": "8825 Capitol View Dr, Austin, TX 78747",
"unit": null,
"state": "TX",
"street": "8825 Capitol View Dr",
"building": null,
"coordinates": {
"latitude": 30.149421,
"longitude": -97.746097
},
"postal_code": "78747"
},
"builder": null,
"beds_max": 3,
"beds_min": 3,
"lot_sqft": 6024,
"rent_max": null,
"rent_min": null,
"sqft_max": 1605,
"sqft_min": 1605,
"baths_max": 2,
"baths_min": 2,
"community": null,
"list_date": "2026-08-21T00:00:00+00:00",
"lot_acres": 0.13,
"photo_url": "https://images.homes.com/listings/111/2366551805-700553332/8825-capitol-view-dr-austin-tx-primaryphoto.jpg",
"sold_date": null,
"beds_label": "3 Beds",
"highlights": [],
"listing_id": "176hnkkzdcssh",
"year_built": 2013,
"baths_label": "2 Baths",
"description": "Meticulously cared-for, single-story home offering a spacious and inviting floor plan. Fresh interior and exterior paint gives the home a clean, move-in-ready feel! The generous...",
"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": 355000,
"currency": "USD"
},
"price_per_sqft": 209,
"property_manager": null,
"available_units_count": null
},
{
"id": "d06nhcn81197e",
"url": "https://www.homes.com/property/10602-double-tree-cove-austin-tx/d06nhcn81197e/",
"beds": 3,
"sqft": 1676,
"agent": {
"name": "Laurie Flood",
"phone": "(512) 576-6439",
"agency": "Keller Williams Realty",
"agent_id": "6ksjr2r",
"photo_url": "https://imagescdn.homes.com/i2/k3LUeyskM-Q9j-6yMa_1owarM5vKFsynX20R3mtPYVM/105/image.jpg?t=p&p=1",
"agency_logo_url": "https://images.homes.com/brands/105/9743_aspect.png?t=p"
},
"baths": 2,
"price": {
"label": "$319,000",
"value": 319000,
"currency": "USD"
},
"badges": [
"$106K PRICE DROP",
"Under Contract"
],
"photos": [
{
"url": "https://images.homes.com/listings/111/0379869794-904288422/10602-double-tree-cove-austin-tx-primaryphoto.jpg",
"width": 2048,
"height": 1364,
"caption": null
},
{
"url": "https://images.homes.com/listings/111/4670969794-904288422/10602-double-tree-cove-austin-tx-buildingphoto-2.jpg",
"width": 2048,
"height": 1364,
"caption": null
}
],
"status": "active",
"address": {
"city": "Austin",
"full": "10602 Double Tree Cove, Austin, TX 78750",
"unit": null,
"state": "TX",
"street": "10602 Double Tree Cove",
"building": null,
"coordinates": {
"latitude": 30.459596,
"longitude": -97.801513
},
"postal_code": "78750"
},
"builder": null,
"beds_max": 3,
"beds_min": 3,
"lot_sqft": null,
"rent_max": null,
"rent_min": null,
"sqft_max": 1676,
"sqft_min": 1676,
"baths_max": 2,
"baths_min": 2,
"community": null,
"list_date": "2026-06-05T00:00:00+00:00",
"lot_acres": null,
"photo_url": "https://images.homes.com/listings/111/0379869794-904288422/10602-double-tree-cove-austin-tx-primaryphoto.jpg",
"sold_date": null,
"beds_label": "3 Beds",
"highlights": [],
"listing_id": "p11w62bw5b47c",
"year_built": 1975,
"baths_label": "2 Baths",
"description": "Wonderful opportunity to own a single-story home on a quiet cul-de-sac backing to a greenbelt and walking trail, just a short walk from the neighborhood park, pool, and acclaime...",
"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": 425000,
"currency": "USD"
},
"price_per_sqft": 190,
"property_manager": null,
"available_units_count": null
}
],
"has_virtual_tour": false,
"estimated_payment": {
"label": "$2,362",
"value": 2362,
"currency": "USD"
},
"annual_property_tax": 7292,
"neighborhood_details": {
"name": "Milwood",
"stats": [
{
"name": "% Renters",
"value": "54%"
},
{
"name": "Household Income",
"value": "$110,180"
}
],
"photos": [
{
"url": "https://imagescdn.homes.com/i2/EnD_5lLCixhpWIiQD72GWtd160hyDaHMzGumOybB7yE/117/image.jpg?p=1",
"width": 3058,
"height": 1786,
"caption": null
},
{
"url": "https://imagescdn.homes.com/i2/EnD_5lLCixhpWIiQD72GWtd160hyDaHMzGumOybB7yE/117/image.jpg?p=1",
"width": 5223,
"height": 3482,
"caption": null
}
],
"description": "Milwood mixes oak-tree shaded residential blocks with secluded nature trails, and beloved local restaurants with offices for one of Austin 's largest employers. The neighborho...",
"neighborhood_id": "fz9zppf9glsxd"
},
"showing_requirements": [
"Must have four hours notice",
"Key at Desk"
]
},
"meta": {
"billable": true,
"endpoint_family": "listing"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
422
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"
}
404
Not Found
The listing does not exist or was removed. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "listing"
},
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found."
},
"success": false
}
503
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": "listing"
},
"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.