Free Recipe API

Free Recipe API Support
The API and site will always remain free at point of access.

Test API Keys
You can use the test API key "1" during development of your app or for educational use (see test links below).
However you must become a supporter if releasing publicly on an appstore.

API Production Key Upgrade
All supporters have access to the beta version of the API which allows mutiple ingredient filters.
You also get access to adding your own meals and images. You can also list the full database rather than limited to 100 items.
Please sign up on Paypal and we will email you the upgraded API key.

Contact
Email: [email protected]

V1 API

API Methods using the developer test key '1' in the URL

Search meal by name

www.themealdb.com/api/json/v1/1/search.php?s=Arrabiata

List all meals by first letter

www.themealdb.com/api/json/v1/1/search.php?f=a

Lookup full meal details by id

www.themealdb.com/api/json/v1/1/lookup.php?i=52772

Lookup a single random meal

www.themealdb.com/api/json/v1/1/random.php

Lookup a selection of 10 random meals

*Premium API Only
www.themealdb.com/api/json/v1/1/randomselection.php

List all meal categories

www.themealdb.com/api/json/v1/1/categories.php

Latest Meals

*Premium API Only
www.themealdb.com/api/json/v1/1/latest.php

List all Categories, Area, Ingredients

www.themealdb.com/api/json/v1/1/list.php?c=list
www.themealdb.com/api/json/v1/1/list.php?a=list
www.themealdb.com/api/json/v1/1/list.php?i=list

Filter by main ingredient

www.themealdb.com/api/json/v1/1/filter.php?i=chicken_breast

Filter by multi-ingredient

*Premium API Only
www.themealdb.com/api/json/v1/1/filter.php?i=chicken_breast,garlic,salt

Filter by Category

www.themealdb.com/api/json/v1/1/filter.php?c=Seafood

Filter by Area

www.themealdb.com/api/json/v1/1/filter.php?a=Canadian

Meal Thumbnail Images

Add /preview to the end of the meal image URL
/images/media/meals/llcbn01574260722.jpg/small
/images/media/meals/llcbn01574260722.jpg/medium
/images/media/meals/llcbn01574260722.jpg/large

Ingredient Thumbnail Images

*URL's match the ingredient name with an underscore for any spaces.

www.themealdb.com/images/ingredients/Lime.png
www.themealdb.com/images/ingredients/Lime-Small.png
www.themealdb.com/images/ingredients/Lime-Medium.png
www.themealdb.com/images/ingredients/Lime-Large.png