JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/realtor/search with Content-Type: application/json and your Authorization: Bearer header.
{
"url": "https://www.realtor.com/realestateandhomes-search/Austin_TX/",
"limit": 5
}// request reference
Realtor.com Search parameters
Send query parameters with GET /api/realtor/search. 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
Search Realtor.com listings from a public location URL, preserving its filters and available page links.
limitListings per results page, from 1 to 200.
Type integer · GET query or POST JSON · Default 40
- Minimum: 1
- Maximum: 200
urlRealtor.com city_STATE or ZIP search URL under /realestateandhomes-search/ or /apartments/.
Type string · GET query or POST JSON
- Alpha: availability may vary by location or property.
- Supported URL filters: price, beds, baths, sqft, type-single-family-home, show-recently-sold and pg-1 through pg-100. Unsupported filters and query parameters are rejected. Follow pagination.next when present. Bedroom filters require whole numbers.
- Maximum characters: 4096
// 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, properties, search_information, pagination, 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-first-party-fixture",
"status": "Success",
"url": "https://api.litescrape.com/api/realtor/search",
"total_time_taken": 0
},
"search_parameters": {
"limit": 5,
"url": "https://www.realtor.com/realestateandhomes-search/Austin_TX/"
},
"properties": [
{
"property_id": "9484527231",
"url": "https://www.realtor.com/realestateandhomes-detail/505-Bird-Holw_Austin_TX_78737_M94845-27231",
"address": "505 Bird Holw",
"city": "Austin",
"state": "TX",
"zipcode": "78737",
"coordinates": {
"lat": 30.161156,
"lon": -97.98212
},
"price": 1075900,
"status": "for_sale",
"property_type": "single_family",
"beds": 4,
"baths": 4,
"sqft": 3295,
"primary_photo": "http://nh.rdcpix.com/a1dcc68d46ee048feea1e9d157881143l-f1245593101s.jpg"
},
{
"property_id": "9083902832",
"url": "https://www.realtor.com/realestateandhomes-detail/433-Running-Bird-Rd_Austin_TX_78737_M90839-02832",
"address": "433 Running Bird Rd",
"city": "Austin",
"state": "TX",
"zipcode": "78737",
"coordinates": {
"lat": 30.157216,
"lon": -97.98494
},
"price": 749500,
"status": "for_sale",
"property_type": "single_family",
"beds": 4,
"baths": 3,
"sqft": 2998,
"lot_sqft": 10890,
"year_built": 2022,
"primary_photo": "http://ap.rdcpix.com/ba1c28e3cdeb7ad9a9fa818496c398d1l-m586053119s.jpg"
},
{
"property_id": "9032208100",
"url": "https://www.realtor.com/realestateandhomes-detail/Kestrel-Cv_Austin_TX_78737_M90322-08100",
"address": "Kestrel Cv",
"city": "Austin",
"state": "TX",
"zipcode": "78737",
"coordinates": {
"lat": 30.16858074,
"lon": -97.97995178
},
"price": 795000,
"status": "for_sale",
"property_type": "land",
"lot_sqft": 43560,
"primary_photo": "http://ap.rdcpix.com/ee56f4fdc159d8650f188d30ccb76b87l-m3283783855s.jpg"
},
{
"property_id": "9076034122",
"url": "https://www.realtor.com/realestateandhomes-detail/248-Broadwing-Cv_Austin_TX_78737_M90760-34122",
"address": "248 Broadwing Cv",
"city": "Austin",
"state": "TX",
"zipcode": "78737",
"coordinates": {
"lat": 30.166531,
"lon": -97.973869
},
"price": 730000,
"status": "for_sale",
"property_type": "land",
"lot_sqft": 61855,
"primary_photo": "http://ap.rdcpix.com/97b89a2224e53da84a5179a178eb54d2l-m172331595s.jpg"
},
{
"property_id": "9083983561",
"url": "https://www.realtor.com/realestateandhomes-detail/147-Epoch-Dr_Austin_TX_78737_M90839-83561",
"address": "147 Epoch Dr",
"city": "Austin",
"state": "TX",
"zipcode": "78737",
"coordinates": {
"lat": 30.15888,
"lon": -97.957848
},
"price": 699000,
"status": "for_sale",
"property_type": "single_family",
"beds": 4,
"baths": 3,
"sqft": 2935,
"year_built": 2024,
"primary_photo": "http://ap.rdcpix.com/3013aaecd377d479c1107d942e106281l-m3421145952s.jpg"
}
],
"search_information": {
"total_results": 6854,
"returned_results": 5
},
"pagination": {
"current_page": 1,
"next": "https://ecll-litescrape-v3--site-api-web.modal.run/api/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX%2Fpg-2&limit=5"
},
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}