Homestra Search
Search Homestra property listings using a direct search URL with filters, returning structured results with prices, sizes, locations, and photos.
Credit cost: 1 credit per call
Authentification
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Paramètres de requête
query*string
A valid Homestra search URL with optional filters.
Example:
https://homestra.com/list/houses-for-sale/?maximum-price=900000&minimum-price=75000&page=1You can customize filters directly in the URL, including price range, property type, location, and page number.
Notes:
- URL-encode
&as%26when passing the query in a GET request parameter. - Use
page=Nto paginate through results.
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/homestra/search?query=string"[ { "id": "0d45a754-0e49-4c35-b0b6-bf1dba0d47cd", "city": "Valderice", "size": 114, "slug": "spacious-3-bed-detached-home-with-sea-views-and-guest-studio-in-valderice-trapani", "type": "house", "price": 250000, "title": "Spacious 3-Bed Detached Home with Sea Views and Guest Studio in Valderice, Trapani", "status": "for_sale", "address": "Valderice, Trapani, Sicily, Italy", "location": { "type": "Point", "coordinates": [ 38.04061, 12.62553 ] }, "lot_size": 800, "photo_url": "https://storage.googleapis.com/homestra-images/property-image-e4e958d4-fdc4-430c-a6e3-aee2cd7b6fd0-1721847180.jpg", "country_code": "it", "listing_date": "2024-07-25T22:26:03.577Z" }, { "id": "41d7f3ef-6d42-4fb2-9ddf-1d07ea0d683f", "city": "Carvoeiro", "size": 330, "slug": "peaceful-3-bedroom-villa-with-panoramic-views-in-barroselas-portugal", "type": "house", "price": 349000, "title": "Peaceful 3-Bedroom Villa with Panoramic Views in Barroselas, Portugal", "status": "for_sale", "address": "Minho, Barroselas, Portugal", "location": { "type": "Point", "coordinates": [ 41.65043, -8.67458 ] }, "lot_size": 1673, "photo_url": "https://storage.googleapis.com/homestra-images/property-image-e4e958d4-fdc4-430c-a6e3-aee2cd7b6fd0-1721847180.jpg", "country_code": "pt", "listing_date": "2024-07-25T21:30:10.404Z" }]{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}