## zoopla/search-sale

`GET /v1/zoopla/search-sale`

Homes for sale in an area: address, title, rooms, price and its label, flag, agent, photos and position; the portal's featured homes beside them.

*Zoopla homes for sale*

| Parameter | Required | Description |
| --- | --- | --- |
| `location` | no | A postcode, town or area name; resolved to the portal's identifier once and remembered (or pass identifier and label) — e.g. `Oxford` |
| `identifier` | no | An area identifier from zoopla/locations — e.g. `oxford` |
| `label` | no | The area's label from zoopla/locations, sent with the identifier — e.g. `Oxford, Oxfordshire` |
| `page` | no | Page number — e.g. `1` |
| `radius` | no | Miles around the area: 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20, 30 or 40 |
| `min_price` | no | Minimum asking price in pounds |
| `max_price` | no | Maximum asking price in pounds |
| `min_bedrooms` | no | Minimum bedrooms |
| `max_bedrooms` | no | Maximum bedrooms |
| `min_bathrooms` | no | Minimum bathrooms |
| `max_bathrooms` | no | Maximum bathrooms |
| `property_type` | no | detached, semi_detached, terraced, flats, bungalow, farms_land, park_home; several separated by commas — e.g. `flats,terraced` |
| `sort` | no | newest, highest_price, lowest_price or most_reduced — e.g. `newest` |
| `keywords` | no | Words the listing must mention |
| `must_have` | no | has_garden, has_parking_garage, has_balcony_terrace and the portal's other must-haves; separated by commas |
| `features` | no | The portal's property-feature codes, separated by commas |
| `added` | no | Only homes added in the last 1, 3, 7, 14 or 30 days |
| `include_sold` | no | Include homes under offer or sold subject to contract — e.g. `false` |
| `new_homes` | no | include, exclude or only |
| `retirement_homes` | no | include, exclude or only |
| `auction` | no | include, exclude or only |
| `shared_ownership` | no | include, exclude or only |
| `show_only` | no | chainFree, reducedPriceOnly; separated by commas |
| `ownership` | no | leasehold, freehold, share_of_freehold; separated by commas |
| `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/zoopla/search-sale" \
  -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
{
  "_warnings": [],
  "channel": "example",
  "count": 0,
  "cursor": null,
  "extended": [],
  "featured": [],
  "has_more": false,
  "items": [
    {
      "address": "example",
      "agent": {
        "id": "example",
        "logo_url": "https://example.com/example",
        "name": "example",
        "phone": "example",
        "url": "https://example.com/example"
      },
      "bathrooms": 0,
      "bedrooms": 0,
      "currency": "example",
      "flag": "example",
      "floor_area": {
        "label": "example",
        "source": "example",
        "units": "example",
        "value": 0
      },
      "floorplan_count": 0,
      "highlights": [],
      "id": "example",
      "image_count": 0,
      "image_url": "https://example.com/example",
      "images": [
        "example"
      ],
      "listed_on": "example",
      "living_rooms": 0,
      "platform": "example",
      "premium": false,
      "price": 0,
      "price_drop": false,
      "price_label": "example",
      "price_qualifier": "example",
      "property_type": "example",
      "short_price": "example",
      "summary": "example",
      "tags": [
        "example"
      ],
      "title": "example",
      "transports": [],
      "type": "example",
      "under_offer": false,
      "url": "https://example.com/example",
      "video_count": 0
    }
  ],
  "location": {
    "identifier": "example",
    "name": "example"
  },
  "page": 0,
  "pages": 0,
  "total": 0
}
```

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