Search recipes (v1)
Returns one page of 20 Tasty recipes for a dish, ingredient or tags, with times, tags and the filter tags available for the search. A search with no match returns empty results.
1 credit / requestBilled only on success
Authorization
ApiKeyAuth x-api-key<token>
In: header
Query Parameters
query?string
A dish, ingredient or keyword, such as chicken, chicken rice or banana bread. Omit to browse by tags alone.
Length
length <= 200Default
""sort?string
popular (the default, as on tasty.co) ranks by popularity and pads thin keyword matches with popular recipes. latest lists only matching recipes, newest first.
Default
"popular"Value in
- "popular"
- "latest"
page?integer
One-based page of 20 recipes. A keyword search in popular order stops at page 25; use latest to page through every match.
Range
1 <= value <= 500Default
1curl -X GET "https://example.com/v1/tasty/search" \ -H "x-api-key: YOUR_API_KEY"{ "data": { "query": "chicken", "tags": [ "under_30_minutes" ], "sort": "popular", "page": 1, "page_size": 20, "total": 2492, "max_page": 25, "has_more": true, "count": 0, "stop_reason": null, "url": "https://tasty.co/search?q=chicken", "facets": { "dietary": [ { "name": "vegetarian", "display_name": "Vegetarian" } ], "meal": [ { "name": "dinner", "display_name": "Dinner" } ] }, "results": [ { "id": 2932, "slug": "one-pot-garlic-parmesan-pasta", "name": "One-Pot Garlic Parmesan Pasta", "type": "recipe", "url": "https://tasty.co/recipe/one-pot-garlic-parmesan-pasta", "thumbnail_url": "string", "total_time_minutes": 32, "prep_time_minutes": 10, "cook_time_minutes": 22, "tags": [ "italian", "easy", "dinner", "under_45_minutes" ] } ] }, "details": { "reason": "string", "message": "string" }}