Search SpareRoom for rooms to rent in UK flatshares.

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.

No reports yetRead-only, no login

Site: SpareRoom, United Kingdom
Version: v1
Runs, last 7 days: No reports yet
sha256: 4a26021b3b74…

Run it with your agent

after installing Wield

Ask in plain words. Your agent finds this recipe and calls it:

“Search SpareRoom for rooms to rent in UK flatshares.”

Read-only: it changes nothing on the site. No login needed.

{
  "tool": "run",
  "arguments": {
    "recipe_id": "spareroom.co.uk/search-rooms",
    "params": {
      "location": "london",
      "max_rent": 1200
    }
  }
}

Requests

sent from your browser, in order

1GET/flatshare/{{f.loc | urlencode}}?flatshare_type&max_rent&min_rent&offset&per&sort_byThe room search list page (server-rendered; each result carries its data in data-listing-* attributes). The one-item foreach maps sort and page.repeats, max 1

Parameters

from your agent

locationstringrequiredTown or London area as SpareRoom names it, e.g. 'london', 'manchester', 'bristol', 'hackney'

max_rentintegerGBP per month

min_rentintegerGBP per month

pageinteger = 1

sortenumprice_low also surfaces placeholder ads at £1–£2, as the site does "default" | "newest" | "price_low" | "price_high" = "default"

Returns

to your agent

locationstring

pageinteger

roomsobject[]advertiser, area, available_now, days_old, id, period, photo, postcode_district, promoted, property_type, rent_gbp, rooms_in_property, title, url

Where it can send

www.spareroom.co.uk

Anything else is blocked by the extension.

Reads from your session

Nothing. Your browser attaches the site's cookies by itself.

Used only in requests to the addresses on the left. Never sent to wield.run or your agent.

Checks

a run passes when

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)

Raw recipe

Served as canonical JSON from /api/v1/recipes/spareroom.co.uk/search-rooms, so its sha256 matches the ETag and the index.

Check it yourself

curl -s https://wield.run/api/v1/recipes/spareroom.co.uk/search-rooms | shasum -a 256
# 4a26021b3b7436068f027d456b40f38b32937b55cab6bb42e5eefa9ffa81e368

spareroom.co.uk/search-rooms.json, v1

{
  "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
}