What does a recipe include?

Ingredients with quantities, original step-by-step instructions, prep and cook times, servings, difficulty, cuisine, meal type and dietary flags for vegetarian, vegan and gluten-free.

Yes. By text, ingredient, cuisine, meal type, difficulty, dietary flag or total time, and the random endpoint respects the same filters.

Are the recipes original?

Yes. Each recipe was written for this API, and dietary flags are derived from the ingredients.

What does a call cost?

1 token. The free plan covers 500 lookups a month.

FoodMAINTAINED1 token / call

Recipes API

115 curated home-cook recipes across 21 cuisines with quantities, steps, timings and dietary flags

115 curated home-cook recipes across 21 cuisines — Italian, Mexican, Indian, Japanese, Korean, Thai, French, Middle Eastern, Spanish, British and more — each with ingredients and quantities, original step-by-step instructions, prep and cook times, servings, difficulty and dietary flags (vegetarian, vegan, gluten-free). Search by text, ingredient, cuisine, meal type, difficulty, diet or total time, page through summaries, fetch full recipes by slug, or pull a random dish that matches any filter.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 125+ APIsCancel anytime

response.json

{
  "query": "GET /v1/recipes/random?vegan=true&gluten_free=true",
  "name": "Rice and Peas",
  "cuisine": "caribbean",
  "total_minutes": 35,
  "difficulty": "medium",
  "catalog": "115 recipes / 21 cuisines / vegan + gluten-free flags"
}

Production Ready: Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration: Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs: Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Recipes API

Suggest tonight's dinner filtered by cuisine, time, difficulty or diet.
Build a meal planner with vegetarian, vegan and gluten-free options.
Generate shopping lists from ingredient quantities.
Show step-by-step cooking instructions in a kitchen-friendly view.

Recipes API endpoints

Every endpoint with its parameters and a real example response.

OpenAPI definition Postman workspace

GETGet Recipe
GETList Cuisines
GETList Recipes
GETRandom Recipe

GETGet Recipe

https://api-recipes.dataandapis.com/v1/recipes/{slug}

Path parameters

Parameter	Example
slug	margherita-pizza	Required

Example request

