# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/epicurious/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/epicurious/get-recipe-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/epicurious/get-recipe-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/epicurious/search-recipes \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.