{"uid":"cap_XWteuHlqVvL789UnTEV8j","slug":"idealista-property-search-scraper-bfe26eef","name":"Idealista Property Search Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_JIYZfhbABxc9AoS3OEGbY","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 and returns structured property listings from Idealista across Spain, Portugal, Italy, and France with filtering by price, size, bedrooms, and operation type.","exampleAgentPrompt":"Can you pull me Idealista listings for apartments for rent in Paris, France — up to 50 results, no more than 1500 euros per month, at least 40 square meters, and with 1 or 2 bedrooms?","exampleUseCases":[{"title":"Apartment hunting in Paris","prompt":"Find me apartments for rent in Paris on Idealista — I want up to 30 listings, between 500 and 1500 euros per month, at least 30 square meters, and only show me 1 or 2 bedroom options."},{"title":"Investment property search in Spain","prompt":"Search Idealista Spain for houses for sale in Madrid and Barcelona — I want up to 50 listings per city, priced between 200000 and 600000 euros, and at least 80 square meters."},{"title":"Bulk listing data for market analysis","prompt":"Pull as many property listings as possible from this Idealista search URL for rentals in Lisbon, Portugal — I need all the prices, sizes, and property types for a market comparison report."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of items, each containing the listing URL, title, price, currency, size in square meters, operation type (sale or rent), property code, and property type. Failed or empty result sets are not billed.","failureModes":["Empty result set if filters are too restrictive — no charge applied","Location not found or no verified route for the given city","Invalid or inaccessible searchUrl causing no results","Rate limiting or blocking by Idealista resulting in empty response","Invalid country enum value causing request rejection"],"whenToPreferThis":"Use this endpoint when you need structured, filterable property listing data from Idealista specifically — covering Spain, Portugal, Italy, or France — and want pay-per-successful-call pricing with built-in filtering by price, size, bedrooms, and operation type without paying for failed runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:46.083Z","isFirstParty":false,"canonicalSlug":"idealista-property-search-scraper-bfe26eef"}