TheMealDB API

https://www.themealdb.com/api.php
Admin
TheMealDB is a free recipe API that provides access to a comprehensive database of meals with...
Tokens:1,125
Snippets:15
Trust Score:9.4
Update:5 months ago
Show doc for...
Tokens:
Raw
### List Meals by First Letter

Source: https://www.themealdb.com/api.php

Retrieves meals starting with a specific letter.

```APIDOC
## GET /search.php?f={letter}

### Description
Lists meals based on the first letter of their name.

### Method
GET

### Endpoint
`/api/json/v1/1/search.php?f=a`

### Parameters
#### Query Parameters
- **f** (string) - Required - The first letter of the meal name to search by.
```

--------------------------------

### List All Categories, Areas, and Ingredients

Source: https://www.themealdb.com/api.php

Retrieves lists of categories, areas, or ingredients.

```APIDOC
## GET /list.php

### Description
Provides lists of available meal categories, areas, or ingredients.

### Method
GET

### Endpoint
`/api/json/v1/1/list.php?c=list` (Categories)
`/api/json/v1/1/list.php?a=list` (Areas)
`/api/json/v1/1/list.php?i=list` (Ingredients)

### Parameters
#### Query Parameters
- **c** (string) - Optional - Set to 'list' to retrieve all categories.
- **a** (string) - Optional - Set to 'list' to retrieve all areas.
- **i** (string) - Optional - Set to 'list' to retrieve all ingredients.
```

--------------------------------

### List All Meal Categories

Source: https://www.themealdb.com/api.php

Retrieves a list of all available meal categories.

```APIDOC
## GET /categories.php

### Description
Returns a list of all categories under which meals are classified.

### Method
GET

### Endpoint
`/api/json/v1/1/categories.php`
```

--------------------------------

### Search Meal by Name

Source: https://www.themealdb.com/api.php

Retrieves meals that match a given name.

```APIDOC
## GET /search.php?s={name}

### Description
Searches for meals based on their name.

### Method
GET

### Endpoint
`/api/json/v1/1/search.php?s=Arrabiata`

### Parameters
#### Query Parameters
- **s** (string) - Required - The name of the meal to search for.
```

--------------------------------

### Lookup Meal by ID

Source: https://www.themealdb.com/api.php

Retrieves the full details of a meal using its ID.

```APIDOC
## GET /lookup.php?i={id}

### Description
Retrieves comprehensive details for a specific meal identified by its ID.

### Method
GET

### Endpoint
`/api/json/v1/1/lookup.php?i=52772`

### Parameters
#### Query Parameters
- **i** (string) - Required - The unique identifier of the meal.
```

--------------------------------

### Filter Meals by Main Ingredient

Source: https://www.themealdb.com/api.php

Retrieves meals that contain a specific main ingredient.

```APIDOC
## GET /filter.php?i={ingredient}

### Description
Filters and returns meals that include a specified main ingredient.

### Method
GET

### Endpoint
`/api/json/v1/1/filter.php?i=chicken_breast`

### Parameters
#### Query Parameters
- **i** (string) - Required - The name of the main ingredient to filter by.
```

--------------------------------

### Filter Meals by Category

Source: https://www.themealdb.com/api.php

Retrieves meals belonging to a specific category.

```APIDOC
## GET /filter.php?c={category}

### Description
Filters and returns meals that fall under a specified category.

### Method
GET

### Endpoint
`/api/json/v1/1/filter.php?c=Seafood`

### Parameters
#### Query Parameters
- **c** (string) - Required - The name of the category to filter by.
```

--------------------------------

### Lookup Random Meal

Source: https://www.themealdb.com/api.php

Retrieves a single random meal from the database.

```APIDOC
## GET /random.php

### Description
Fetches a single, randomly selected meal from the API.

### Method
GET

### Endpoint
`/api/json/v1/1/random.php`
```

--------------------------------

### Filter Meals by Area

Source: https://www.themealdb.com/api.php

Retrieves meals originating from a specific area.

```APIDOC
## GET /filter.php?a={area}

### Description
Filters and returns meals associated with a specified geographical area or cuisine.

### Method
GET

### Endpoint
`/api/json/v1/1/filter.php?a=Canadian`

### Parameters
#### Query Parameters
- **a** (string) - Required - The name of the area to filter by.
```
Tokens:
Raw