# Exploretock — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 restaurants and dining experiences on Tock, then view detailed venue information, menus, and real-time availability including specific dates, time slots, and prix-fixe pricing to book your reservation. Get comprehensive restaurant details with all offerings to help you find and reserve your perfect dining experience.

**Category:** Food & Dining | **Website:** [www.exploretock.com/](https://www.exploretock.com/) | **Docs:** [parse.bot/marketplace/2abf0246-0860-47be-b1f9-b759e88a6c2a/exploretock-com-api](https://parse.bot/marketplace/2abf0246-0860-47be-b1f9-b759e88a6c2a/exploretock-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/exploretock/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get availability

Check reservation availability for a venue on a specific date. Returns all bookable dates in the venue's window and time slots for the requested date filtered by party size, including experience name, time, price, and seat count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date to check availability for, in ISO format YYYY-MM-DD. |
| `party_size` | integer | No | Number of guests in the party. Slots are filtered to those accepting this party size. |
| `slug` | string | Yes | Venue slug/domain name from search_venues results (e.g. 'alinea', 'tfl'). |
| `time` | string | No | Preferred time in HH:MM 24-hour format. Used as a hint for the search window. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/exploretock/get-availability \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","party_size":"<integer>","slug":"<string>","time":"<string>"}'
```

### Get venue details

Get venue details and its dining experiences/offerings. Returns experience names, types, prices, party size ranges, and the venue booking URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Venue slug/domain name from search_venues results (e.g. 'alinea', 'tfl'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/exploretock/get-venue-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Search venues

Search for restaurants and experiences by name. Results include venue name, slug, city, state, neighborhood, and booking URL. The slug from results is used to navigate to venue details and availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | Optional city name to filter results (e.g. 'Chicago'). Case-insensitive substring match. |
| `query` | string | Yes | Search query matching venue or experience name (e.g. 'Alinea', 'french laundry'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/exploretock/search-venues \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.