{"uid":"cap_FPLxWqAnzKUi7bNH_fcZa","slug":"habitaclia-real-estate-listings-scraper-b1ac90a8","name":"Habitaclia Real Estate Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/habitaclia?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["relevance","price_asc","price_desc","newest","price_drop"],"type":"string","default":"relevance","description":"Ordering used by the site for search results."},"keyword":{"type":"string","description":"Keep listings whose title or description contains this text, without accent sensitivity."},"maxArea":{"type":"integer","minimum":0,"description":"Keep listings with at most this built area in square metres."},"minArea":{"type":"integer","minimum":0,"description":"Keep listings with at least this built area in square metres."},"location":{"type":"string","default":"barcelona","description":"Province capital or province name. For districts or other towns, paste a search URL."},"maxPages":{"type":"integer","default":20,"minimum":1,"description":"Read at most this many search pages per URL. Each page has about 30 listings."},"maxPrice":{"type":"integer","minimum":0,"description":"Keep listings priced at or below this amount in EUR."},"maxRooms":{"type":"integer","minimum":0,"description":"Keep listings with at most this many rooms."},"minPrice":{"type":"integer","minimum":0,"description":"Keep listings priced at or above this amount in EUR."},"minRooms":{"type":"integer","minimum":0,"description":"Keep listings with at least this many rooms."},"startUrls":{"type":"array","description":"Optional current search URLs or newer individual listing URLs. Overrides transaction, property type and location."},"maxListings":{"type":"integer","default":200,"minimum":1,"description":"Stop after this many dataset items across all URLs."},"propertyType":{"enum":["any","apartment","house","attic","office","commercial","land","parking"],"type":"string","default":"any","description":"Choose a listing category on the search page."},"advertiserType":{"enum":["all","agency","private"],"type":"string","default":"all","description":"Filter by agency or private listing when identified by the page."},"transactionType":{"enum":["sale","rent"],"type":"string","default":"sale","description":"Choose properties for sale or rent."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"adId":null,"title":null,"detailUrl":null,"description":null,"propertyType":null,"realEstateAdId":null,"propertySubtype":null,"transactionType":null}],"product":"habitaclia"}},"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_-Ora5k_j1FHoSWS7LCXqE","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 Habitaclia, a Spanish real estate portal, filtered by location, price, size, rooms, and property type.","exampleAgentPrompt":"Search Habitaclia for apartments for rent in Barcelona, up to 1200 EUR per month, at least 50 square metres and 2 rooms, sorted by price ascending — give me up to 100 listings.","exampleUseCases":[{"title":"Apartment hunting in Barcelona on a budget","prompt":"Search Habitaclia for rental apartments in Barcelona priced between 800 and 1400 EUR, at least 2 rooms and 50 square metres, sorted by price ascending — I want the first 50 results."},{"title":"Investor scouting for commercial property","prompt":"Find commercial properties for sale on Habitaclia in Madrid, no more than 500,000 EUR, sorted by newest — pull up to 60 listings so I can compare options."},{"title":"Relocation research for family house","prompt":"Look up houses for sale on Habitaclia in Valencia with at least 3 rooms and 80 square metres, listed by private owners only, sorted by relevance — give me up to 80 listings."}],"resultDescription":"Returns a JSON object with a count of matched listings and an array of items, each containing the ad ID, title, detail URL, description, property type, property subtype, transaction type, and real estate ad ID as found on Habitaclia.","failureModes":["Empty result set if location name is misspelled or unsupported — no charge in this case","Truncated results if maxListings or maxPages is set too low","startUrls override ignored if malformed or expired Habitaclia search URLs are provided","Rate limiting or scraping blocks from Habitaclia may cause partial or failed runs — not charged","Unknown enum values for propertyType, transactionType, or sort return validation errors"],"whenToPreferThis":"Use this endpoint when you need structured property listing data specifically from Habitaclia, the Spanish-language real estate portal popular in Spain and Catalonia. Prefer it over generic web scrapers when you need pre-filtered, ready-to-use listing records with price, area, and room filters applied server-side. It is ideal for agents automating property research, market analysis, or relocation assistance in Spain without needing to parse raw HTML.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:52.607Z","isFirstParty":false,"canonicalSlug":"habitaclia-real-estate-listings-scraper-b1ac90a8"}