Quickstart
From nothing to a recipe in three steps.
Get a key
Create an account, then create a key on your dashboard. Authentication covers the rest.
Search for a recipe
Search matches on meaning as well as wording, so this finds carbonara as readily as anything with “creamy” in the title. Replace rd_your_api_key with the key you just created.
curl 'https://api.tinyplates.dev/search?query=creamy+pasta&limit=3' \
-H 'Authorization: Bearer rd_your_api_key'Read the response
Every result is a full recipe plus a score. Times are seconds, ingredients are parsed into quantities and names, and steps are numbered. This is the same object every recipe endpoint returns — see the recipe object.
When you only need a few fields, ask for them. The response then carries those, plus id and score:
curl 'https://api.tinyplates.dev/search?query=creamy+pasta&limit=3&fields=title,url,times' \
-H 'Authorization: Bearer rd_your_api_key'Where to go next
- Filtering and vocabularies — narrow a list by cuisine, course, diet, ingredient or total time.
- Pagination — walk the whole database.
- Errors — every message the API can answer with, and what to do about it.
- The API reference — every endpoint, with a Run button.