🌿

FoodAPI

API Documentation

API Documentation

Simple, powerful REST API for discovering global recipes. Built for developers who love food.

Quick Start

Get all dishes:
GET /api/dishes
Search recipes:
GET /api/dishes/search?q=pizza
Get specific dish:
GET /api/dishes/pizza-001-margherita-pizza

Example Response

{
  "id": "themealdb-52820-axein1y5",
  "name": "Katsu Chicken curry",
  "description": "Prep:15min  ›  Cook:30min  ›  Ready in:45min...",
  "country": "Japan",
  "region": "East Asia",
  "tags": ["chicken", "japanese"],
  "difficulty": "Hard",
  "parent_dish": "Katsu Chicken curry",
  "calories": 1249,
  "protein": 53,
  "carbs": 147,
  "fat": 49,
  "fiber": 8,
  "dietaryInfo": [],
  "spiceLevel": "Hot",
  "allergens": ["Gluten", "Eggs", "Soy"],
  "cookingMethod": "Frying",
  "mealType": "Dinner",
  "season": "Winter",
  "instructions": "Prep:15min … Pour curry sauce over chicken, serve with white rice and enjoy!",
  "ingredients": [
    { "name": "chicken breast", "amount": "4 pounded to 1cm thickness" },
    { "name": "plain flour", "amount": "2 tablespoons" },
    { "name": "egg", "amount": "1 beaten" }
  ],
  "image": "https://www.themealdb.com/images/media/meals/vwrpps1503068729.jpg",
  "video": "https://www.youtube.com/watch?v=MWzxDFRtVbc",
  "variations": [
    {
      "id": "katsu-chicken-curry-vegetarian-yn1miu8l",
      "name": "Vegetarian Katsu Chicken curry",
      "description": "A vegetarian variation of Katsu Chicken curry...",
      "calories": 601,
      "spiceLevel": "Mild",
      "dietaryInfo": ["Vegetarian"]
    }
  ]
}

Endpoints

GET/api/dishes

Get all dishes with filtering, pagination, and sorting.

Query params: page, limit, sort, order, filter[country], filter[dietary], etc.
GET/api/dishes/search

Fuzzy search with typo tolerance.

Query params: q (search term)
GET/api/dishes/:id

Get detailed information about a specific dish.

GET/api/random

Get a random dish for discovery.

POST/api/recipes/share

Share your own recipe with the community.

GET/health

Check API and database status.

Features

Fast

Sub-100ms response times with caching

🔍

Smart Search

Fuzzy search with typo tolerance

🎯

Filtered

Advanced filtering by diet, country, etc.