Idealista

idealista

Two modes are supported. Provide either search parameters (with location) or a single listing id.

Mode A — Search listings (requires location)

Parameter	Type	Required	Description
location	string	Yes	Idealista location code. Must be exactly 21 characters.
locale	string	No	Locale for the response (e.g. language).
operation	string	No	One of sale, rent.
propertyType	string	No	One of homes, offices, premises, garages, bedrooms, newDevelopments, lands.
maxItems	number	No	Maximum number of results. Minimum 1.
page	number	No	Page number for pagination. Minimum 1.
sortBy	string	No	Sort field.
sortOrder	string	No	Sort direction. One of asc, desc.
country	string	No	See common parameters.
parse	boolean	No	See common parameters.

Mode B — Fetch a single listing (requires id)

Parameter	Type	Required	Description
id	string	Yes	The listing ID to fetch.
locale	string	No	Locale for the response.
country	string	No	See common parameters.
parse	boolean	No	See common parameters.

---

cURL

curl -X POST 'https://scraping.production.goproxies.com/api/v1/scrapes' \
  -H 'X-Api-Key: <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "idealista": {
      "location": "0-EU-ES-28-07-001-079",
      "operation": "rent",
      "propertyType": "homes",
      "maxItems": 30,
      "page": 1,
      "sortOrder": "desc"
    }
  }'

JavaScript

Python