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

> Browse Blue Bottle Coffee's complete product catalog, including roast levels, tasting notes, pricing, and customer reviews. List products by category, retrieve full details for any item, and explore cafe locations across all supported regions.

**Category:** Food & Dining | **Website:** [bluebottlecoffee.com/](https://bluebottlecoffee.com/) | **Docs:** [parse.bot/marketplace/272e5cfc-c8c9-45ec-8b0b-b55f65fefa5a/bluebottlecoffee-com-api](https://parse.bot/marketplace/272e5cfc-c8c9-45ec-8b0b-b55f65fefa5a/bluebottlecoffee-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-bluebottlecoffee-com-api-272e5cfc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed information for a specific product by its slug, including description, roast level, tasting notes, variants with pricing in cents, and metadata. Variants include availability status (for_sale) and SKU identifiers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug identifier |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bluebottlecoffee-com-api-272e5cfc/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_all_products

List all coffee products available in the Blue Bottle Coffee shop. Returns product names, slugs, tasting notes, roast levels, and images. Single-page endpoint returning the complete catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bluebottlecoffee-com-api-272e5cfc/list_all_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_cafes

List all Blue Bottle Coffee cafe locations across US regions including Northern California, Southern California, New York, Las Vegas, Chicago, Boston, and Washington DC. Returns complete address details for each cafe.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bluebottlecoffee-com-api-272e5cfc/list_cafes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_products_by_category

List products within a specific category by its slug. Returns product names, slugs, tasting notes, roast levels, and images for that category. Each category represents a curated collection on the Blue Bottle Coffee site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug. Confirmed working values: best-sellers, brew-tools, espresso, single-origin |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bluebottlecoffee-com-api-272e5cfc/list_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### search_cafes_by_location

Search for Blue Bottle Coffee cafes by location name. Filters the full cafe list by matching the query against cafe name, address, and region fields. If no query is provided, returns all cafes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query to filter cafes by name, address, or region (e.g. San Francisco, Broadway, New York) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-bluebottlecoffee-com-api-272e5cfc/search_cafes_by_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```