# Burning Man — 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.

> Access comprehensive Burning Man information including Black Rock City event schedules, ticketing details, themed activities, playa events, volunteering opportunities, and mutant vehicle listings. Search global Burning Man events, stay updated with news and stories, and find preparation resources all in one place.

**Category:** Entertainment | **Website:** [burningman.org/](https://burningman.org/) | **Docs:** [parse.bot/marketplace/2738377f-b6af-4a77-9efc-d7532bb448be/burningman-org-api](https://parse.bot/marketplace/2738377f-b6af-4a77-9efc-d7532bb448be/burningman-org-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/burning-man/`
**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 brc event info

Retrieve main Black Rock City annual festival information including dates, theme, and general description from the official BRC page. Returns the page title, canonical URL, a text summary (truncated to 1000 characters), and the full HTML content.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-brc-event-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get brc theme

Retrieve the annual Black Rock City theme details including the philosophical meaning and creative direction for the current year. Attempts to find a dedicated theme page; falls back to the general 'about-the-theme' page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-brc-theme \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get global event detail

Get full detail for a specific Burning Man global event by its WordPress post ID. Returns the complete event object including metadata (dates, timezone, venue, organizer), content HTML, and taxonomy tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric event ID from search_global_events results[*].id. |

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

### Get mutant vehicles info

Retrieve information about Mutant Vehicles (art cars) and the Department of Mutant Vehicles, including how to volunteer and the application process.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-mutant-vehicles-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get news and stories

Fetch recent news articles and stories from the Burning Man Journal. Returns paginated post summaries including ID, title, publication date, link, and HTML excerpt.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-news-and-stories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### Get playa events

Retrieve detailed Black Rock City event schedules, camp listings, or art installations for a specific year from the BRC archive. Supports pagination via offset and limit. Structure of result items varies by data_type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `data_type` | string | No | Type of data to retrieve. |
| `limit` | integer | No | Maximum number of results to return. |
| `offset` | integer | No | Offset for pagination into the result set. |
| `year` | string | No | Year to fetch (e.g. '2024', '2023'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-playa-events \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"data_type":"<string>","limit":"<integer>","offset":"<integer>","year":"<string>"}'
```

### Get ticketing information

Retrieve ticket sale information from the burningman.org ticketing page, including sale program names and their descriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-ticketing-information \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get upcoming important dates

Scrape upcoming important dates and planning sessions from the BRC 2026 page. Returns each event item with its date, category, title, and description as a single text entry.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-upcoming-important-dates \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get volunteering info

Retrieve volunteering information from the Burning Man volunteering page, including how to volunteer, FAQ, and department listings.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/get-volunteering-info \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search global events

Search global Burning Man events with optional keyword. Returns paginated results from the WordPress events API with event ID, title, date, link, and description snippet. Pagination is via page number; total count is from the X-WP-Total response header.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page (max 100). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to filter events. |

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

### Search site

Search the full Burning Man Project website via the WordPress search API. Returns up to 10 results per query including post/page ID, title, canonical URL, post type, and subtype.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query string (supports multi-word phrases). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/burning-man/search-site \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.