{"uid":"cap_5w9mVX_tgP1D62licZYag","slug":"fotocasa-spain-property-listings-scraper-3bd9ee27","name":"Fotocasa Spain Property Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_MxWu_fvQLiMezfKIVb_wS","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 real estate listing data from Fotocasa (Spanish property portal) by location, price, size, and operation type","exampleAgentPrompt":"Search Fotocasa for apartments to buy in Barcelona, sorted by cheapest first, priced between 150,000 and 400,000 euros, with at least 50 square meters, and return up to 50 listings.","exampleUseCases":[{"title":"Budget apartment hunting in Madrid","prompt":"Find me the cheapest apartments for rent in Madrid on Fotocasa, long-term only, under 1,200 euros per month and at least 40 square meters — give me up to 30 results sorted by cheapest first."},{"title":"Investment property search near coordinates","prompt":"I'm looking for properties to buy within 10 km of latitude 41.3851, longitude 2.1734 in Spain — sort them by price per square meter and give me up to 50 results, max price 500,000 euros."},{"title":"Large home search for family relocation","prompt":"Find the biggest houses available to buy in Seville on Fotocasa, at least 120 square meters, no maximum price, sorted by biggest first, and return up to 25 listings."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of property items, each containing property ID, listing URL, price in euros, number of rooms, surface area in square meters, operation type, price per square meter, and a price drop indicator.","failureModes":["Empty result set if the location name is unrecognized or misspelled — no charge applied","Zero results returned if price/size filters are too restrictive for the given area","Partial results if maxItems is set low or the portal exposes fewer listings than requested","Invalid enum value for sortBy or operation causes request rejection","Coordinates outside Spain may return no results since Fotocasa is a Spanish portal"],"whenToPreferThis":"Use this endpoint when you need structured property listing data from the Spanish real estate market specifically sourced from Fotocasa, and you want flexible filtering by location (name or GPS coordinates), price range, size, and transaction type. Prefer this over generic web scraping when you need clean, structured output fields like price per square meter and price drops without parsing raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:53.799Z","isFirstParty":false,"canonicalSlug":"fotocasa-spain-property-listings-scraper-3bd9ee27"}