# Blue Apron — 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 browse Blue Apron recipes, menus, and cookbooks to discover meal ideas and get detailed recipe information. Access the complete recipe catalog through sitemaps and detailed recipe listings with ingredients and instructions.

**Category:** Food & Dining | **Website:** [blueapron.com/](https://blueapron.com/) | **Docs:** [parse.bot/marketplace/68b41092-3e30-49bd-8d0b-38ca2ff164fd/blueapron-com-api](https://parse.bot/marketplace/68b41092-3e30-49bd-8d0b-38ca2ff164fd/blueapron-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/blue-apron/`
**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 cookbook listing

Returns the full list of recipes from the Blue Apron cookbook. Contains hundreds of recipes with basic metadata. Use get_recipe_detail with a recipe's slug for full ingredients and instructions. The listing is single-page (no pagination required).

**Estimated cost:** Metered

_No parameters required._

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

### Get menu

Returns the current week's available meal offerings from Blue Apron, grouped by category (Meal Kits, Dish by Blue Apron, Assemble & Bake, etc.). Results change weekly as new meals rotate in. Each item includes basic metadata; use get_recipe_detail with the slug for full instructions.

**Estimated cost:** Metered

_No parameters required._

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

### Get recipe detail

Fetches detailed information for a specific recipe including ingredients, step-by-step cooking instructions, nutrition facts (calories, protein, fiber), and images. Requires the recipe slug; optionally accepts recipe_type for URL construction. Returns null price_per_serving for recipes not currently on the menu.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `recipe_type` | string | No | The category/type path segment for the recipe (e.g. 'standard-meal-kit', '15-minute-meal-kit', 'seasonal-meal-kit'). When omitted, the URL is constructed without the type prefix. |
| `slug` | string | Yes | The unique URL slug for the recipe (e.g. 'honey-glazed-salmon-with-smoky-habanero-corn-barley'). Available from cookbook listing or search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/blue-apron/get-recipe-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"recipe_type":"<string>","slug":"<string>"}'
```

### Search recipes

Searches for recipes by keyword in the Blue Apron cookbook. Matches against recipe title and subtitle fields client-side after fetching the full cookbook. Returns all matching recipes as an array (no pagination). An empty array indicates no matches for the given query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against recipe titles and subtitles (e.g. 'salmon', 'chicken', 'taco') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/blue-apron/search-recipes \
  -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.