1 day trial then $19.00/month - No credit card required now

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal

igolaizola/idealista-scraper

1 day trial then $19.00/month - No credit card required now

Extract real estate data from Spain, Italy, and Portugal on idealista.com, including pricing, property features, and contact information. Scrape listings for residential, office, and commercial properties available for sale or rent.

You can access the Idealista Scraper - Real Estate Data for Spain, Italy, Portugal programmatically from your own applications by using the Apify API. You can choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

1{
2  "openapi": "3.0.1",
3  "info": {
4    "version": "0.0",
5    "x-build-id": "j5hdfz6672emdwFdh"
6  },
7  "servers": [
8    {
9      "url": "https://api.apify.com/v2"
10    }
11  ],
12  "paths": {
13    "/acts/igolaizola~idealista-scraper/run-sync-get-dataset-items": {
14      "post": {
15        "operationId": "run-sync-get-dataset-items-igolaizola-idealista-scraper",
16        "x-openai-isConsequential": false,
17        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
18        "tags": [
19          "Run Actor"
20        ],
21        "requestBody": {
22          "required": true,
23          "content": {
24            "application/json": {
25              "schema": {
26                "$ref": "#/components/schemas/inputSchema"
27              }
28            }
29          }
30        },
31        "parameters": [
32          {
33            "name": "token",
34            "in": "query",
35            "required": true,
36            "schema": {
37              "type": "string"
38            },
39            "description": "Enter your Apify token here"
40          }
41        ],
42        "responses": {
43          "200": {
44            "description": "OK"
45          }
46        }
47      }
48    },
49    "/acts/igolaizola~idealista-scraper/runs": {
50      "post": {
51        "operationId": "runs-sync-igolaizola-idealista-scraper",
52        "x-openai-isConsequential": false,
53        "summary": "Executes an Actor and returns information about the initiated run in response.",
54        "tags": [
55          "Run Actor"
56        ],
57        "requestBody": {
58          "required": true,
59          "content": {
60            "application/json": {
61              "schema": {
62                "$ref": "#/components/schemas/inputSchema"
63              }
64            }
65          }
66        },
67        "parameters": [
68          {
69            "name": "token",
70            "in": "query",
71            "required": true,
72            "schema": {
73              "type": "string"
74            },
75            "description": "Enter your Apify token here"
76          }
77        ],
78        "responses": {
79          "200": {
80            "description": "OK",
81            "content": {
82              "application/json": {
83                "schema": {
84                  "$ref": "#/components/schemas/runsResponseSchema"
85                }
86              }
87            }
88          }
89        }
90      }
91    },
92    "/acts/igolaizola~idealista-scraper/run-sync": {
93      "post": {
94        "operationId": "run-sync-igolaizola-idealista-scraper",
95        "x-openai-isConsequential": false,
96        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
97        "tags": [
98          "Run Actor"
99        ],
100        "requestBody": {
101          "required": true,
102          "content": {
103            "application/json": {
104              "schema": {
105                "$ref": "#/components/schemas/inputSchema"
106              }
107            }
108          }
109        },
110        "parameters": [
111          {
112            "name": "token",
113            "in": "query",
114            "required": true,
115            "schema": {
116              "type": "string"
117            },
118            "description": "Enter your Apify token here"
119          }
120        ],
121        "responses": {
122          "200": {
123            "description": "OK"
124          }
125        }
126      }
127    }
128  },
129  "components": {
130    "schemas": {
131      "inputSchema": {
132        "type": "object",
133        "required": [
134          "operation",
135          "propertyType",
136          "country",
137          "location"
138        ],
139        "properties": {
140          "maxItems": {
141            "title": "Max Items",
142            "type": "integer",
143            "description": "Maximum number of items to scrape (0 for unlimited).",
144            "default": 50
145          },
146          "operation": {
147            "title": "Operation",
148            "enum": [
149              "sale",
150              "rent"
151            ],
152            "type": "string",
153            "description": "Operation type to search (sale, rent)",
154            "default": "sale"
155          },
156          "propertyType": {
157            "title": "Property Type",
158            "enum": [
159              "homes",
160              "newDevelopments",
161              "offices",
162              "premises",
163              "garages",
164              "lands",
165              "storageRooms",
166              "buildings",
167              "bedrooms"
168            ],
169            "type": "string",
170            "description": "Property type to search (homes, newDevelopments, offices, premises, garages, lands, storageRooms, buildings, bedrooms)",
171            "default": "homes"
172          },
173          "country": {
174            "title": "Country",
175            "enum": [
176              "es",
177              "pt",
178              "it"
179            ],
180            "type": "string",
181            "description": "Select your country",
182            "default": "es"
183          },
184          "location": {
185            "title": "Location",
186            "type": "string",
187            "description": "Location to search, it can be a city name (e.g. Madrid) or an Idealista Location ID (e.g. 0-EU-ES-28-07-001-079). For the location, you can use the city name or the Idealista Location ID. Use [Idealista Location Search Tool](https://igolaizola.github.io/idealista-scraper) to find the specific Location ID you need.",
188            "default": "0-EU-ES-28-07-001-079"
189          },
190          "minPrice": {
191            "title": "Min Price",
192            "type": "integer",
193            "description": "Minimum price of the property (0 for any)",
194            "default": 0
195          },
196          "maxPrice": {
197            "title": "Max Price",
198            "type": "integer",
199            "description": "Maximum price of the property (0 for any)",
200            "default": 0
201          },
202          "minSize": {
203            "title": "Min Size",
204            "type": "integer",
205            "description": "Minimum size of the property (0 for any)",
206            "default": 0
207          },
208          "maxSize": {
209            "title": "Max Size",
210            "type": "integer",
211            "description": "Maximum size of the property (0 for any)",
212            "default": 0
213          },
214          "publicationDate": {
215            "title": "Publication Date",
216            "enum": [
217              "",
218              "Y",
219              "W",
220              "M"
221            ],
222            "type": "string",
223            "description": "Publication date of the property",
224            "default": ""
225          },
226          "proxyConfiguration": {
227            "title": "Proxy configuration",
228            "type": "object",
229            "description": "Select proxies to be used."
230          }
231        }
232      },
233      "runsResponseSchema": {
234        "type": "object",
235        "properties": {
236          "data": {
237            "type": "object",
238            "properties": {
239              "id": {
240                "type": "string"
241              },
242              "actId": {
243                "type": "string"
244              },
245              "userId": {
246                "type": "string"
247              },
248              "startedAt": {
249                "type": "string",
250                "format": "date-time",
251                "example": "2025-01-08T00:00:00.000Z"
252              },
253              "finishedAt": {
254                "type": "string",
255                "format": "date-time",
256                "example": "2025-01-08T00:00:00.000Z"
257              },
258              "status": {
259                "type": "string",
260                "example": "READY"
261              },
262              "meta": {
263                "type": "object",
264                "properties": {
265                  "origin": {
266                    "type": "string",
267                    "example": "API"
268                  },
269                  "userAgent": {
270                    "type": "string"
271                  }
272                }
273              },
274              "stats": {
275                "type": "object",
276                "properties": {
277                  "inputBodyLen": {
278                    "type": "integer",
279                    "example": 2000
280                  },
281                  "rebootCount": {
282                    "type": "integer",
283                    "example": 0
284                  },
285                  "restartCount": {
286                    "type": "integer",
287                    "example": 0
288                  },
289                  "resurrectCount": {
290                    "type": "integer",
291                    "example": 0
292                  },
293                  "computeUnits": {
294                    "type": "integer",
295                    "example": 0
296                  }
297                }
298              },
299              "options": {
300                "type": "object",
301                "properties": {
302                  "build": {
303                    "type": "string",
304                    "example": "latest"
305                  },
306                  "timeoutSecs": {
307                    "type": "integer",
308                    "example": 300
309                  },
310                  "memoryMbytes": {
311                    "type": "integer",
312                    "example": 1024
313                  },
314                  "diskMbytes": {
315                    "type": "integer",
316                    "example": 2048
317                  }
318                }
319              },
320              "buildId": {
321                "type": "string"
322              },
323              "defaultKeyValueStoreId": {
324                "type": "string"
325              },
326              "defaultDatasetId": {
327                "type": "string"
328              },
329              "defaultRequestQueueId": {
330                "type": "string"
331              },
332              "buildNumber": {
333                "type": "string",
334                "example": "1.0.0"
335              },
336              "containerUrl": {
337                "type": "string"
338              },
339              "usage": {
340                "type": "object",
341                "properties": {
342                  "ACTOR_COMPUTE_UNITS": {
343                    "type": "integer",
344                    "example": 0
345                  },
346                  "DATASET_READS": {
347                    "type": "integer",
348                    "example": 0
349                  },
350                  "DATASET_WRITES": {
351                    "type": "integer",
352                    "example": 0
353                  },
354                  "KEY_VALUE_STORE_READS": {
355                    "type": "integer",
356                    "example": 0
357                  },
358                  "KEY_VALUE_STORE_WRITES": {
359                    "type": "integer",
360                    "example": 1
361                  },
362                  "KEY_VALUE_STORE_LISTS": {
363                    "type": "integer",
364                    "example": 0
365                  },
366                  "REQUEST_QUEUE_READS": {
367                    "type": "integer",
368                    "example": 0
369                  },
370                  "REQUEST_QUEUE_WRITES": {
371                    "type": "integer",
372                    "example": 0
373                  },
374                  "DATA_TRANSFER_INTERNAL_GBYTES": {
375                    "type": "integer",
376                    "example": 0
377                  },
378                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
379                    "type": "integer",
380                    "example": 0
381                  },
382                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
383                    "type": "integer",
384                    "example": 0
385                  },
386                  "PROXY_SERPS": {
387                    "type": "integer",
388                    "example": 0
389                  }
390                }
391              },
392              "usageTotalUsd": {
393                "type": "number",
394                "example": 0.00005
395              },
396              "usageUsd": {
397                "type": "object",
398                "properties": {
399                  "ACTOR_COMPUTE_UNITS": {
400                    "type": "integer",
401                    "example": 0
402                  },
403                  "DATASET_READS": {
404                    "type": "integer",
405                    "example": 0
406                  },
407                  "DATASET_WRITES": {
408                    "type": "integer",
409                    "example": 0
410                  },
411                  "KEY_VALUE_STORE_READS": {
412                    "type": "integer",
413                    "example": 0
414                  },
415                  "KEY_VALUE_STORE_WRITES": {
416                    "type": "number",
417                    "example": 0.00005
418                  },
419                  "KEY_VALUE_STORE_LISTS": {
420                    "type": "integer",
421                    "example": 0
422                  },
423                  "REQUEST_QUEUE_READS": {
424                    "type": "integer",
425                    "example": 0
426                  },
427                  "REQUEST_QUEUE_WRITES": {
428                    "type": "integer",
429                    "example": 0
430                  },
431                  "DATA_TRANSFER_INTERNAL_GBYTES": {
432                    "type": "integer",
433                    "example": 0
434                  },
435                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
436                    "type": "integer",
437                    "example": 0
438                  },
439                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
440                    "type": "integer",
441                    "example": 0
442                  },
443                  "PROXY_SERPS": {
444                    "type": "integer",
445                    "example": 0
446                  }
447                }
448              }
449            }
450          }
451        }
452      }
453    }
454  }
455}

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Idealista Scraper - Real Estate Data for Spain, Italy, Portugal from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal API in Python

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal API in JavaScript

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal API through CLI

