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

**Provider:** 1,000,000+ Recipe and Grocery List API (v2)
**Category:** search
**Base URL:** `https://api2.bigoven.com`
**Auth:** api-key — `X-BigOven-API-Key: YOUR_API_KEY`
**Rate Limit:** Varies by plan
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api2.bigoven.com

## Description

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 is an emerging standard for describing REST-based APIs, and with this Swagger-compliant endpoint (ab

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api2.bigoven.com/collection/{id}` | Gets a recipe collection. A recipe collection is a curated set of recipes. |
| GET | `https://api2.bigoven.com/collection/{id}/meta` | Gets a recipe collection metadata. A recipe collection is a curated set of recipes. |
| GET | `https://api2.bigoven.com/collections` | Get the list of current, seasonal recipe collections. From here, you can use the /collection/{id} endpoint to retrieve the recipes in those collections. |
| DELETE | `https://api2.bigoven.com/grocerylist` | Delete all the items on a grocery list; faster operation than a sync with deleted items. |
| GET | `https://api2.bigoven.com/grocerylist` | Get the user's grocery list.  User is determined by Basic Authentication. |
| POST | `https://api2.bigoven.com/grocerylist/clearcheckedlines` | Clears the checked lines. |
| POST | `https://api2.bigoven.com/grocerylist/department` | Departmentalize a list of strings -- used for ad-hoc grocery list item addition |
| POST | `https://api2.bigoven.com/grocerylist/item` | Add a single line item to the grocery list |

## Authentication

API key in the request header (X-BigOven-API-Key)

```
X-BigOven-API-Key: YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://api2.bigoven.com/collection/{id}' \
  -H 'X-BigOven-API-Key: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Freemium. Free tier available; paid plans for higher recipe query volume.

---

*Source: [API Map](https://apimap.dev/apis/1-000-000-recipe-and-grocery-list-api-v2/) — CC BY 4.0*