curl "https://api-recipes.dataandapis.com/v1/recipes/margherita-pizza" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "name": "Margherita Pizza",
  "slug": "margherita-pizza",
  "cuisine": "italian",
  "meal_type": "dinner",
  "difficulty": "hard",
  "prep_minutes": 90,
  "cook_minutes": 12,
  "total_minutes": 102,
  "servings": 2,
  "vegetarian": true,
  "vegan": false,
  "gluten_free": false,
  "tags": [
    "pizza",
    "baking",
    "classic"
  ],
  "ingredients": [
    {
      "name": "Pizza dough",
      "quantity": "300 g"
    },
    {
      "name": "Crushed tomatoes",
      "quantity": "120 g"
    },
…

Show full response

{
  "ok": true,
  "name": "Margherita Pizza",
  "slug": "margherita-pizza",
  "cuisine": "italian",
  "meal_type": "dinner",
  "difficulty": "hard",
  "prep_minutes": 90,
  "cook_minutes": 12,
  "total_minutes": 102,
  "servings": 2,
  "vegetarian": true,
  "vegan": false,
  "gluten_free": false,
  "tags": [
    "pizza",
    "baking",
    "classic"
  ],
  "ingredients": [
    {
      "name": "Pizza dough",
      "quantity": "300 g"
    },
    {
      "name": "Crushed tomatoes",
      "quantity": "120 g"
    },
    {
      "name": "Fresh mozzarella",
      "quantity": "125 g"
    },
    {
      "name": "Basil leaves",
      "quantity": "a handful"
    },
    {
      "name": "Olive oil",
      "quantity": "1 tbsp"
    },
    {
      "name": "Salt",
      "quantity": "pinch"
    }
  ],
  "instructions": [
    "Let the dough come to room temperature, then stretch it into a thin 30 cm round.",
    "Spread a thin layer of seasoned crushed tomatoes, leaving a border.",
    "Tear the mozzarella over the top and bake on a preheated stone or tray at the oven's highest setting until blistered, 8–12 minutes.",
    "Finish with basil and a drizzle of olive oil."
  ]
}

GETList Cuisines

https://api-recipes.dataandapis.com/v1/recipes/cuisines

This endpoint takes no parameters.

Example request

curl "https://api-recipes.dataandapis.com/v1/recipes/cuisines" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "total_recipes": 115,
  "cuisines": [
    {
      "name": "american",
      "recipes": 19
    },
    {
      "name": "brazilian",
      "recipes": 1
    },
    {
      "name": "british",
      "recipes": 8
    },
    {
      "name": "caribbean",
      "recipes": 2
    },
    {
      "name": "chinese",
      "recipes": 7
    },
    {
      "name": "french",
      "recipes": 9
    },
…

Show full response

{
  "ok": true,
  "total_recipes": 115,
  "cuisines": [
    {
      "name": "american",
      "recipes": 19
    },
    {
      "name": "brazilian",
      "recipes": 1
    },
    {
      "name": "british",
      "recipes": 8
    },
    {
      "name": "caribbean",
      "recipes": 2
    },
    {
      "name": "chinese",
      "recipes": 7
    },
    {
      "name": "french",
      "recipes": 9
    },
    {
      "name": "fusion",
      "recipes": 1
    },
    {
      "name": "german",
      "recipes": 3
    },
    {
      "name": "indian",
      "recipes": 8
    },
    {
      "name": "italian",
      "recipes": 10
    },
    {
      "name": "japanese",
      "recipes": 6
    },
    {
      "name": "korean",
      "recipes": 4
    },
    {
      "name": "mediterranean",
      "recipes": 7
    },
    {
      "name": "mexican",
      "recipes": 8
    },
    {
      "name": "middle-eastern",
      "recipes": 5
    },
    {
      "name": "moroccan",
      "recipes": 3
    },
    {
      "name": "peruvian",
      "recipes": 1
    },
    {
      "name": "spanish",
      "recipes": 4
    },
    {
      "name": "thai",
      "recipes": 5
    },
    {
      "name": "venezuelan",
      "recipes": 1
    },
    {
      "name": "vietnamese",
      "recipes": 3
    }
  ],
  "meal_types": [
    {
      "name": "breakfast",
      "recipes": 11
    },
    {
      "name": "dessert",
      "recipes": 12
    },
    {
      "name": "dinner",
      "recipes": 55
    },
    {
      "name": "lunch",
      "recipes": 25
    },
    {
      "name": "snack",
      "recipes": 12
    }
  ],
  "dietary": {
    "vegetarian": 67,
    "vegan": 24,
    "gluten_free": 50
  }
}

GETList Recipes

https://api-recipes.dataandapis.com/v1/recipes

Query parameters

Parameter	Example
cuisine	italian	Optional
difficulty	easy	Optional
gluten_free	true	Optional
ingredient	chickpea	Optional
limit	10	Optional
max_minutes	30	Optional
meal_type	dinner	Optional
page	1	Optional
q	coconut	Optional
vegan	true	Optional
vegetarian	true	Optional

Example request

curl "https://api-recipes.dataandapis.com/v1/recipes?cuisine=italian&difficulty=easy&gluten_free=true&ingredient=chickpea&limit=10&max_minutes=30&meal_type=dinner&page=1&q=coconut&vegan=true&vegetarian=true" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "total": 6,
  "page": 1,
  "limit": 3,
  "count": 3,
  "results": [
    {
      "name": "Spaghetti Aglio e Olio",
      "slug": "spaghetti-aglio-e-olio",
      "cuisine": "italian",
      "meal_type": "dinner",
      "difficulty": "easy",
      "prep_minutes": 5,
      "cook_minutes": 15,
      "total_minutes": 20,
      "servings": 2,
      "vegetarian": true,
      "vegan": true,
      "gluten_free": false,
      "tags": [
        "pasta",
        "quick",
        "classic"
      ]
    },
    {
      "name": "Margherita Pizza",
…

Show full response

{
  "ok": true,
  "total": 6,
  "page": 1,
  "limit": 3,
  "count": 3,
  "results": [
    {
      "name": "Spaghetti Aglio e Olio",
      "slug": "spaghetti-aglio-e-olio",
      "cuisine": "italian",
      "meal_type": "dinner",
      "difficulty": "easy",
      "prep_minutes": 5,
      "cook_minutes": 15,
      "total_minutes": 20,
      "servings": 2,
      "vegetarian": true,
      "vegan": true,
      "gluten_free": false,
      "tags": [
        "pasta",
        "quick",
        "classic"
      ]
    },
    {
      "name": "Margherita Pizza",
      "slug": "margherita-pizza",
      "cuisine": "italian",
      "meal_type": "dinner",
      "difficulty": "hard",
      "prep_minutes": 90,
      "cook_minutes": 12,
      "total_minutes": 102,
      "servings": 2,
      "vegetarian": true,
      "vegan": false,
      "gluten_free": false,
      "tags": [
        "pizza",
        "baking",
        "classic"
      ]
    },
    {
      "name": "Creamy Mushroom Risotto",
      "slug": "mushroom-risotto",
      "cuisine": "italian",
      "meal_type": "dinner",
      "difficulty": "medium",
      "prep_minutes": 10,
      "cook_minutes": 30,
      "total_minutes": 40,
      "servings": 4,
      "vegetarian": true,
      "vegan": false,
      "gluten_free": true,
      "tags": [
        "rice",
        "comfort-food"
      ]
    }
  ]
}

GETRandom Recipe

https://api-recipes.dataandapis.com/v1/recipes/random

Query parameters

Parameter	Example
amount	1	Optional
gluten_free	true	Optional
vegan	true	Optional

Example request

curl "https://api-recipes.dataandapis.com/v1/recipes/random?amount=1&gluten_free=true&vegan=true" \
  -H "X-Api-Key: YOUR_API_KEY"

Example response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "name": "Rice and Peas",
      "slug": "rice-and-peas",
      "cuisine": "caribbean",
      "meal_type": "dinner",
      "difficulty": "medium",
      "prep_minutes": 5,
      "cook_minutes": 30,
      "total_minutes": 35,
      "servings": 6,
      "vegetarian": true,
      "vegan": true,
      "gluten_free": true,
      "tags": [
        "rice",
        "vegan",
        "gluten-free"
      ],
      "ingredients": [
        {
          "name": "Long-grain rice",
          "quantity": "400 g"
        },
        {
…

Show full response

{
  "ok": true,
  "count": 1,
  "results": [
    {
      "name": "Rice and Peas",
      "slug": "rice-and-peas",
      "cuisine": "caribbean",
      "meal_type": "dinner",
      "difficulty": "medium",
      "prep_minutes": 5,
      "cook_minutes": 30,
      "total_minutes": 35,
      "servings": 6,
      "vegetarian": true,
      "vegan": true,
      "gluten_free": true,
      "tags": [
        "rice",
        "vegan",
        "gluten-free"
      ],
      "ingredients": [
        {
          "name": "Long-grain rice",
          "quantity": "400 g"
        },
        {
          "name": "Kidney beans",
          "quantity": "1 can with liquid"
        },
        {
          "name": "Coconut milk",
          "quantity": "400 ml"
        },
        {
          "name": "Scallions",
          "quantity": "2"
        },
        {
          "name": "Thyme",
          "quantity": "2 sprigs"
        },
        {
          "name": "Scotch bonnet",
          "quantity": "1, whole"
        },
        {
          "name": "Garlic",
          "quantity": "2 cloves"
        }
      ],
      "instructions": [
        "Put the beans and their liquid, coconut milk, aromatics and 300 ml water in a pot and bring to a boil.",
        "Stir in the rice and salt, cover and simmer on low for 20 minutes.",
        "Rest off the heat for 10 minutes.",
        "Remove the chile and thyme stems and fluff with a fork."
      ]
    }
  ]
}

Where the data comes from

Source: Curated recipe set bundled in the worker.
Freshness: Extended with API releases.

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

4endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 125+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  'https://api-recipes.dataandapis.com/v1/recipes/{slug}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Recipes API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

slug

Target:

Client:

import axios from 'axios';

const url = 'https://api-recipes.dataandapis.com/v1/recipes/{slug}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});