Spareroom Listings Extractor

Extract room and flatshare listings from SpareRoom search results and turn them into clean, structured data. Give the actor a location or a SpareRoom search URL and it collects every room ad across the results, including price, location, room type, availability, property details, and images. Export the data to JSON, CSV, or Excel for rental market research, price tracking, or lead generation.

What it does

• Pulls listings straight from SpareRoom flatshare search results
• Follows pagination automatically so you can collect hundreds of rooms per run
• Returns one clean record per listing with prices, locations, and images
• Removes duplicates across pages so every room appears once
• Exports to JSON, CSV, Excel, or the Apify API

Input

You can start a search in two ways. Use either one, or both together.

Field	Type	Description
location	string	Town, city, or area to search, for example London or Manchester.
searchUrls	array	One or more full SpareRoom flatshare search URLs. Handy when you already have a saved search with filters applied.
maxItems	integer	Maximum number of listings to collect per run. Default 100, up to 1000.
requestTimeoutSecs	integer	Per-request timeout in seconds. Default 30.

Example input

{
    "location": "London",
    "searchUrls": [
        "https://www.spareroom.co.uk/flatshare/?search_id=1482037460"
    ],
    "maxItems": 100
}

Output

Each listing becomes one record in the dataset.

{
    "listingId": "7814110",
    "listingTitle": "Single En-Suite Rooms in Woodlands",
    "listingUrl": "https://www.spareroom.co.uk/flatshare/flatshare_detail.pl?flatshare_id=7814110",
    "price": "£110",
    "pricePeriod": "pw",
    "billsIncluded": true,
    "location": "Doncaster (DN6)",
    "neighbourhood": "Doncaster",
    "postcode": "DN6",
    "propertyType": "house",
    "roomsInProperty": 5,
    "roomType": "2 singles",
    "availability": "Available now",
    "advertiserRole": "agent",
    "daysListed": 2,
    "status": "new",
    "listingType": "offered",
    "shortDescription": "Company tenancies available, near local amenities and transport links.",
    "photoCount": 9,
    "mainImage": "https://photos2.spareroom.co.uk/images/flatshare/listings/unmodified/30/89/30894640.jpg",
    "profilePhoto": "https://photos2.spareroom.co.uk/images/flatshare/listings/square/10/00/100050221.jpg",
    "sourceUrl": "https://www.spareroom.co.uk/flatshare/?search_id=1482037460",
    "scrapedAt": "2026-08-19T12:00:00+00:00"
}

Output fields

Field	Description
listingId	SpareRoom listing identifier
listingTitle	Advert headline
listingUrl	Link to the full listing page
price / pricePeriod	Advertised rent and its period, such as pw or pcm
normalisedRate / normalisedRatePeriod	Rent normalised by SpareRoom for comparison
billsIncluded	Whether bills are included in the rent
location / neighbourhood / postcode	Where the room is
propertyType / roomsInProperty	Property type and total rooms
roomType	Room offered, such as single, double, or en-suite
availability / availableNow	When the room is free
advertiserRole	Agent or private advertiser
daysListed / status / brand	How long it has been live and its listing status
listingType	Offered or wanted
shortDescription	Snippet from the advert
photoCount / mainImage / profilePhoto	Image count and photo links
sourceUrl / scrapedAt	Search URL and collection timestamp

Common uses

• Track room prices and availability across a city over time
• Build a rental market dataset for a neighbourhood or postcode
• Find new listings from agents or private landlords for outreach
• Feed live room data into a dashboard, spreadsheet, or app

Tips

• Paste a SpareRoom search URL to reuse filters like price, room type, and availability
• Raise maxItems to pull deeper into the results
• Run on a schedule to catch new rooms as they are posted