{"uid":"cap_GgS9NUxUm7I-NG-3HCXNk","slug":"idealista-real-estate-scraper-x402-db924268","name":"Idealista Real Estate Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/idealista?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"enum":["es","pt","it","fr"],"type":"string","default":"fr","description":"Country for generated routes and listing links."},"maxSize":{"type":"integer","default":0,"minimum":0,"description":"Keep only listings at or below this size in square meters. Zero means any size. Applied after reading the page."},"minSize":{"type":"integer","default":0,"minimum":0,"description":"Keep only listings at or above this size in square meters. Applied after reading the page."},"bedrooms":{"type":"array","items":{"type":"string"},"default":[],"description":"Keep only listings with one of these exact bedroom counts. Empty means any."},"location":{"type":"string","default":"Paris","description":"City name for a generated homes search route. In France, only Paris has a verified generated route; use an exact URL elsewhere."},"maxItems":{"type":"integer","default":50,"minimum":0,"description":"Maximum number of unique listings to save. Zero means no item limit."},"maxPages":{"type":"integer","default":50,"minimum":1,"description":"Maximum result pages to visit for each search URL or location."},"maxPrice":{"type":"integer","default":0,"minimum":0,"description":"Keep only listings at or below this price in euros. Zero means any price. Applied after reading the page."},"minPrice":{"type":"integer","default":0,"minimum":0,"description":"Keep only listings at or above this price in euros. Applied after reading the page."},"locations":{"type":"array","items":{"type":"string"},"default":[],"description":"Optional city names or search URLs to search in order. Overrides location."},"operation":{"enum":["sale","rent"],"type":"string","default":"sale","description":"Search properties for sale or rent."},"searchUrls":{"type":"array","items":{"type":"string"},"default":[],"description":"Exact public search result URLs. Overrides location and locations; use for detailed site filters or non-home property types."},"fetchDetails":{"type":"boolean","default":false,"description":"Visit each listing page to add a fuller description and image URLs when available. This adds one request per listing."},"propertyType":{"enum":["homes"],"type":"string","default":"homes","description":"Homes are supported for generated search routes. For other property types, supply exact search URLs."},"propertyCodes":{"type":"array","items":{"type":"string"},"default":[],"description":"Optional listing codes to fetch directly instead of search pages."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"size":null,"price":null,"title":null,"currency":null,"operation":null,"propertyCode":null,"propertyType":null}],"product":"idealista"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xcGYvqs7jCBudYc9V8gbo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured property listings from Idealista across Spain, Portugal, Italy, and France with filtering by price, size, bedrooms, and operation type.","exampleAgentPrompt":"Find me all apartments for sale in Madrid under 400,000 euros with at least 2 bedrooms and no more than 100 square meters — pull up to 50 listings from Idealista Spain.","exampleUseCases":[{"title":"Budget apartment hunt in Paris","prompt":"Search Idealista France for rental apartments in Paris with 1 or 2 bedrooms priced between 1000 and 2000 euros per month, and give me up to 30 listings."},{"title":"Investment property research in Lisbon","prompt":"I'm looking at buying property in Lisbon — can you scrape Idealista Portugal for houses for sale between 250,000 and 600,000 euros, at least 80 square meters, up to 20 results?"},{"title":"Bulk data export from custom Idealista search","prompt":"I've already filtered what I want on Idealista — here's the search URL: https://www.idealista.com/en/venta-viviendas/barcelona/... — extract all listings from it, up to 100 items, for sale in Spain."}],"resultDescription":"A JSON object containing a count of matched listings and an array of items, each with URL, title, price, currency, size, operation type, property code, and property type — filtered to match the requested criteria.","failureModes":["Empty result set if filters are too restrictive — not charged","Idealista blocks or rate-limits the scraper — may return partial or no results","Invalid country/location combination returns no generated route","Non-Paris French cities require exact search URLs; generated routes may fail","Network or site changes may cause incomplete extractions"],"whenToPreferThis":"Use this endpoint when you need structured property listing data from Idealista specifically, covering Spain, Portugal, Italy, or France. Prefer it over generic web scrapers because it returns clean, schema-consistent output with built-in filtering and is pay-per-successful-call. Best for agents automating real estate research, price comparison, or property monitoring in Southern Europe.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:55.559Z","isFirstParty":false,"canonicalSlug":"idealista-real-estate-scraper-x402-db924268"}