# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-blueapron-com-api-68b41092/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-blueapron-com-api-68b41092/get_cookbook_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-blueapron-com-api-68b41092/get_menu \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-blueapron-com-api-68b41092/get_recipe_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-blueapron-com-api-68b41092/search_recipes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```