# Bookyogaretreats — 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 and explore yoga retreat listings from BookYogaRetreats.com, including pricing, location, duration, ratings, and guest reviews. Browse paginated listings, retrieve full retreat details, and export results to CSV.

**Category:** Travel | **Website:** [bookyogaretreats.com/](https://bookyogaretreats.com/) | **Docs:** [parse.bot/marketplace/10b1a66a-32f2-4dc6-9280-c31ed6379157/bookyogaretreats-com-api](https://parse.bot/marketplace/10b1a66a-32f2-4dc6-9280-c31ed6379157/bookyogaretreats-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-bookyogaretreats-com-api-10b1a66a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_retreat_detail

Fetch full details of a specific retreat by its URL. Returns comprehensive information including organizer name, instructors, pricing, rating, and amenity flags. The URL must be a full bookyogaretreats.com retreat page URL (obtainable from get_retreat_listings or search_retreats results).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the retreat detail page on bookyogaretreats.com (e.g. from get_retreat_listings or search_retreats results' website field). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bookyogaretreats-com-api-10b1a66a/get_retreat_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_retreat_listings

Fetch paginated retreat listings from the BookYogaRetreats homepage. Returns an array of retreat summaries including pricing, ratings, and availability. Results are ordered by the site's recommended sorting. Each page contains approximately 12 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bookyogaretreats-com-api-10b1a66a/get_retreat_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### scrape_all_retreats_paginated

Crawl retreat listings and fetch full details for each retreat. Iterates through listing pages up to the specified maximum, visiting each retreat's detail page. Returns structured retreat data with an optional CSV export.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `max_pages` | integer | No | Maximum number of listing pages to crawl. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bookyogaretreats-com-api-10b1a66a/scrape_all_retreats_paginated \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_pages":"<integer>"}'
```

### search_retreats

Search for retreats by destination or keyword. Returns paginated retreat listings matching the search query. Searches by destination name (e.g. 'bali', 'spain', 'india') or category (e.g. 'meditation', 'vinyasa yoga'). Each page contains approximately 12 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number to fetch for pagination. |
| `query` | string | Yes | Search keyword — a destination name (e.g. 'bali', 'spain', 'india') or retreat category (e.g. 'meditation', 'vinyasa yoga'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bookyogaretreats-com-api-10b1a66a/search_retreats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```