# Exploretock — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-exploretock-com-api-2abf0246/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-exploretock-com-api-2abf0246/get_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-exploretock-com-api-2abf0246/get_venue_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-exploretock-com-api-2abf0246/search_venues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","query":"<string>"}'
```