---
title: "GET /idealista/search"
method: GET
path: "/idealista/search"
tags: ["Idealista"]
---

# GET /idealista/search

`GET /idealista/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/idealista/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `country` 'es' | 'it' | 'pt' | 'fr', required
- `operation` 'sale' | 'rent', required
- `property_type` 'homes' | 'newDevelopments' | 'bedrooms' | 'offices' | 'premises' | 'transfers' | 'buildings' | 'storageRooms' | 'garages' | 'vacationRentals' | 'luxury' | 'lands', required
- `location_id` string, nullable
- `center` string, nullable
- `distance` integer, nullable
- `max_items` integer
- `num_page` integer
- `order` string, nullable
- `sort` 'asc' | 'desc' | 'null', nullable
- `quality` 'high' | 'low' | 'null', nullable
- `gallery` boolean, nullable
- `locale` string, nullable
- `microsite_short_name` string, nullable
- `chalet` boolean, nullable
- `current_occupation_type` 'free' | 'bareOwnership' | 'tenanted' | 'illegallyOccupied' | 'viager' | 'null', nullable
- `auction` 'onlyAuctions' | 'excludeAuctions' | 'null', nullable
- `home_type` string, nullable
- `bank_offer` string, nullable
- `advertiser_type` string, nullable
- `min_price` integer, nullable
- `max_price` integer, nullable
- `min_size` integer, nullable
- `max_size` integer, nullable
- `min_rooms` integer, nullable
- `max_rooms` integer, nullable
- `shape` string, nullable

## Response `200`

- string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `404`: The requested listing, zone, or agency was not found. This response is not billable.
- `422`: A public parameter is invalid, including rejected property types. This response is not billable.
- `503`: The service could not obtain a complete result. This response is not billable.

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/2f4af6143d10?raw)