{"uid":"cap_CtLOPEZvdZLdo21ZC6-AM","slug":"spareroom-listing-scraper-x402-31573a21","name":"SpareRoom Listing 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/spareroom?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"enum":["auto","UK","US"],"type":"string","default":"auto","description":"Auto treats UK postcode districts as UK and other bare locations as US. Full URLs always determine the country."},"maxItems":{"type":"integer","default":100,"minimum":1,"description":"Maximum number of listings from each start URL or location. Set a smaller limit for a quick sample."},"maxPages":{"type":"integer","default":100,"maximum":100,"minimum":1,"description":"Maximum search-result pages to visit per start URL. SpareRoom exposes at most 100 pages of ten listings for broad searches."},"startUrls":{"type":"array","description":"Public SpareRoom UK or US search and listing URLs, UK postcode districts such as E14, or US cities such as Los Angeles. Use country to interpret bare locations."},"maxTotalItems":{"type":"integer","default":0,"minimum":0,"description":"Optional cap across all start URLs. Zero means use only the per-start limit."},"includeDetails":{"type":"boolean","default":true,"description":"Visit public listing pages for full descriptions, availability, amenities, photos, and location coordinates. Turning this off returns search-card fields only."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"title":null,"adType":null,"summary":null,"location":null,"listingId":null,"description":null,"neighborhood":null}],"product":"spareroom"}},"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_uTmgvnWS24X7QNxzNKHZG","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 room and flatshare listings from SpareRoom UK or US, returning titles, descriptions, locations, amenities, photos, and coordinates for each result.","exampleAgentPrompt":"Search SpareRoom for rooms to rent in the E14 postcode district in the UK — grab up to 50 listings with full details like descriptions, amenities, photos, and coordinates.","exampleUseCases":[{"title":"London flatshare market research","prompt":"Pull all SpareRoom listings in the SW1 and E1 postcode districts for me — I want full details including descriptions, amenities, and prices, up to 100 listings per area, so I can compare the rental market across those neighbourhoods."},{"title":"Relocation room hunting in US city","prompt":"Search SpareRoom for available rooms in Los Angeles — treat it as a US search, get up to 30 listings with full descriptions and location coordinates so I can figure out which neighbourhoods to focus on."},{"title":"Quick sample of current listings","prompt":"Give me a quick sample of 10 SpareRoom listings from this search URL I found — https://www.spareroom.co.uk/flatshare/london/hackney — just the search card fields, no need to visit each listing page individually."}],"resultDescription":"A JSON object containing a count of results and an array of listing items, each with fields including URL, title, ad type, summary, location, listing ID, description, neighborhood, and (when includeDetails is true) full descriptions, availability dates, amenities, photos, and geographic coordinates. The product field identifies this as 'spareroom' data.","failureModes":["SpareRoom blocks or rate-limits the scraper — empty result set returned, no charge","Invalid or inaccessible start URL — empty items array","Postcode district not recognized as UK — may default to US interpretation if country is set to auto","maxPages cap of 100 limits broad searches to at most 1000 listings","SpareRoom changes its page structure — fields may be null or missing","Network timeout on detail page visits when includeDetails is true"],"whenToPreferThis":"Use this endpoint when you need structured SpareRoom listing data for UK or US room rentals, especially when you want to process multiple listings programmatically, analyze rental markets by postcode or city, or build a pipeline that requires amenity, photo, and coordinate data. It is purpose-built for SpareRoom and handles both UK postcode districts and US cities natively, making it far more reliable than a generic web scraper for this specific platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:41.369Z","isFirstParty":false,"canonicalSlug":"spareroom-listing-scraper-x402-31573a21"}