JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/homes/property with Content-Type: application/json and your Authorization: Bearer header.
{
"url": "https://www.homes.com/property/7516-windrush-dr-austin-tx/x5zewgn876r6t/"
}// request reference
Homes.com Property parameters
Send query parameters with GET /api/homes/property. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
Read available property facts, prices and listing details from a public Homes.com property URL.
urlHomes.com property URL under /property/, without query parameters.
Type string · GET query or POST JSON
- Alpha: availability may vary by location or property.
- Returns available property facts, descriptions, coordinates, agents and photos. Price history is not available from this route.
- Returns available fields for the requested property.
- Maximum characters: 2048
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_metadata, search_parameters, property, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_metadata": {
"id": "retained-live-modal-capture",
"status": "Success",
"url": "https://api.litescrape.com/api/homes/property",
"total_time_taken": 0.289
},
"search_parameters": {
"url": "https://www.homes.com/property/7516-windrush-dr-austin-tx/x5zewgn876r6t/"
},
"property": {
"property_id": "x5zewgn876r6t",
"listing_id": "7qqz3lwfp9jpw",
"url": "https://www.homes.com/property/7516-windrush-dr-austin-tx/x5zewgn876r6t/",
"address": "7516 Windrush Dr",
"city": "Austin",
"state": "TX",
"zipcode": "78729",
"country": "US",
"latitude": 30.451128,
"longitude": -97.754989,
"price": 549000,
"beds": 4,
"baths": 2.5,
"sqft": 2884,
"year_built": 1990,
"lot_acres": 0.12,
"lot_sqft": 5296,
"price_per_sqft": 190,
"property_type_code": 1,
"transaction_type_code": 1,
"description": "This move-in ready and updated home features new paint and flooring, quick access to trails, and refreshed bathrooms! A morning stroll on the Rattan Creek trail starts just a few doors down from this 4-bedroom, 2.5-bathroom Milwood two-story. The moment you walk through the front door, your eyes go straight up; the entryway ceilings soar to the second floor, creating an immediate welcome that",
"photos": [
"https://images.homes.com/listings/115/7265341894-089973722/7516-windrush-dr-austin-tx-primaryphoto.jpg",
"https://images.homes.com/listings/115/2965341894-089973722/7516-windrush-dr-austin-tx-buildingphoto-2.jpg",
"https://images.homes.com/listings/115/2665341894-089973722/7516-windrush-dr-austin-tx-buildingphoto-3.jpg"
],
"agents": [
{
"agentUserKey": {
"key": "y96h0cv"
},
"fullName": "Ashley Jackson",
"firstName": "Ashley",
"lastName": "Jackson",
"agencyName": "Compass RE Texas, LLC",
"agencyLogoUrl": "https://images.homes.com/brands/104/2843_aspect.png?t=p",
"phoneNumber": "(512) 949-9364",
"ctnPhone": "(737) 332-3430",
"destinationPhone": "(512) 949-9364",
"agentImageUrl": "https://imagescdn.homes.com/i2/d-9HEIVelhDzTZad8xTEUAk4GZ-E-KUo1NLYHIG1Fy0/104/image.jpg?t=p&p=1",
"agentThumbnailImageUrl": "https://imagescdn.homes.com/i2/d-9HEIVelhDzTZad8xTEUAk4GZ-E-KUo1NLYHIG1Fy0/105/ashley-jackson.jpg?t=p&p=1",
"role": 1,
"isActive": true,
"isMember": true,
"primaryBrokerageColor": "#E3523B"
}
],
"open_houses": [],
"attribution": {
"showMlsLogo": false,
"showMlsLogoInColor": false,
"mlsLogoUrl": "https://images.homes.com/brands/105/1743_aspect.png?t=p",
"showFooterDisclaimer": false,
"showListedByPrefixForBrokerName": false,
"disclaimer": "Based on information from the Austin Board of REALTORS® (alternatively, from ACTRIS). Neither the Board nor ACTRIS guarantees or is in any way responsible for its accuracy. All data is provided “AS IS” and with all faults. Data maintained by the Board or ACTRIS may not reflect all real estate activity in the market. <br/>Information being provided is for consumers’ personal, non-commercial use and may not be used for any purpose other than to identify prospective properties consumers may be interested in purchasing. All data is obtained from various sources and may not have been verified by broker or MLS GRID. Supplied Open House Information is subject to change without notice. All information should be independently reviewed and verified for accuracy. Properties may or may not be listed by the office/agent presenting the information. Some IDX listings have been excluded from this website.<br/>Based on information submitted to the MLS GRID<br/>Listings courtesy of Unlock MLS (Austin Board of REALTORS®) as distributed by MLS GRID",
"showBrokerOfficeName": false,
"showHeaderLogo": false,
"hideSoldListingPhotos": false,
"onlyShowPrimarySoldListingPhoto": true,
"onlyShowPrimaryPendingListingPhoto": false,
"mlsId": 14000,
"mlsName": "Austin_ABOR",
"mlsAbbreviation": "ACTRIS MLS",
"mlsLogoWidth": 540,
"mlsLogoHeight": 300,
"mlsLogoAspectRatio": 1.8,
"showMlsLogoOnClickCard": false,
"hideUnderContractStatus": false
}
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}