# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/bluebottlecoffee/`
**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 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/credits/bluebottlecoffee/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bluebottlecoffee/list-all-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bluebottlecoffee/list-cafes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bluebottlecoffee/list-products-by-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/bluebottlecoffee/search-cafes-by-location \
  -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://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.