API Reference

Recipe Data Export

Export your saved recipes as structured JSON for backup, migration, or integration with external tools.

Endpoint

GET /api/v1/recipes/export

Headers

Header	Value	Required
Authorization	Bearer <api_key>	Yes
Accept	application/json	No

Query Parameters

Parameter	Type	Description
format	string	Output format: `json` (default) or `csv`
from_date	ISO 8601	Filter recipes saved after this date
tags	string[]	Comma-separated tag filter

Response

{
  "export_id": "exp_9a7b3c",
  "generated_at": "2026-01-15T08:22:10Z",
  "recipe_count": 47,
  "recipes": [
    {
      "id": "rec_4f2a",
      "title": "Spicy Miso Ramen",
      "url": "https://...",
      "tags": ["ramen", "spicy"],
      "saved_at": "2025-12-01T14:30:00Z"
    }
  ]
}

Rate limit: 10 requests per minute per API key. Exports exceeding 10,000 recipes are delivered asynchronously via webhook.