List Recipes
Retrieve a paginated list of recipes with optional filtering.
GET
/{locale}-{country}/recipes
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| search | string | Filter recipes by name (case-insensitive) |
| tag | integer | Filter by tag ID |
| label | integer | Filter by label ID |
| difficulty | integer | Filter by difficulty level (1-3) |
| has_pdf | boolean | Filter recipes that have a PDF card |
| per_page | integer | Results per page (10-200, default 50) |
| sort | string | Sort by: created_at (default) or updated_at, always descending |
Response Fields
| Field | Type | Description |
|---|---|---|
| id | integer | Recipe ID |
| canonical_id | integer|null | ID of the original recipe if this is a variant |
| published | boolean | Whether this recipe is currently published on HelloFresh |
| url | string | URL to recipe on website |
| name | string | Recipe name (localized) |
| headline | string | Short description (localized) |
| difficulty | integer | Difficulty level (1-3) |
| prep_time | integer | Preparation time in minutes |
| total_time | integer | Total cooking time in minutes |
| has_pdf | boolean | Whether recipe has a PDF card |
| label | object|null | Recipe label |
| tags | array | Recipe tags |
| created_at | datetime | Creation timestamp |
| updated_at | datetime | Last update timestamp |
Example Request
curl -X GET "https:///de-DE/recipes?search=pasta&per_page=10" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json"Pre-Release API (vunknown)
This API is currently in pre-release. Endpoints, response formats, and features may change without notice until version 1.0.0 is released. Use in production at your own risk.