## rightmove/search-rent

`GET /v1/rightmove/search-rent`

Homes to rent in an area: address, type, bedrooms, monthly rent and its labels, agent, photos, position and when it was listed; the portal's featured homes beside them.

*Rightmove homes to rent*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | no | A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier) — e.g. `Manchester` |
| `identifier` | no | An area identifier from rightmove/locations — e.g. `REGION^87490` |
| `page` | no | Page number — e.g. `1` |
| `limit` | no | Results per page, 1 to 100 — e.g. `25` |
| `radius` | no | Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 — e.g. `1` |
| `min_price` | no | Minimum monthly rent in pounds |
| `max_price` | no | Maximum monthly rent in pounds |
| `min_bedrooms` | no | Minimum bedrooms |
| `max_bedrooms` | no | Maximum bedrooms |
| `property_type` | no | detached, semi-detached, terraced, flat, bungalow; several separated by commas — e.g. `flat` |
| `sort` | no | newest, oldest, highest_price or lowest_price — e.g. `newest` |
| `keywords` | no | Words to prioritise, separated by commas |
| `must_have` | no | garden, parking, houseShare, retirement, student; separated by commas |
| `dont_show` | no | houseShare, retirement, student; separated by commas |
| `furnished` | no | furnished, partFurnished, unfurnished; separated by commas |
| `let_type` | no | longTerm or shortTerm |
| `include_let_agreed` | no | Include homes already let agreed — e.g. `false` |
| `added` | no | Only homes added in the last 1, 3, 7 or 14 days |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. — e.g. `1` |

**Cost:** 3 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/rightmove/search-rent" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "channel": "example",
  "count": 0,
  "cursor": null,
  "featured": [
    {
      "address": "example",
      "agent": {
        "branch": "example",
        "development": false,
        "id": "example",
        "logo_url": "https://example.com/example",
        "name": "example",
        "phone": "example"
      },
      "bedrooms": 0,
      "build_to_rent": false,
      "development": false,
      "featured": false,
      "floorplan_count": 0,
      "has_video": false,
      "id": "example",
      "image_url": "https://example.com/example",
      "images": [
        "example"
      ],
      "keywords": [],
      "latitude": 0,
      "listed_at": "2026-09-01T12:00:00Z",
      "listing_update": "2026-09-01T12:00:00Z",
      "longitude": 0,
      "monthly_rent": 0,
      "online_viewing": false,
      "photo_count": 0,
      "platform": "example",
      "premium": false,
      "price": 0,
      "price_label": "example",
      "price_labels": [
        "example"
      ],
      "property_type": "example",
      "sticker": "example",
      "summary": "example",
      "type": "example",
      "update_reason": "2026-09-01T12:00:00Z",
      "updated_at": "2026-09-01T12:00:00Z",
      "url": "https://example.com/example"
    }
  ],
  "has_more": false,
  "items": [
    {
      "address": "example",
      "agent": {
        "branch": "example",
        "development": false,
        "id": "example",
        "logo_url": "https://example.com/example",
        "name": "example",
        "phone": "example"
      },
      "bedrooms": 0,
      "build_to_rent": false,
      "development": false,
      "featured": false,
      "floorplan_count": 0,
      "has_video": false,
      "id": "example",
      "image_url": "https://example.com/example",
      "images": [
        "example"
      ],
      "keywords": [],
      "latitude": 0,
      "listed_at": "2026-09-01T12:00:00Z",
      "listing_update": "2026-09-01T12:00:00Z",
      "longitude": 0,
      "monthly_rent": 0,
      "online_viewing": false,
      "photo_count": 0,
      "platform": "example",
      "premium": false,
      "price": 0,
      "price_label": "example",
      "price_labels": [
        "example"
      ],
      "property_type": "example",
      "sticker": "example",
      "summary": "example",
      "type": "example",
      "update_reason": "2026-09-01T12:00:00Z",
      "updated_at": "2026-09-01T12:00:00Z",
      "url": "https://example.com/example"
    }
  ],
  "location": {
    "identifier": "example",
    "latitude": 0,
    "longitude": 0,
    "name": "example"
  },
  "page": 0,
  "radius_miles": 0,
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/rightmove/search-rent#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/rightmove/search-rent.json)
