Idealista.com avatar
Idealista.com

Pricing

$22.00/month + usage

Go to Store
Idealista.com

Idealista.com

lukass/idealista-scraper

Developed by

Lukáš Širhal

Maintained by Community

Are you looking for a property in Spain or Portugal? 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.

5.0 (1)

Pricing

$22.00/month + usage

7

Monthly users

45

Runs succeeded

>99%

Response time

9.7 days

Last modified

22 days ago

You can access the Idealista.com programmatically from your own applications by using the Apify API. You can also 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# Start Server-Sent Events (SSE) session and keep it running
2curl "https://actors-mcp-server.apify.actor/sse?token=<YOUR_API_TOKEN>&actors=lukass/idealista-scraper"
3
4# Session id example output:
5# event: endpoint
6# data: /message?sessionId=9d820491-38d4-4c7d-bb6a-3b7dc542f1fa

Using Idealista.com via Model Context Protocol (MCP) server

MCP server lets you use Idealista.com within your AI workflows. Send API requests to trigger actions and receive real-time results. Take the received sessionId and use it to communicate with the MCP server. The message starts the Idealista.com Actor with the provided input.

1curl -X POST "https://actors-mcp-server.apify.actor/message?token=<YOUR_API_TOKEN>&session_id=<SESSION_ID>" -H "Content-Type: application/json" -d '{
2  "jsonrpc": "2.0",
3  "id": 1,
4  "method": "tools/call",
5  "params": {
6    "arguments": {
7      "district": "Madrid",
8      "maxItems": 10,
9      "endPage": 50,
10      "startUrl": [],
11      "proxy": {
12            "useApifyProxy": true,
13            "apifyProxyGroups": [
14                  "RESIDENTIAL"
15            ]
16      }
17},
18    "name": "lukass/idealista-scraper"
19  }
20}'

The response should be: Accepted. You should received response via SSE (JSON) as:

1event: message
2data: {
3  "result": {
4    "content": [
5      {
6        "type": "text",
7        "text": "ACTOR_RESPONSE"
8      }
9    ]
10  }
11}

Configure local MCP Server via standard input/output for Idealista.com

You can connect to the MCP Server using clients like ClaudeDesktop and LibreChat or build your own. The server can run both locally and remotely, giving you full flexibility. Set up the server in the client configuration as follows:

1{
2  "mcpServers": {
3    "actors-mcp-server": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "@apify/actors-mcp-server",
8        "--actors",
9        "lukass/idealista-scraper"
10      ],
11      "env": {
12        "APIFY_TOKEN": "<YOUR_API_TOKEN>"
13      }
14    }
15  }
16}

You can further access the MCP client through the Tester MCP Client, a chat user interface to interact with the server.

To get started, check out the documentation and example clients. If you are interested in learning more about our MCP server, check out our blog post.

Pricing

Pricing model

Rental 

To use this Actor, you have to pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage.

Free trial

7 days

Price

$22.00