{"uid":"cap_gD_9meEzLlh_lVq-CgchS","slug":"fotocasa-property-listings-scraper-7476ab98","name":"Fotocasa Property Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/fotocasa?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sortBy":{"enum":["rating","latest","cheapest","mostExpensive","biggest","smallest","cheapestPerM2"],"type":"string","default":"rating","description":"Order returned properties by relevance, freshness, price or area."},"maxSize":{"type":"integer","default":0,"minimum":0,"description":"Maximum floor area in square meters; zero means no maximum."},"minSize":{"type":"integer","default":0,"minimum":0,"description":"Minimum floor area in square meters; zero means no minimum."},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Center latitude for radius search; provide longitude too. Overrides location."},"location":{"type":"string","description":"City, province, district or other public place name. Coordinates take precedence."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many unique properties. Zero collects as many public results as the search exposes."},"maxPrice":{"type":"integer","default":0,"minimum":0,"description":"Maximum listing price in euros; zero means no maximum."},"minPrice":{"type":"integer","default":0,"minimum":0,"description":"Minimum listing price in euros; zero means no minimum."},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Center longitude for radius search; provide latitude too."},"operation":{"enum":["buy","rent","share","rentBuyOption","transfer"],"type":"string","default":"buy","description":"Listing transaction to search."},"distanceKm":{"type":"integer","default":20,"maximum":100,"minimum":1,"description":"Maximum distance from the coordinate center. Used only with latitude and longitude."},"rentalTypes":{"type":"array","items":{"enum":["longTerm","temporary"],"type":"string","enumTitles":["Long term","Temporary"]},"default":[],"description":"For rental searches, choose one duration. Empty or both includes all durations."},"locationType":{"enum":["","country","autonomous_community","province","area","region","municipality","locality","district","neighborhood","urbanization","coast","geographical_area","street","zip_code"],"type":"string","default":"","description":"Choose a suggestion level when a place name is ambiguous. Empty uses the closest exact suggestion."},"propertyType":{"enum":["home","newHome","premises","garages","office","boxRoom","land","building"],"type":"string","default":"home","description":"Category of real estate to search."},"publicationDate":{"enum":["","last48h","lastWeek","lastMonth"],"type":"string","default":"","description":"Only listings published within this period."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"price":null,"rooms":null,"surface":null,"operation":null,"priceDrop":null,"listingUrl":null,"propertyId":null,"pricePerSquareMeter":null}],"product":"fotocasa"}},"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_YK36xp40WFabk1flOK1p5","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 Spanish real estate listings from Fotocasa, filtered by location, price, size, and transaction type.","exampleAgentPrompt":"Search Fotocasa for apartments to buy in Barcelona under 400,000 euros with at least 60 square meters, sorted by cheapest first, and return up to 50 listings.","exampleUseCases":[{"title":"Budget apartment hunt in Madrid","prompt":"Find me apartments for rent long-term in Madrid under 1200 euros a month with at least 50 square meters, sorted by cheapest, and give me up to 30 results from Fotocasa."},{"title":"Investment property comparison by price per m²","prompt":"Search Fotocasa for properties for sale in Valencia province sorted by price per square meter, with a minimum size of 70 square meters and a maximum price of 250,000 euros — I want up to 100 listings."},{"title":"Nearby rentals via GPS coordinate","prompt":"Show me rental properties within 10 km of coordinates 41.3851° N, 2.1734° E on Fotocasa, any price, sorted by rating, up to 50 results."}],"resultDescription":"Returns a JSON object with a count of results and an array of property items, each containing price, number of rooms, surface area in square meters, operation type, price drop indicator, listing URL, property ID, and price per square meter.","failureModes":["Empty result set if no listings match the filters (not charged)","Invalid location string returns no results","Coordinates outside Spain may return empty results","maxItems of zero may return large uncontrolled result sets","Invalid enum values for sortBy or operation cause request rejection","Network or scraping failures return error and are not charged"],"whenToPreferThis":"Use this endpoint when you need structured Spanish real estate data from Fotocasa specifically, with flexible filtering by geography (name or GPS), price, size, and transaction type. Prefer it over generic web search when you need machine-readable property data with consistent fields like price per m², surface area, and listing URLs from Spain's major property portal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:57.443Z","isFirstParty":false,"canonicalSlug":"fotocasa-property-listings-scraper-7476ab98"}