# Campsites — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for UK campsites, view detailed information including amenities and facilities, and check real-time availability across different accommodation types and categories. Plan your camping trip by filtering results to find the perfect site that matches your needs.

**Category:** Travel | **Website:** [campsites.co.uk/](https://campsites.co.uk/) | **Docs:** [parse.bot/marketplace/3a5ef818-5a16-4232-90c2-761eb92570e7/campsites-co-uk-api](https://parse.bot/marketplace/3a5ef818-5a16-4232-90c2-761eb92570e7/campsites-co-uk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_availability

Check daily availability for a campsite and accommodation type for a given month. Returns the year, start month, a comma-separated list of matching pitch IDs, and per-pitch availability data. Each pitch entry contains 'availability' (array of 0/1 per day of month) and 'arrival-days' (array of 0/1 per day indicating valid arrival days).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `accommodation_id` | string | Yes | Accommodation type ID from list_accommodation_types. Numeric string or special values like 'any-provided', 'pod'. |
| `campsite_id` | string | Yes | Campsite ID from search_campsites results[*].id or get_campsite_details id field. |
| `month` | integer | Yes | Month number, 1 through 12. |
| `year` | integer | Yes | Year to check availability for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/check_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"accommodation_id":"<string>","campsite_id":"<string>","month":"<integer>","year":"<integer>"}'
```

### get_campsite_details

Get full details for a specific campsite including description, address, coordinates, facilities, features, pitches, reviews, FAQs, images, and pricing. The slug is the URL path from search_campsites results (e.g. '/search/campsites-in-cornwall/par/east-crinnis-holiday-park'). Returns a single campsite with all available metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Campsite URL path from search_campsites results[*].url, e.g. '/search/campsites-in-cornwall/par/east-crinnis-holiday-park'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/get_campsite_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_accommodation_types

List all accommodation types grouped by category (Tent, Caravan, Glamping, CampervanorMotorhome). Each entry has a value (ID string for use in availability checks) and a label (display name). This is a reference endpoint for discovering valid accommodation_id values.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/list_accommodation_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_categories

List popular destinations, glamping types, featured searches, and featured accommodation from the homepage. Primary use is discovering valid location slugs for search_campsites via popular_destinations[*].URL. Each destination includes park counts by type.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/list_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_campsites

Search for campsites by location with optional date and guest filters. Returns paginated summaries ordered by rating. The location must match the site's URL slug pattern (e.g. 'cornwall', 'devon', 'the-lake-district'). Paginates via integer page counter; page_count in the response indicates total pages available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `adults` | integer | No | Number of adults. |
| `arrival` | string | No | Arrival date in YYYY-MM-DD format. |
| `children` | integer | No | Number of children. |
| `location` | string | Yes | Location slug matching the site's URL pattern. Confirmed working values include 'cornwall', 'devon', 'the-lake-district', 'dorset'. Multi-word locations require hyphens and may need articles (e.g. 'the-lake-district' not 'lake-district'). Discover valid slugs from list_categories popular_destinations[*].URL. |
| `nights` | integer | No | Number of nights for the stay. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-campsites-co-uk-api-3a5ef818/search_campsites \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"adults":"<integer>","arrival":"<string>","children":"<integer>","location":"<string>","nights":"<integer>","page":"<integer>"}'
```