# Nationaltrust — 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.

> Access data from nationaltrust.org.uk.

**Category:** Travel | **Website:** [www.nationaltrust.org.uk/visit](https://www.nationaltrust.org.uk/visit) | **Docs:** [parse.bot/marketplace/10592b38-2da6-4246-87e6-d533441331c4/nationaltrust-org-uk-api](https://parse.bot/marketplace/10592b38-2da6-4246-87e6-d533441331c4/nationaltrust-org-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-nationaltrust-org-uk-api-10592b38/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_place_details

Retrieve full details for a National Trust place including opening times (with per-asset hours for each date), facilities available on site, and accessibility features. The place_path is obtained from search_places results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `place_path` | string | Yes | URL path of the place (e.g. '/visit/london/ham-house-and-garden'). Obtained from search_places results as website_url_path. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nationaltrust-org-uk-api-10592b38/get_place_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"place_path":"<string>"}'
```

### search_places

Search for National Trust places near geographic coordinates. Returns places sorted by distance from the given point within a configurable radius. Each result includes basic info and a website_url_path for use with the get_place_details endpoint. When latitude and longitude are provided, results are proximity-sorted; when only location text is provided, results match by name.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | string | No | Latitude of the search centre point as a decimal string (e.g. '51.5072178'). |
| `limit` | integer | No | Maximum number of places to return. |
| `location` | string | No | Location name or search text (e.g. 'London', 'Bath'). Used as a query label when coordinates are provided, or as a name-match filter when used alone. |
| `longitude` | string | No | Longitude of the search centre point as a decimal string (e.g. '-0.1275862'). |
| `miles_radius` | integer | No | Search radius in miles from the centre point. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nationaltrust-org-uk-api-10592b38/search_places \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<string>","limit":"<integer>","location":"<string>","longitude":"<string>","miles_radius":"<integer>"}'
```