---
title: "GET /spareroom/search"
method: GET
path: "/spareroom/search"
tags: ["SpareRoom"]
---

# GET /spareroom/search

`GET /spareroom/search`

## Request

- Base URL: `https://scrappa.co/api`
- URL: `https://scrappa.co/api/spareroom/search`
- Auth: API key in header `X-API-KEY`

## Query parameters

- `where` string, required
- `page` integer
- `sort` 'relevance' | 'newest' | 'last_updated' | 'price_low_to_high' | 'price_high_to_low'
- `min_rent` integer
- `max_rent` integer
- `rent_period` 'pcm' | 'pw'
- `bills_included` 'true' | 'false' | '1' | '0'
- `available_from` string, date
- `types` string
- `room_types` 'double' | 'single'
- `ensuite` 'Y'
- `furnished` 'Y' | 'N'
- `rooms_for` 'males' | 'females' | 'couples'
- `share_type` 'P' | 'S'
- `genderfilter` 'males' | 'females' | 'mixed'
- `gayshare` 'Y'
- `vegetarians` 'Y'
- `disabled_access` 'Y'
- `living_room` 'shared'
- `parking` 'Y'
- `smoking` 'Y' | 'N'
- `pets_req` 'Y'
- `days_of_wk_available` 'Mon to Fri only' | '7 days a week'
- `short_lets_considered` 'Y'
- `posted_by` 'private_landlords' | 'flatmates' | 'agents' | 'co_live'
- `landlord` 'live_in' | 'live_out'
- `photoadsonly` 'Y'
- `free_to_contact` 'Y'
- `no_deposit` 'Y'
- `verified_users` 'Y'
- `min_term` integer
- `max_term` integer
- `no_of_rooms` integer
- `min_age_req` integer
- `max_age_req` integer
- `min_beds` integer
- `max_beds` integer

## Response `200`

- string

## Other responses

- `401`: Unauthorized - API key is missing or invalid
- `404`: Error response
- `422`: Error response
- `503`: Error response

## Changes

- **2026-10-20** `bd13167f3f89`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/changes/spareroom/search/get.md)

---

[API](https://skmtc.dev/scrappa/apis/scrappa-api-documentation.md) · [All operations](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/scrappa/apis/scrappa-api-documentation/revisions/1e1aa78ff103?raw)