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
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.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"
}