# LekkeSlaap Cape Town Stays API

> Holiday accommodation in Cape Town from LekkeSlaap: properties, prices and locations.

- Page: https://cleanedweb.com/catalog/lekkeslaap-cape-town-stays-api/
- Contract (JSON): https://cleanedweb.com/catalog/lekkeslaap-cape-town-stays-api/contract.json
- Source: lekkeslaap.co.za (https://www.lekkeslaap.co.za/)
- Category: Real estate
- Updated: 2026-11-21

A run reads until the source ends or your `max_items`, `timeout_seconds` or budget stops it.

## Key fields

| Field | Type | Sample value |
| --- | --- | --- |
| `title` | string | `Bree Street Apartment` |
| `description` | string | `Selfsorg in Kaapstad Middestad, Kaapstad Middestad Kaapstad` |
| `location` | string | `Kaapstad Middestad` |
| `url` | string | `https://www.lekkeslaap.co.za/akkommodasie/bree-street-apartment?uuid=180be6294f9fb099008b589c20b91208` |
| `alt` | string | `Bree Street Apartment.` |
| `badge_display_full` | string | `Blitsaanbod 40% af!` |
| `badges` | array of string | `Blitsaanbod 40% af! 40% af!, Blitsaanbod 40% af!, 40% af!, Blitsaanbod 40% af! …` |
| `cancellation_policy` | string | `Gratis kansellasie tot 24 uur voor jou verblyf!` |

Sample values come from one saved record, not a live run. Every field with its type, and the schemas, are in https://cleanedweb.com/catalog/lekkeslaap-cape-town-stays-api/contract.json. Some fields the source returns are not published, so a record can carry fields the schema does not list.

## Inputs

- `pensioner_specials` (boolean): Filters by pensioner specials.
- `show_unavailable` (boolean): Filters by show unavailable.
- `only_specials` (boolean): Filters by only specials.
- `rewards_partners_only` (boolean): Filters by rewards partners only.
- `as_featured_in_only` (boolean): Filters by as featured in only.
- `instant_booking_only` (boolean): Filters by instant booking only.
- `free_cancellation_only` (boolean): Filters by free cancellation only.
- `unit_type_filter` (boolean): Filters by unit type filter.
- `type_filter` (string \| number): Optional. Filters by type filter. Options: Selfsorg-eenhede (9), Gastehuise (5), B&Bs (2), Lodges (11), Hotelle (4), Rugsakreisigerslosies (6), Kampeer (10), Oorde (13).
- `grading_filter` (string \| number): Optional. Filters by grading filter. Options: Puik (4.5+) (5), Sien alles (0).
- `characteristics_filter` (string \| number): Optional. Filters by characteristics filter. Options: Swembad (76), Braai (110), Gratis veilige parkeerplek (173), Warmbad (163), Rolstoelvriendelik (999), Troeteldiere op versoek (95), WiFi (225), Konferensiegeriewe (52).
- `room_amenities_filter` (string \| number): Optional. Filters by room amenities filter. Options: Braai (110), TV (45), DStv (32), Stroomdienste (42), Kombuis/Kombuisie (GRP001), Yskas (GRP002), Tee-/koffiemasjien (137), Kamerdiens (134), and 11 more in https://cleanedweb.com/catalog/lekkeslaap-cape-town-stays-api/contract.json.
- `sort` (string): Order of the collection, as the site's own sort control offers it; omitted keeps the site's default order. Options: Aanbeveel (recommended), Goedkoopste (price-low), Duurste (price-high), Beste resensies (reviews).

`enrich_records` is on by default and adds the fields that only appear on each record's detail page. Send `false` to read list fields only. See https://cleanedweb.com/docs/run-api/

## Request

`POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_8dd99a351a4e89d6b1734fb5/endpoints/generated_8dd99a351a4e89d6b1734fb5_search/run`

```bash
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_8dd99a351a4e89d6b1734fb5/endpoints/generated_8dd99a351a4e89d6b1734fb5_search/run \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "type_filter": "9"
  },
  "version": 1,
  "max_items": 25
}'
```

Send an `Idempotency-Key` header with every run and save it before you send. Reuse it only to retry the same request. If the run does not end within `wait_seconds`, read the result with the same API key and key:

`GET https://api.cleanedweb.com/v1/catalog/public/apis/generated_8dd99a351a4e89d6b1734fb5/endpoints/generated_8dd99a351a4e89d6b1734fb5_search/result`

## Versions

Current: `1.0`. Pin a major with "version": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.

- v1: current, newest minor `1.0`

### Changelog

- `1.0` (major) 2026-11-20

The same changelog, as data, is in https://cleanedweb.com/catalog/lekkeslaap-cape-town-stays-api/contract.json

## Use it from an AI agent

MCP server: https://api.cleanedweb.com/mcp?profile=catalog (Streamable HTTP). Sign in with a CleanedWeb account when the client asks (OAuth), or send an API key with the `read` and `run` scopes as `Authorization: Bearer`. Call `get_api` with `api_id` `generated_8dd99a351a4e89d6b1734fb5`, then `run_api` with the `run_with` arguments it returns. See https://cleanedweb.com/docs/mcp/

## Run it

Reading the catalog needs no credential. Running needs a CleanedWeb account and an API key with the `run` scope; the first 5,000 records are free, then $1 per 1,000 records. See https://cleanedweb.com/docs/run-catalog-api/

CleanedWeb is not affiliated with Lekkeslaap.