Idealista Scraper - Real Estate Data for Spain, Italy, Portugal API

Developer

Iñigo Garcia Olaizola

Actor Metrics

25 monthly users
8 stars
>99% runs succeeded
Created in Oct 2024
Modified 5 days ago

Categories

Real estate

Automation

Idealist.com-italy

lukass/idealista-crawler-italy

Are you looking for a property in Italy? With idealista it's easier, with more than 1.400.000 listings of flats and houses for sale or rent. Advertise your home privately for free.

Lukáš Širhal

Zillow ZIP Code Search Scraper

maxcopell/zillow-zip-search

Scraper to find all Zillow real estate properties for sale, for rent or recently sold from given ZIP code locations.

Maximillian Copelli

531

Zillow Detail Scraper

maxcopell/zillow-detail-scraper

Get details of Zillow properties from URLs. This Actor can be easily integrated with other Zillow Scrapers.

Maximillian Copelli

994

Airbnb Scraper

onidivo/airbnb-scraper

Crawl the Airbnb site and extract data about rentals. Scrape rental details for any location with many filters. Download and use the data in whatever way you want.

Onidivo Technologies

368

Apartments.com Scraper 🏡

epctex/apartments-scraper

Scrape Apartments.com to crawl millions of real estate properties nationwide. Specify any US location and extract data on all available properties in that area. Our real estate scraper lets you filter and limit the results by page or total number. You can also target a specific property or area.

epctex

631

Zillow Search Scraper

maxcopell/zillow-scraper

Extract data about properties for sale and rent on Zillow using the Zillow API, but with no daily call limits. Scrape millions of listings and download your data as HTML, JSON, CSV, Excel, XML. Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.

Maximillian Copelli

1.1k

Rightmove Scraper

dhrumil/rightmove-scraper

Scrape rightmove.co.uk to crawl millions of sale/rent real estate properties from United Kingdom. Our real estate scraper also lets you monitor specific listing for new updates/listing. You can provide multiple search result listings to scrape/monitor.

Dhrumil Bhankhar

180

Realtor.com Scraper

epctex/realtor-scraper

Uncover valuable insights from realtor.com's extensive property listings. Extract descriptions, images, features, property details, pricing, neighborhood details, nearby schools, and more for millions of properties. Customize your searches and filters to find the perfect real estate data.

epctex

880