Open one SpareRoom ad by its id from the search endpoint. The answer holds the full description, rent per room, deposit, bills, availability and term limits, amenities, household preferences, parking and broadband, location with coordinates and nearest station, the photo gallery with five sizes per photo and the advertiser response rate. Photo URLs are returned exactly as published. Ads of type wanted are available by id with ad_type=wanted. An unknown id returns a 404 that is not billed. Phone numbers and surnames are never returned.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
1 optional filter available.
string
Required
SpareRoom ad id from the search endpoint, for example 18181176.
1234567890
string
Optional
offered (default) or wanted.
example
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A parameter is missing or invalid. This response is not billable.
HTTP 404
The ad, place or city does not exist. This response is not billable.
HTTP 503
The upstream is unavailable, refused the request or answered in an unexpected shape. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.