Extract property listings from any Idealista search results page. Returns structured listings with price, title, details, thumbnail, agency info, parking flag, and pagination metadata via browser rendering.
GET https://api.piloterr.com/v2/idealista/search?query=https://www.idealista.com/venta-viviendas/barcelona/ciutat-vella/la-barceloneta/
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Idealista search URL |
| Field |
Type |
Description |
results |
array |
List of property listings |
results[].link |
string |
Property detail URL |
results[].price |
integer | null |
Listing price |
results[].title |
string | null |
Listing title |
results[].details |
array |
Short specs (bedrooms, surface, floor); may be empty |
results[].picture |
string |
Thumbnail image URL |
results[].currency |
string | null |
Currency symbol (e.g. €) |
results[].description |
string | null |
Truncated listing description |
results[].listing_company |
string | null |
Agency name |
results[].listing_company_url |
string | null |
Agency profile URL |
results[].parking_included |
boolean |
Whether parking is included |
pagination.current |
integer |
Current page number |
pagination.next |
integer | null |
Next page number |
pagination.total_pages |
integer |
Total pages |
pagination.other_pages |
array |
Other available page numbers |
pagination.has_next_page |
boolean |
Whether a next page exists |
- Response is returned under
results with a pagination object.
- Only full Idealista search URLs are accepted as
query.
- Some cards may return partial data (
price, title, currency, or description as null).
details may be an empty array on incomplete cards.listing_company and listing_company_url may be null on private listings.- Pass a property detail URL to the Idealista Property endpoint for full listing data.
- Monitor for-sale inventory in Spanish and European markets
- Build lead lists with price, specs, and agency attribution
- Feed property discovery pipelines for real estate analytics
- Track pagination across Idealista search result pages
