# SpareRoom Listing

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.

- **Documentation:** [https://scrappa.co/docs/spareroom-api/spareroom_listing](https://scrappa.co/docs/spareroom-api/spareroom_listing)
- **API group:** SpareRoom API
- **Endpoint:** `GET https://scrappa.co/api/spareroom/listing`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | SpareRoom ad id from the search endpoint, for example 18181176. |
| `ad_type` | string | No | offered (default) or wanted. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A parameter is missing or invalid. This response is not billable. |  |
|  | The ad, place or city does not exist. This response is not billable. |  |
|  | The upstream is unavailable, refused the request or answered in an unexpected shape. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)