# Homes.com Listing API Documentation

<p><strong>Homes.com Listing API</strong> returns the full record of one listing. Pass the property <code>id</code> 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.</p>

- **Documentation:** [https://scrappa.co/docs/homes-com-api/homes_com_listing](https://scrappa.co/docs/homes-com-api/homes_com_listing)
- **API group:** Homes.com API
- **Endpoint:** `GET https://scrappa.co/api/homes-com/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Property id from search, autocomplete or a listing URL. Use either id or url. Example: gc95tmcstsspt. |
| `url` | string | No | Full homes.com listing URL. Use either id or url. |

## Example response

```json
{
    "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

| Status | Error | Description |
| --- | --- | --- |
| 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. |
| 404 | Not Found | The listing does not exist or was removed. This response is not billable. |
| 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. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
