# Scrapier — Idealista API > Scrapier endpoints for Idealista: Idealista Property. Base URL: https://api.scrapier.io/api/v2 · Auth: header `X-API-Key: ` · Synchronous: HTTP 200 returns {"success": true, "data": {...}} · Paginate by sending data.next_cursor back as `cursor` until it is null · Paths keep the trailing slash. Live parameter source (no auth): https://api.scrapier.io/api/v2/endpoints · Docs: https://docs.scrapier.io/api-reference/idealista.md ## GET /idealista/ Idealista Property: Structured Idealista data: send `location`. Cursor-paginated, 1 credit per successful call. Cost: 1 credit per successful call · Pagination: cursor · Results: data.listings Parameters: - location (required, string, example Madrid, locked in cursor): Idealista location ID or place name. Required first call (or property_codes); - property_codes (optional, string): Comma-separated codes for direct-lookup mode. - operation (optional, string, one of: sale|rent, default sale, locked in cursor): - property_type (optional, string, default homes, locked in cursor): - country (optional, string, one of: es|pt|it, default es, locked in cursor): - sort_by (optional, string, default mostRecent, locked in cursor): - fetch_details (optional, boolean, default true, locked in cursor): Per-listing _details. - fetch_stats (optional, boolean, default true, locked in cursor): Per-listing _stats. - cursor (optional, string): Pagination cursor returned in the previous response's `next_cursor`. Pass it back unchanged to fetch the next page. When `next_cursor` is null, you have reached the last page. - raw_data (optional, boolean, default false): When true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under `raw_responses`, in place of the formatted items. When false (default) you get the formatted output. Pagination (`cursor` / `next_cursor`) works the same in both modes. Example: curl "https://api.scrapier.io/api/v2/idealista/?location=Madrid" -H "X-API-Key: YOUR_API_KEY" Docs: https://docs.scrapier.io/api-reference/idealista/idealista.md