{"description":"Searches SpareRoom, the UK flatshare site, like its room search: rooms offered in a town or London area with headline rent and period (pcm or pw), area and postcode district, property type, rooms in the property, whether available now, how old the ad is, landlord, agent or flatmate advertiser, photo and link. Filters: rent range, sort. Paid featured ads are kept and marked.","effect":"read","id":"spareroom.co.uk/search-rooms","keywords":["spareroom","flatshare","room to rent","houseshare","flatmate","rent","london","manchester","uk","rooms","lodger"],"output":{"schema":{"properties":{"location":{"type":"string"},"page":{"type":"integer"},"rooms":{"items":{"properties":{"advertiser":{"description":"live in landlord, live out landlord, agent, current flatmate, …","type":["string","null"]},"area":{"type":["string","null"]},"available_now":{"type":"boolean"},"days_old":{"type":["integer","null"]},"id":{"type":"string"},"period":{"description":"pcm or pw","type":["string","null"]},"photo":{"type":["string","null"]},"postcode_district":{"type":["string","null"]},"promoted":{"description":"Paid featured ad","type":"boolean"},"property_type":{"type":["string","null"]},"rent_gbp":{"description":"Headline rent as advertised","type":["number","null"]},"rooms_in_property":{"type":["integer","null"]},"title":{"type":["string","null"]},"url":{"type":"string"}},"type":"object"},"type":"array"}},"required":["location","rooms"],"type":"object"},"value":"{location: params.location, page: params.page || `1`, rooms: steps.search[0].rooms[?id != `null`].{id: id, title: title || `null`, rent_gbp: rate && to_number(replace(replace(rate, '£', ''), ',', '')) || `null`, period: period || `null`, area: area || `null`, postcode_district: postcode || `null`, property_type: property_type || `null`, rooms_in_property: rooms_in_property && to_number(rooms_in_property) || `null`, available_now: available_now == '1', days_old: days_old && to_number(days_old) || (days_old == '0' && `0`) || `null`, advertiser: advertiser || `null`, promoted: brand == 'featured' || brand == 'bold', photo: photo || `null`, url: join('', ['https://www.spareroom.co.uk/flatshare/flatshare_detail.pl?flatshare_id=', id])}}"},"params":{"additionalProperties":false,"properties":{"location":{"description":"Town or London area as SpareRoom names it, e.g. 'london', 'manchester', 'bristol', 'hackney'","maxLength":60,"minLength":2,"type":"string"},"max_rent":{"description":"GBP per month","minimum":0,"type":"integer"},"min_rent":{"description":"GBP per month","minimum":0,"type":"integer"},"page":{"default":1,"maximum":20,"minimum":1,"type":"integer"},"sort":{"default":"default","description":"price_low also surfaces placeholder ads at £1–£2, as the site does","enum":["default","newest","price_low","price_high"],"type":"string"}},"required":["location"],"type":"object"},"provenance":{"method":"browser-inspect","notes":"GET /flatshare/<location>?flatshare_type=offered&min_rent&max_rent&per=pcm&sort_by (days_since_placed, price_low_to_high, price_high_to_low)&offset (10 per page): server-rendered li.listing-result with data-listing-* attributes (id, title, brand featured/bold = paid upgrade of a genuine ad, days-old, available-now, neighbourhood, postcode, property-type, rooms-in-property, advertiser-role, ad-headline-rate '£945', period pcm/pw, profile photo). Links use the canonical flatshare_detail.pl?flatshare_id=… page, not the click-tracking fad_click.pl link (robots.txt disallows URLs with search_id). robots.txt has no AI-agent rules. Answers servers.","recorded_at":"2026-11-07T22:34:00+01:00","recorded_by":"C4"},"requires_login":false,"schema":"https://wield.run/schema/recipe/v1.json","site":{"country":"GB","id":"spareroom.co.uk","language":"en","name":"SpareRoom","origin":"https://www.spareroom.co.uk","origins":["https://www.spareroom.co.uk"]},"steps":[{"description":"The room search list page (server-rendered; each result carries its data in data-listing-* attributes). The one-item foreach maps sort and page.","expect":{"content_type":"html","status":[200]},"extract":{"html_items":{"rooms":{"fields":{"advertiser":{"attr":"data-listing-advertiser-role","selector":":scope"},"area":{"attr":"data-listing-neighbourhood","selector":":scope"},"available_now":{"attr":"data-listing-available-now","selector":":scope"},"brand":{"attr":"data-listing-brand","selector":":scope"},"days_old":{"attr":"data-listing-days-old","selector":":scope"},"id":{"attr":"data-listing-id","selector":":scope"},"period":{"attr":"data-listing-ad-headline-rate-period","selector":":scope"},"photo":{"attr":"data-listing-ad-profile-photo","selector":":scope"},"postcode":{"attr":"data-listing-postcode","selector":":scope"},"property_type":{"attr":"data-listing-property-type","selector":":scope"},"rate":{"attr":"data-listing-ad-headline-rate","selector":":scope"},"rooms_in_property":{"attr":"data-listing-rooms-in-property","selector":":scope"},"title":{"attr":"data-listing-title","selector":":scope"}},"max":30,"selector":"li.listing-result[data-listing-id]"}}},"foreach":{"as":"f","in":"[{loc: replace(lower(trim(params.location)), ' ', '_'), sort: (params.sort == 'newest' && 'days_since_placed') || (params.sort == 'price_low' && 'price_low_to_high') || (params.sort == 'price_high' && 'price_high_to_low') || `null`, offset: (params.page || `1`) > `1` && to_string(((params.page || `1`) - `1`) * `10`) || `null`, per: (params.min_rent || params.max_rent) && 'pcm' || `null`}]","max":1},"id":"search","request":{"headers":{"Accept":"text/html"},"method":"GET","query":{"flatshare_type":"offered","max_rent":"{{params.max_rent}}","min_rent":"{{params.min_rent}}","offset":"{{f.offset}}","per":"{{f.per}}","sort_by":"{{f.sort}}"},"url":"/flatshare/{{f.loc | urlencode}}"}}],"task":"Search SpareRoom for rooms to rent in UK flatshares","tos":{"notes":"One search page per call, the same page a visitor sees; no messages to advertisers, no account.","reviewed":false},"verify":{"checks":["length(output.rooms) > `5`","length(output.rooms[?rent_gbp > `0`]) > `5`","length(output.rooms[?postcode_district != `null`]) > `5`","length(output.rooms[?starts_with(url, 'https://www.spareroom.co.uk/flatshare/flatshare_detail.pl?flatshare_id=')]) == length(output.rooms)"],"example_params":{"location":"london","max_rent":1200},"max_ms":5000},"version":1}