Idealista Provinces
GET
List the 50 Spanish provinces Idealista shows for homes for sale. Each row includes the sale search URL to pass as query to Idealista Search. Madrid is madrid-provincia.
Credit cost: 3 credits per call
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
results?array<>curl -X GET 'https://api.piloterr.com/v2/idealista/provinces'Example Response
{ "results": [ { "url": "https://www.idealista.com/venta-viviendas/madrid-provincia/", "name": "Madrid", "slug": "madrid-provincia", "region": "Comunidad de Madrid", "listing_count": 34094 } ]}