blueapron.com APIblueapron.com ↗
Access Blue Apron weekly menus, cookbook listings, recipe details, and keyword search via 4 endpoints. Get ingredients, instructions, nutrition, and pricing data.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d4d12e0f-c4d5-4fb6-b5c4-7b119447b448/get_menu' \ -H 'X-API-Key: $PARSE_API_KEY'
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.
No input parameters required.
{
"type": "array",
"fields": {
"id": "string, unique product identifier",
"tags": "array of strings, badge labels",
"title": "string, meal name",
"calories": "integer or null, calories per serving",
"category": "string, menu category name",
"subtitle": "string, short description of accompaniments",
"cook_time": "integer, cook time in minutes",
"image_url": "string, URL to featured image",
"price_per_serving": "string, formatted price"
},
"sample": {
"data": [
{
"id": "fb20802c-cbaa-4f0d-8f4f-4ef18bbfa0fd",
"tags": [
"Customer Favorite"
],
"title": "Salmon Sushi Rice Bowls",
"calories": null,
"category": "Meal Kits",
"subtitle": "with Avocado, Spicy Mayo & Togarashi",
"cook_time": 25,
"image_url": "https://ba-image.wonder.com/image/origin/blueapron/4e4b3644-62d2-4edc-91ac-28879152b4f8.jpg",
"price_per_serving": "$12.49/serv"
}
],
"status": "success"
}
}About the blueapron.com API
The Blue Apron API exposes 4 endpoints covering weekly meal kit menus, the full cookbook catalog, and individual recipe detail pages. The get_recipe_detail endpoint returns step-by-step instructions, a full ingredient list with images, and nutrition facts including calories, protein, and fiber. The get_menu endpoint reflects the current week's offerings, updated weekly, with cook time, price per serving, and category groupings.
Endpoints and Data Coverage
The API covers four distinct surfaces of Blue Apron's recipe catalog. get_menu returns the current week's meal offerings grouped by category — Meal Kits, Dish by Blue Apron, Assemble & Bake, and others — with fields for title, subtitle, calories, cook_time, price_per_serving, image_url, and badge tags. Because the menu rotates weekly, responses will differ from one week to the next.
get_cookbook_listing returns all recipes from Blue Apron's cookbook archive — potentially hundreds of entries — with the same flat metadata shape: id, title, subtitle, cook_time, price_per_serving, and image_url. This endpoint takes no inputs and is suitable for building recipe indexes or seeding a search interface.
Recipe Detail and Search
get_recipe_detail accepts a required slug parameter (e.g. honey-glazed-salmon-with-smoky-habanero-corn-barley) and an optional recipe_type path segment. It returns the most complete data shape of any endpoint: a description, full ingredients array (each with name, quantity, and image_url), ordered instructions (each with step_number, title, body, and image_url), and a nutrition object containing calories, protein, and fiber. Slugs can be sourced from get_cookbook_listing or search_recipes.
search_recipes takes a query string and matches it against recipe title and subtitle fields across the cookbook. It returns the same flat metadata shape as get_cookbook_listing, making it straightforward to pipe results directly into a get_recipe_detail call using the returned id or slug.
- Build a weekly meal planning tool that surfaces current Blue Apron offerings with cook time and calorie counts from
get_menu. - Create a recipe search interface using
search_recipeswith keyword input like 'salmon' or 'taco' to return matching catalog entries. - Populate a nutrition tracker by extracting
calories,protein, andfiberfromget_recipe_detailfor each recipe. - Generate a full ingredient shopping list by pulling the
ingredientsarray fromget_recipe_detailfor one or more recipes. - Analyze pricing trends across the cookbook catalog using
price_per_servingfromget_cookbook_listing. - Display step-by-step cooking instructions in a custom recipe app using the ordered
instructionsarray with per-step images. - Monitor weekly menu changes by polling
get_menuand comparingidortitlefields across runs.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Blue Apron have an official public developer API?+
What does `get_recipe_detail` return that the listing endpoints don't?+
get_recipe_detail is the only endpoint that returns ingredients (with per-ingredient name, quantity, and image_url), ordered instructions (with step_number, title, body, and a per-step image_url), a description field, and a nutrition object with calories, protein, and fiber values. The listing and search endpoints return summary metadata only.Does the menu endpoint cover all Blue Apron plan types, including wine pairings or market add-ons?+
get_menu endpoint covers meal offerings grouped by the available menu categories such as Meal Kits and Assemble & Bake. Wine pairings, market add-on products, and subscription plan configuration are not currently covered. You can fork this API on Parse and revise it to add an endpoint targeting those product types.How fresh is the data from `get_menu`?+
get_menu results change weekly. There is no timestamp field in the response, so callers should track their own retrieval time if freshness tracking is required.