# 1,000,000+ Recipe and Grocery List API (v2) API

> 1,000,000+ Recipe and Grocery List API (v2) API on Apizie: 66 endpoints (Gets a recipe collection. A recipe collection is a curated set of recipes., Gets a recipe collection metadata. A recipe collection is a curated set of recipes., Get the list of current, seasonal recipe collections. From here, you can use the /collection/{id} endpoint…, Get the user's grocery list. User is determined by Basic Authentication., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/open-data:bigoven/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:bigoven`
- Category: Open Data
- Status: byok
- Source: https://bigoven.com
- Page: https://www.apizie.tech/api/open-data/bigoven
- OpenAPI: https://www.apizie.tech/api/open-data/bigoven/openapi.json

#Documentation This is the documentation for the partner endpoint of the BigOven Recipe and Grocery List API. The update brings with it Swagger-based documentation. [Swagger](http://swagger.io) is an emerging standard…

## Endpoints

### Gets a recipe collection. A recipe collection is a curated set of recipes.
`GET https://www.apizie.tech/v1/open-data:bigoven/collection-get-collection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | the collection identifier |
| rpp | integer | no | results per page |
| pg | integer | no | page number (starting with 1) |
| test | boolean | no |  |
| sessionForLogging | string | no |  |

### Gets a recipe collection metadata. A recipe collection is a curated set of recipes.
`GET https://www.apizie.tech/v1/open-data:bigoven/collection-get-collection-meta` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | the collection identifier |

### Get the list of current, seasonal recipe collections. From here, you can use the /collection/{id} endpoint…
`GET https://www.apizie.tech/v1/open-data:bigoven/collection-collections` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| test | string | no |  |

### Get the user's grocery list. User is determined by Basic Authentication.
`GET https://www.apizie.tech/v1/open-data:bigoven/grocery-list-get` (byok)

### Delete all the items on a grocery list; faster operation than a sync with deleted items.
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-delete` (byok)

### Clears the checked lines.
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-grocery-list-remove-marked-items` (byok)

### Departmentalize a list of strings -- used for ad-hoc grocery list item addition
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-department` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Add a single line item to the grocery list
`POST https://www.apizie.tech/v1/open-data:bigoven/post-grocerylist-item` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Update a grocery item by GUID
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-grocery-list-item-guid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| guid | string | yes |  |
| body | object | yes | JSON request body |

### /grocerylist/item/{guid} DELETE will delete this item assuming you own it.
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-delete-item-by-guid` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| guid | string | yes |  |

### Add a single line item to the grocery list
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Add a Recipe to the grocery list. In the request data, pass in recipeId, scale (scale=1.0 says to keep the…
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-add-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Synchronize the grocery list. Call this with a POST to /grocerylist/sync
`POST https://www.apizie.tech/v1/open-data:bigoven/grocery-list-post-grocery-list-sync` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### POST: /image/avatar Testing with Postman (validated 11/20/2015): 1) Remove the Content-Type header; add…
`POST https://www.apizie.tech/v1/open-data:bigoven/images-upload-user-avatar` (byok)

### Indexes this instance.
`GET https://www.apizie.tech/v1/open-data:bigoven/me-index` (byok)

### Puts me.
`POST https://www.apizie.tech/v1/open-data:bigoven/me-put-me` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Puts me personal.
`POST https://www.apizie.tech/v1/open-data:bigoven/me-put-me-personal` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Puts me preferences.
`POST https://www.apizie.tech/v1/open-data:bigoven/me-put-me-preferences` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Gets the options.
`GET https://www.apizie.tech/v1/open-data:bigoven/me-get-options` (byok)

### Puts me.
`POST https://www.apizie.tech/v1/open-data:bigoven/put-me-profile` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Skinnies this instance.
`GET https://www.apizie.tech/v1/open-data:bigoven/me-skinny` (byok)

### Add a new recipe
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Update a recipe
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Given a query, return recipe titles starting with query. Query must be at least 3 chars in length.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-auto-complete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes |  |
| limit | integer | no |  |

### Automatics the complete all recipes.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-auto-complete-all-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The query. |
| limit | integer | yes | The limit. |

### Automatics the complete my recipes.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-auto-complete-my-recipes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The query. |
| limit | integer | yes | The limit. |

### Get a list of recipe categories (the ID field can be used for include_cat in search parameters)
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-categories` (byok)

### Returns last active recipe for the user
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-get-active-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| userName | string | yes |  |

### Gets recipe single step as text
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-get-step` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| userName | string | yes |  |
| recipeId | integer | yes |  |
| stepId | integer | yes |  |

### Returns stored step number and number of steps in recipe
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-get-step-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| userName | string | yes |  |
| recipeId | integer | yes |  |

### Gets the pending by user.
`GET https://www.apizie.tech/v1/open-data:bigoven/images-get-pending-by-user` (byok)

### Stores recipe step number and returns saved step data
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-get-steps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| userName | string | yes |  |
| recipeId | integer | yes |  |
| stepId | integer | yes |  |

### Update (PUT) a reply to a given review. Authenticated user must be the original one that posted the reply.
`POST https://www.apizie.tech/v1/open-data:bigoven/review-put-reply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| replyId | string | yes |  |
| body | object | yes | JSON request body |

### DELETE a reply to a given review. Authenticated user must be the one who originally posted the reply.
`POST https://www.apizie.tech/v1/open-data:bigoven/review-delete-reply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| replyId | string | yes |  |

### Get a given review by string-style ID. This will return a payload with FeaturedReply, ReplyCount.…
`GET https://www.apizie.tech/v1/open-data:bigoven/get-recipe-review-review-id` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | string | yes |  |

### Update a given top-level review.
`POST https://www.apizie.tech/v1/open-data:bigoven/review-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | string | yes |  |
| body | object | yes | JSON request body |

### Get a paged list of replies for a given review.
`GET https://www.apizie.tech/v1/open-data:bigoven/review-get-replies` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | string | yes |  |
| pg | integer | no | the page (int), starting with 1 |
| rpp | integer | no | results per page (int) |

### POST a reply to a given review. The date will be set by server. Note that replies no longer have star…
`POST https://www.apizie.tech/v1/open-data:bigoven/review-post-reply` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | string | yes |  |
| body | object | yes | JSON request body |

### POST an image as a new RecipeScan request 1) Fetch the filename -- DONE 2) Copy it to the pics/scan folder -…
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-scan` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| test | boolean | no |  |
| devicetype | string | no |  |
| lat | number | no |  |
| lng | number | no |  |

### Return full Recipe detail with steps. Returns 403 if the recipe is owned by someone else.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-get-recipe-with-steps` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | the Recipe ID to retrieve |
| prefetch | boolean | no |  |

### Return full Recipe detail. Returns 403 if the recipe is owned by someone else.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | The Recipe ID to retrieve |
| prefetch | boolean | no | The prefetch. |

### Delete a Recipe (you must be authenticated as an owner of the recipe)
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes |  |

### Zaps the recipe.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-zap-recipe` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | The identifier. |

### Feedback on a Recipe -- for internal BigOven editors
`POST https://www.apizie.tech/v1/open-data:bigoven/recipe-feedback` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes |  |
| body | object | yes | JSON request body |

### POST: /recipe/{recipeId}/image?lat=42&lng=21&caption=this%20is%20my%20caption Note that caption, lng…
`POST https://www.apizie.tech/v1/open-data:bigoven/images-upload-recipe-image` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | string | yes |  |
| caption | string | no |  |
| lat | number | no |  |
| lng | number | no |  |

### Get all the images for a recipe. DEPRECATED. Please use /recipe/{recipeId}/photos.
`GET https://www.apizie.tech/v1/open-data:bigoven/images-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | Recipe ID (required) |

### HTTP POST a new note into the system.
`POST https://www.apizie.tech/v1/open-data:bigoven/note-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | recipeId (int) |
| body | object | yes | JSON request body |

### Get a given note. Make sure you're passing authentication information in the header for the user who owns…
`GET https://www.apizie.tech/v1/open-data:bigoven/note-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | recipe identifier (integer) |
| noteId | integer | yes | The note ID (note -- it's not the RecipeID) |

### HTTP PUT (update) a Recipe note (RecipeNote).
`POST https://www.apizie.tech/v1/open-data:bigoven/note-put` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes |  |
| noteId | integer | yes |  |
| body | object | yes | JSON request body |

### Delete a review do a DELETE Http request of /note/{ID}
`POST https://www.apizie.tech/v1/open-data:bigoven/note-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | recipeId (int) |
| noteId | integer | yes | noteId (int) |

### recipe/100/notes
`GET https://www.apizie.tech/v1/open-data:bigoven/note-get-notes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | recipeId (int) |
| pg | integer | no | page (int, starting from 1) |
| rpp | integer | no | recipeId |

### Get all the photos for a recipe
`GET https://www.apizie.tech/v1/open-data:bigoven/images-get-recipe-photos` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | Recipe ID (required) |
| pg | integer | no |  |
| rpp | integer | no |  |

### Get recipes related to the given recipeId
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-related` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | The recipe id |
| pg | integer | no | The page |
| rpp | integer | no | The results per page |

### Get *my* review for the recipe {recipeId}, where "me" is determined by standard authentication headers
`GET https://www.apizie.tech/v1/open-data:bigoven/get-recipe-recipe-id-review` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes |  |

### Add a new review. Only one review can be provided per {userId, recipeId} pair. Otherwise your review will be…
`POST https://www.apizie.tech/v1/open-data:bigoven/review-post` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes |  |
| body | object | yes | JSON request body |

### Get a given review - DEPRECATED. See recipe/review/{reviewId} for the current usage. Beginning in January…
`GET https://www.apizie.tech/v1/open-data:bigoven/review-get` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | integer | yes | int |
| recipeId | integer | yes | int |

### HTTP PUT (update) a recipe review. DEPRECATED. Please see recipe/review/{reviewId} PUT for the new endpoint.…
`POST https://www.apizie.tech/v1/open-data:bigoven/review-put-legacy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| reviewId | integer | yes | reviewId (int) |
| recipeId | integer | yes | recipeId (int) |
| body | object | yes | JSON request body |

### DEPRECATED! - Deletes a review by recipeId and reviewId. Please use recipe/review/{reviewId} instead.
`POST https://www.apizie.tech/v1/open-data:bigoven/review-delete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes |  |
| reviewId | integer | yes |  |

### Get paged list of reviews for a recipe. Each review will have at most one FeaturedReply, as well as a…
`GET https://www.apizie.tech/v1/open-data:bigoven/review-get-reviews` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | recipe id (int) |
| pg | integer | no | the page (int), starting with 1 |
| rpp | integer | no | results per page (int) |

### Gets a list of RecipeScan images for the recipe. There will be at most 3 per recipe.
`GET https://www.apizie.tech/v1/open-data:bigoven/images-get-scan-images` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| recipeId | integer | yes | the recipe identifier (int) |

### Search for recipes. There are many parameters that you can apply. Starting with the most common, use…
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-recipe-search` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| any_kw | string | no | Search anywhere in the recipe for the keyword |
| folder | string | no | Search in a specific folder name for the authenticated user |
| coll | integer | no | Limit to a collection ID number |
| filter | string | no | optionally set to either "myrecipes", "try", "favorites","added" to filter to just the authenticated user's recipe set |
| title_kw | string | no | Search just in the recipe title for the keyword |
| userId | integer | no | Set the target userid to search their public recipes |
| username | string | no | Set the target username to search their public recipes |
| token | string | no |  |
| photos | boolean | no | if set to true, limit search results to photos only |
| boostmine | boolean | no | if set to true, boost my own recipes in my folders so they show up high in the list (at the expense of other sort orders) |
| include_cat | string | no | integer of the subcategory you'd like to limit searches to (see the /recipe/categories endpoint for available id numbers). For instance,… |
| exclude_cat | string | no | like include_cat, set this to an integer to exclude a specific category |
| include_primarycat | string | no | csv indicating up to three top-level categories -- valid values are… |
| exclude_primarycat | string | no | csv indicating integer values for up to 3 top-level categories -- valid values are 1...11… |
| include_ing | string | no | A CSV representing up to 3 ingredients to include, e.g., tomatoes,corn%20%starch,chicken |
| exclude_ing | string | no | A CSV representing up to 3 ingredients to exclude (Powersearch-capable plan required) |
| cuisine | string | no | Limit to a specific cuisine. Cooks can enter anything free-form, but the few dozen preconfigured values are… |
| db | string | no |  |
| userset | string | no | If set to a given username, it'll force the search to filter to just that username |
| servingsMin | number | no | Limit to yield of a given number size or greater. Note that cooks usually enter recipes by Servings, but sometimes they are posted by… |
| totalMins | integer | no | Optional. If supplied, will restrict results to recipes that can be made in {totalMins} or less. (Convert "1 hour, 15 minutes" to 75… |
| maxIngredients | integer | no | Optional. If supplied, will restrict results to recipes that can be made with {maxIngredients} ingredients or less |
| minIngredients | integer | no | Optional. If supplied, will restrict results to recipes that have at least {minIngredients} |
| rpp | integer | no | integer; results per page |
| pg | integer | no | integer: the page number |
| vtn | integer | no | when set to 1, limit to vegetarian (Powersearch-capable plan required) |
| vgn | integer | no | when set to 1, limit to vegan (Powersearch-capable plan required) |
| chs | integer | no | when set to 1, limit to contains-cheese (Powersearch-capable plan required) |
| glf | integer | no | when set to 1, limit to gluten-free (Powersearch-capable plan required) |
| ntf | integer | no | when set to 1, limit to nut-free (Powersearch-capable plan required) |
| dyf | integer | no | when set to 1, limit to dairy-free (Powersearch-capable plan required) |
| sff | integer | no | when set to 1, limit to seafood-free (Powersearch-capable plan required) |
| slf | integer | no | when set to 1, limit to shellfish-free (Powersearch-capable plan required) |
| tnf | integer | no | when set to 1, limit to tree-nut free (Powersearch-capable plan required) |
| wmf | integer | no | when set to 1, limit to white-meat free (Powersearch-capable plan required) |
| rmf | integer | no | when set to 1, limit to red-meat free (Powersearch-capable plan required) |
| cps | integer | no | when set to 1, recipe contains pasta, set to 0 means contains no pasta (Powersearch-capable plan required) |
| champion | integer | no | optional. When set to 1, this will limit search results to "best of" recipes as determined by various internal editorial and programmatic… |
| synonyms | boolean | no | optional, default is false. When set to true, BigOven will attempt to apply synonyms in search (e.g., excluding pork will also exclude… |

### Get a random, home-page-quality Recipe.
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-get-random-recipe` (byok)

### Get the recipe/comment tuples for those recipes with 4 or 5 star ratings
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-raves` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pg | integer | no | page, starting with 1 |
| rpp | integer | no | results per page |

### Get a list of recipes that the authenticated user has most recently viewed
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-recent-views` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| pg | integer | no | Page number starting with 1 |
| rpp | integer | no | results per page |

### Search for recipes. There are many parameters that you can apply. Starting with the most common, use…
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-recipe-search-random` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| any_kw | string | no | Search anywhere in the recipe for the keyword |
| folder | string | no | Search in a specific folder name for the authenticated user |
| coll | integer | no | Limit to a collection ID number |
| filter | string | no | optionally set to either "myrecipes", "try", "favorites","added" to filter to just the authenticated user's recipe set |
| title_kw | string | no | Search just in the recipe title for the keyword |
| userId | integer | no | Set the target userid to search their public recipes |
| username | string | no | Set the target username to search their public recipes |
| token | string | no |  |
| photos | boolean | no | if set to true, limit search results to photos only |
| boostmine | boolean | no | if set to true, boost my own recipes in my folders so they show up high in the list (at the expense of other sort orders) |
| include_cat | string | no | integer of the subcategory you'd like to limit searches to (see the /recipe/categories endpoint for available id numbers). For instance,… |
| exclude_cat | string | no | like include_cat, set this to an integer to exclude a specific category |
| include_primarycat | string | no | csv indicating up to three top-level categories -- valid values are… |
| exclude_primarycat | string | no | csv indicating integer values for up to 3 top-level categories -- valid values are 1...11… |
| include_ing | string | no | A CSV representing up to 3 ingredients to include, e.g., tomatoes,corn%20%starch,chicken |
| exclude_ing | string | no | A CSV representing up to 3 ingredients to exclude (Powersearch-capable plan required) |
| cuisine | string | no | Limit to a specific cuisine. Cooks can enter anything free-form, but the few dozen preconfigured values are… |
| db | string | no |  |
| userset | string | no | If set to a given username, it'll force the search to filter to just that username |
| servingsMin | number | no | Limit to yield of a given number size or greater. Note that cooks usually enter recipes by Servings, but sometimes they are posted by… |
| totalMins | integer | no | Optional. If supplied, will restrict results to recipes that can be made in {totalMins} or less. (Convert "1 hour, 15 minutes" to 75… |
| maxIngredients | integer | no | Optional. If supplied, will restrict results to recipes that can be made with {maxIngredients} ingredients or less |
| minIngredients | integer | no | Optional. If supplied, will restrict results to recipes that have at least {minIngredients} |
| vtn | integer | no | when set to 1, limit to vegetarian (Powersearch-capable plan required) |
| vgn | integer | no | when set to 1, limit to vegan (Powersearch-capable plan required) |
| chs | integer | no | when set to 1, limit to contains-cheese (Powersearch-capable plan required) |
| glf | integer | no | when set to 1, limit to gluten-free (Powersearch-capable plan required) |
| ntf | integer | no | when set to 1, limit to nut-free (Powersearch-capable plan required) |
| dyf | integer | no | when set to 1, limit to dairy-free (Powersearch-capable plan required) |
| sff | integer | no | when set to 1, limit to seafood-free (Powersearch-capable plan required) |
| slf | integer | no | when set to 1, limit to shellfish-free (Powersearch-capable plan required) |
| tnf | integer | no | when set to 1, limit to tree-nut free (Powersearch-capable plan required) |
| wmf | integer | no | when set to 1, limit to white-meat free (Powersearch-capable plan required) |
| rmf | integer | no | when set to 1, limit to red-meat free (Powersearch-capable plan required) |
| cps | integer | no | when set to 1, recipe contains pasta, set to 0 means contains no pasta (Powersearch-capable plan required) |
| champion | integer | no | optional. When set to 1, this will limit search results to "best of" recipes as determined by various internal editorial and programmatic… |
| synonyms | boolean | no | optional, default is false. When set to true, BigOven will attempt to apply synonyms in search (e.g., excluding pork will also exclude… |

### Same as GET recipe but also includes the recipe videos (if any)
`GET https://www.apizie.tech/v1/open-data:bigoven/recipe-get-v2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | yes | The Recipe ID to retrieve |
| prefetch | boolean | no | The prefetch. |

## Example
```
curl "https://www.apizie.tech/v1/open-data:bigoven/collection-get-collection" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the 1,000,000+ Recipe and Grocery List API (v2) API?
Create a free Apizie key, then send GET https://www.apizie.tech/v1/open-data:bigoven/collection-get-collection with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the 1,000,000+ Recipe and Grocery List API (v2) API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. 1,000,000+ Recipe and Grocery List API (v2) itself also needs your own key from bigoven.com.

### Can AI agents use the 1,000,000+ Recipe and Grocery List API (v2) API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:bigoven.

### What is the status of the 1,000,000+ Recipe and Grocery List API (v2) API?
Needs your own provider key (bring your own key)