{"uid":"cap_pMoc3yMcA-AAFZqQVXI31","slug":"spareroom-listings-scraper-c0f5d741","name":"SpareRoom Listings Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_8vmmrpr9BZbqx9e4LVoSP","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 flatmate listings from SpareRoom UK and US, returning details such as title, location, description, neighborhood, and listing ID.","exampleAgentPrompt":"Pull up to 50 SpareRoom listings in the E14 postcode district in the UK, including full descriptions, amenities, and location coordinates.","exampleUseCases":[{"title":"Relocation room search by postcode","prompt":"I'm moving to London next month — can you grab me the latest SpareRoom listings in the SW1 postcode district, up to 30 results, with full details like descriptions and photos?"},{"title":"Rental market research for US city","prompt":"I need to analyze the rental room market in Los Angeles — please scrape up to 100 SpareRoom US listings for Los Angeles with all available details included."},{"title":"Quick sample of available rooms","prompt":"Can you give me a quick sample of about 10 SpareRoom listings for Manchester — just the search card fields, no need to visit individual listing pages?"}],"resultDescription":"A JSON object containing a count of listings and an array of items, each with fields such as URL, title, ad type, summary, location, listing ID, description, and neighborhood. When includeDetails is true, additional fields like full description, availability, amenities, photos, and GPS coordinates are included.","failureModes":["Empty result set if SpareRoom has no listings for the given location or URL — call is not charged","Invalid or non-SpareRoom URLs return an error or empty items array","Exceeding 100 pages per start URL silently caps at 100 pages","Country auto-detection may misclassify ambiguous location strings — use the country parameter explicitly to avoid this","SpareRoom may throttle or block scraping, resulting in partial results"],"whenToPreferThis":"Use this endpoint when you need structured room or flatmate listing data from SpareRoom (UK or US) without building and maintaining your own scraper. It is especially useful for relocation assistants, rental market analysis tools, or agents helping users find shared accommodation, and it charges only on successful non-empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T18:34:22.011Z","isFirstParty":false,"canonicalSlug":"spareroom-listings-scraper-c0f5d741"}