Realtor Search
Search Realtor.com listings from a search URL and retrieve prices, beds, baths, sqft, photos, and property metadata.
Credit cost: 2 credits per call
Autorización
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parámetros de consulta
query*string
Full Realtor.com search results URL.
Example 1 (state search):
https://www.realtor.com/realestateandhomes-search/New-York_NYExample 2 (city search):
https://www.realtor.com/realestateandhomes-search/Brooklyn_NYNotes:
- Only Realtor.com search URLs are accepted.
- Filters and pagination parameters in the URL are respected.
- Use each result's
permalinkor property detail URL with the Realtor Property endpoint.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/realtor/search?query=string"{ "results": [ { "photos": [ { "href": "https://ap.rdcpix.com/67dd84d210896e04e1252c2c8bc52c57l-m3226683124s.jpg" } ], "location": { "address": { "city": "Brooklyn", "line": "299 Troutman St", "state": "NY", "postal_code": "11237" } }, "permalink": "299-Troutman-St_Brooklyn_NY_11237_M99576-61733", "list_price": 500000, "description": { "beds": 16, "sqft": 6500, "type": "SingleFamilyResidence", "baths": 8, "lot_size": 2500 }, "property_id": "9957661733" }, { "photos": [ { "href": "https://ap.rdcpix.com/eac307cc2348e0014f42e489f57f5d02l-m3092249856s.jpg" } ], "location": { "address": { "city": "Bronx", "line": "D132 Edgewater Unit D", "state": "NY", "postal_code": "10465" } }, "permalink": "D132-Edgewater-Unit-D_Bronx_NY_10465_M94332-74355", "list_price": 255000, "description": { "beds": 4, "sqft": 1200, "type": "SingleFamilyResidence", "baths": 1, "lot_size": null }, "property_id": "9433274355" }, { "photos": [ { "href": "https://ap.rdcpix.com/77415ad2b4919799a0cb455c54eab3fcl-m2351895655s.jpg" } ], "location": { "address": { "city": "New York", "line": "2573 Frederick Douglass Blvd Apt A", "state": "NY", "postal_code": "10030" } }, "permalink": "2573-Frederick-Douglass-Blvd-Apt-A_New-York_NY_10030_M92978-65175", "list_price": 275000, "description": { "beds": 2, "sqft": 1175, "type": "Apartment", "baths": 2.5, "lot_size": null }, "property_id": "9297865175" }, { "photos": [ { "href": "https://ap.rdcpix.com/e5f2913192e3c223cc21e05ea213844el-m1072321830s.jpg" } ], "location": { "address": { "city": "Woodhaven", "line": "86-34 77th St", "state": "NY", "postal_code": "11421" } }, "permalink": "8634-77th-St_Woodhaven_NY_11421_M46500-03200", "list_price": 603200, "description": { "beds": 6, "sqft": null, "type": "SingleFamilyResidence", "baths": 2, "lot_size": 2614 }, "property_id": "4650003200" } ]}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}