Skip to content
Examples

Add Tasks

Add Idealista search URLs as tasks for scraping property listings

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POSThttps://api.lobstr.io/v1/tasks

Add Idealista search URLs to your squid for scraping Spanish property listings. The scraper extracts real estate listings including price, area, bedrooms, contact information, and listing details from Idealista.com search results.

Crawler ID: 5f4b269e29e601e09fa50f4155b3970e

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request body format. Value: application/json

Task Format

Each task should contain a URL from an Idealista search results page. You can search for properties by location, type, and other filters on Idealista, then use those search URLs as tasks.

Supported URL Formats

The scraper supports Idealista search URLs from various property categories:

  • a town or zone: https://www.idealista.com/en/venta-viviendas/vizcaya/
  • several zones picked on the map: https://www.idealista.com/en/multi/venta-viviendas/<zones>/
  • an area drawn on the map: https://www.idealista.com/en/areas/venta-viviendas/?shape=...
  • any of these in map view (ending in /mapa-google): the scraper returns the same listings as the list view

Apply filters on Idealista (price range, property type, number of bedrooms) before copying the URL to get more targeted results.

Idealista uses different language subdomains. The scraper works with /en/ (English), /es/ (Spanish), and other language versions.

Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "YOUR_SQUID_HASH",
    "tasks": [
      {
        "url": "https://www.idealista.com/en/venta-viviendas/vizcaya/"
      }
    ]
  }'

Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "82367f24d9450b2222080eed91662968",
      "created_at": "2025-07-17T09:06:47.287893",
      "is_active": true,
      "params": {
        "url": "https://www.idealista.com/en/venta-viviendas/vizcaya/"
      },
      "module": 115,
      "object": "task"
    }
  ]
}