Public API

Foodgeist API

Read-only access to 130,289 verified culinary entries. 2,818 techniques, 1,374 recipes, 125,284 ingredients, 813 industrial processes. Refreshed continuously.

Free tier: 1,000 calls/month · no key needed · rate-limited per IP

Quick Start

curl

curl https://foodgeist.app/api/health

JavaScript / Node

const r = await fetch('https://foodgeist.app/api/techniques?limit=20')
const data = await r.json()
console.log(data.techniques.length)

Python

import requests
data = requests.get('https://foodgeist.app/api/ingredients/usda-167782').json()
print(data['ingredient']['name'])

Endpoints

GET/api/healthPlatform liveness + SOTA scoreboard. Machine-readable status.

GET/api/pulsePer-agent runs + errors + latest entries.

GET/api/techniquesBrowse 2,818 cooking techniques. Filter by ?category=THERMAL.

GET/api/techniques/{id}One technique with full structured science (40+ fields).

GET/api/recipesBrowse 1,374 recipes.

GET/api/recipes/{id}One recipe.

GET/api/ingredientsBrowse 125,284 ingredients (USDA + OFF + Wikipedia + Wikidata).

GET/api/ingredients/{id}One ingredient with nutrition + PubChem compound (when present).

GET/api/industrialBrowse 813 industrial processes.

GET/api/industrial/{id}One industrial technique.

GET/api/nexusLive food trend topics with lifecycle phase + score.

GET/api/search?q=Cross-entity search.

Full machine-readable spec: /api/openapi.json (OpenAPI 3.1)

Pricing

FREE

1,000 calls/mo

Indie hackers, students, prototypes

No key required

INDIE

$29/mo

10,000 calls/mo

Side projects, personal apps

API key

PRO

$299/mo

100,000 calls/mo

Production apps, food-tech startups

API key + SLA

ENTERPRISE

Custom

Unlimited

Restaurant groups, CPG, R&D

Dedicated support

API access ships with Gastronome (5K req/mo) and Alchemist (50K req/mo, all endpoints, commercial license). Need more? Email us.

Why Foodgeist vs Spoonacular / USDA / Yummly

· Verified, not aggregated. Every claim passes our published verification pipeline.
· Confidence tiers per claim. A-F per entry. Auditable.
· Living, not static. Continuous ingest from USDA, Open Food Facts, Wikipedia, Wikidata, PubChem.
· Trend layer in the graph. Not a separate enterprise product.
· Side-by-side benchmarks. See /vs for live comparison.

Building something with the API? Email us — we want to hear about it. Subscribers earn 1 month free per paid referral — share your link from /profile once you're in.