Guides
Get from zero to your first authenticated request in under a minute.
Quickstart
- 1. Sign up for a free account (no credit card required).
- 2. Create your first key at /dashboard/api-keys and copy it once.
- 3. Send a request with the key in the
x-api-keyheader.
curl
curl -H "x-api-key: lapi_your_key_here" \ https://ugafoodapi.vercel.app/api/v1/recipes/trending
JavaScript / Node 18+
const KEY = process.env.UGANDA_FOOD_API_KEY;
const res = await fetch(
"https://ugafoodapi.vercel.app/api/v1/recipes?dietary=vegan&max_prep_time=30",
{ headers: { "x-api-key": KEY } },
);
const { recipes } = await res.json();
console.log(recipes.map(r => `${r.name} — ${r.region_origin}`));Python (requests)
import os, requests
key = os.environ["UGANDA_FOOD_API_KEY"]
res = requests.get(
"https://ugafoodapi.vercel.app/api/v1/recipes",
headers={"x-api-key": key},
params={"region": "central", "dietary": "vegan"},
)
for r in res.json()["recipes"]:
print(r["name"], "—", r["region_origin"])Guides by topic
Authenticating requests
Pass your API key as either Authorization: Bearer <key> or x-api-key: <key>. Generate keys from the dashboard.
Manage API keys
Searching recipes
Filter by region, tribe, district, dietary, ingredients on hand, max prep time, max calories, cost tier, and more.
Search reference
Recipe detail
Pull the full record for a dish — ingredients with substitutes, numbered instructions, nutrition, cost analysis and variations.
Recipe reference
Culture & geography
Regions, tribes, districts and signature dishes per tribe — the cultural taxonomy of Uganda's cuisine.
Culture reference
UGX cost analysis
Each recipe ships with total cost, per-serving cost (UGX) and an economy/moderate/premium tier anchored to Kampala market prices.
See sample response
Rate limits & errors
401 / 429 / 404 conventions, X-RateLimit headers and the 5 plan tiers that determine your per-minute and per-month limits.
Help center
Full API reference
Try every endpoint live in the Scalar reference, with request builder, examples and schema viewer.
Open reference
Changelog
See what's shipped and what's coming. We add recipes and ingredients on a rolling basis.
View changelog