Documentation

Everything you need to integrate Zion Archive datasets into your pipeline.

Authentication

All API requests require an API key passed via the X-API-Key header. Request your key through our inquiry form. Free-tier keys are provisioned within 24 hours.

Developer Quick-Start

Copy these cURL commands to start querying the API immediately. Replace YOUR_API_KEY with the key provided after inquiry approval.

1. Health check (no auth required)

curl https://api.zionarchive.ai/health

2. Fetch a single recipe by ID

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zionarchive.ai/v1/recipes/5"

3. Fetch recipes with pagination

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zionarchive.ai/v1/recipes?limit=5"

4. Search recipes

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.zionarchive.ai/v1/search?q=pecan+pie"

API Reference

GET/v1/recipesAuth Required

Retrieve paginated recipe records. Supports skip/limit query parameters.

GET/v1/recipes/{id}Auth Required

Retrieve a single recipe by its database ID, including the signed image URL.

GET/v1/search?q={query}Auth Required

Full-text search across recipe titles, ingredients, and instructions.

GET/v1/statsAuth Required

Aggregated dataset statistics — total records, cookbooks, and decade breakdown.

GET/api/download-sample

Download a sample CSV extract of the dataset for quick evaluation.

Rate Limits

Tier	Requests / minute	Daily limit
Free	30	500
Developer	120	10,000
Enterprise	Unlimited	Unlimited