# Epicurious — 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 Epicurious recipes by ingredient or cuisine, view detailed recipe information including ingredients and instructions, and read user reviews to find the best dishes to cook. Get everything you need to discover and prepare new meals from one of the web's most trusted recipe sources.

**Category:** Food & Dining | **Website:** [epicurious.com/](https://epicurious.com/) | **Docs:** [parse.bot/marketplace/2911125b-2693-415c-aaf9-4e9bf5086870/epicurious-com-api](https://parse.bot/marketplace/2911125b-2693-415c-aaf9-4e9bf5086870/epicurious-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-epicurious-com-api-2911125b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_recipe_details

Retrieve full details for a specific recipe, including ingredients, instructions, times, tags, images, and story_id for fetching reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the recipe page (e.g., 'https://www.epicurious.com/recipes/food/views/quick-chicken-piccata') or a path starting with '/'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-epicurious-com-api-2911125b/get_recipe_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_recipe_reviews

Fetch user reviews and ratings for a recipe using its story ID. Supports cursor-based pagination using timestamp cursors from end_cursor.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Cursor for pagination, a timestamp string from end_cursor of a previous response (e.g., '2025-09-29T00:36:21.823Z'). |
| `limit` | integer | No | Maximum number of reviews to return. |
| `story_id` | string | Yes | The story ID of the recipe, obtained from get_recipe_details response field 'story_id'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-epicurious-com-api-2911125b/get_recipe_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>","story_id":"<string>"}'
```

### search_recipes

Search for recipes on Epicurious. Returns a paginated list of recipes with titles, URLs, descriptions, ratings, and content types. Results may include recipes, articles, galleries, and videos.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g., 'chicken', 'pasta', 'chocolate cake') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-epicurious-com-api-2911125b/search_recipes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```