Piloterr

Idealista Provinces

GET
/v2/idealista/provinces

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

Autorisierung

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
results?array<>
Example Request
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    }  ]}