Documentation

API Reference

Programmatic access to our culinary intelligence engine.

All API endpoints (except /health) require authentication. You must include your API key in the x-api-key header of every request.

curl -H "x-api-key: YOUR_KEY" https://recipe-base.wearemachina.com/recipes

GET

Retrieve a paginated list of recipes.

{ "recipes": [ ... ], "count": 150 }

GET

Hybrid intelligent search. Filter by query text or ingredients.

q Search term

ingredients Comma-separated list

POST

Analyze natural language ingredients.

{ "ingredients": ["1 apple", "2 eggs"] }