Tiny Plates

Tiny Plates API

Read API for the recipe database. Recipes are scraped from the web, then normalized into a canonical model with structured ingredients, numbered steps, times…

Data & analytics#food--drink

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Read API for the recipe database. Recipes are scraped from the web, then normalized into a canonical model with structured ingredients, numbered steps, times in seconds, servings, nutrition, media and classification.

Documentation: https://www.tinyplates.dev/docs, where a signed-in reader can run any endpoint against this API. Create a key at https://www.tinyplates.dev.

Authentication: an API key is required. Send it as an Authorization: Bearer header. Each account may make 50 requests a day and 300 a week, counted across all of its keys.

Endpoints 16

health

  • GEThealth.check/healthHealth check that verifies the API is running. It also reports the short sha of the commit the process was built from and when it started, so a deployment can…

pantry

  • GETRank recipes by how much of them your pantry covers./pantry?ingredients=stringWhat you can cook from what you have. ingredients is the pantry: 1 to 20 comma-separated ingredient names or canonical ids. A name can be in any language the…

popular

  • GETpopular.list/popularThe most popular recipes first. Ranking favours recipes that are both well rated and rated by a lot of people, so a single five-star review will not outrank a…

recipes

  • GETFilter recipes by classification, ingredients, cooking time, total-time presets and per-serving nutrition./recipesRequires a business plan. Paginated list of recipes, newest first. Filter by cuisine, course, category, diet, equipment (all listed equipment), ingredient (a…
  • GETrecipes.byId/recipes/:idRetrieve a single recipe by its id. servings rewrites every quantity for that many servings: ranges scale with them, an ingredient with no quantity is left…
  • GETRecipes like this one, ranked on meaning, shared ingredients and cooking, and picked for variety./recipes/:id/similarRecipes like this one, for a "you might also like" list next to a recipe. Candidates come from the meaning of the recipe and are ranked on that, the…

root

  • GETroot.index/What this API is and where to read about it, as plain text. Needs no API key.

search

  • GETsearch.search/search?query=stringSearch recipes by name, ingredients and description. Matches on meaning as well as wording, so a search for "creamy pasta" also finds carbonara. Use the…

shoppingList

  • GETConsolidate several recipes into one list, grouped by aisle./shopping-list?recipes=stringOne shopping list for several recipes. recipes is a comma-separated list of recipe ids, each optionally followed by a colon and the servings to cook —…

ingredients

  • GETingredients.list/ingredientsRequires a business plan. The canonical ingredient vocabulary, most used first. Use an id as the ingredient filter of /recipes.
  • GETCanonical ids for ingredient names, in any language./ingredients/resolve?names=stringTurns ingredient names into canonical ids. names is a comma-separated list of names as a cook or a recipe writes them. A name matches its own id or canonical…
  • GETingredients.byId/ingredients/:idRetrieve a single ingredient by its canonical id. Use /ingredients/resolve to turn a name into one. Carries the regulated allergen features and diets once the…
  • GETWhat an ingredient is most often cooked with./ingredients/:id/pairingsThe ingredients that recipes most often use together with this one, counted from the recipes the API serves, for "what goes with X" or to fill in a dish. Each…
  • GETingredients.vocabularies/vocabulariesThe closed lists recipes are classified with: cuisines, courses, diets, EU and US regulated allergen features, and units.

status

  • GETstatus.read/statusHow much data the API is serving: the number of recipes and sites available, and how far collection has progressed across the pages they came from.

substitutions

  • GETWhat to use instead, in what amount, and when not to./substitutions?ingredients=stringWhat to use instead of an ingredient. ingredients is a comma-separated list of ingredient names or canonical ids. Each option says how much to use for one…

API details

Base URL
https://api.tinyplates.dev
http://localhost:6891
Authentication
A bearer token in the Authorization header
Operations
16 operations on 16 pathsGET 16
Main resources
ingredients 5recipes 3health 1pantry 1popular 1root 1search 1shoppingList 1status 1substitutions 1
Response formats
application/json text/plain
Description format
OpenAPI 3.1.0, API version 2.1.0

How to test the Tiny Plates API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Tiny Plates API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “health.check” (GET /health), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Tiny Plates API?

Read API for the recipe database. Recipes are scraped from the web, then normalized into a canonical model with structured ingredients, numbered steps, times… It is listed under Data & analytics and has 16 endpoints.

Who publishes the Tiny Plates API?

It is listed from Tiny Plates's public API description (an OpenAPI document), not published by Tiny Plates on Swastik Codes. Anyone who controls tinyplates.dev can claim the profile by adding a DNS TXT record.

What is the base URL of the Tiny Plates API?

Its description lists 2 base URLs: https://api.tinyplates.dev, http://localhost:6891. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the Tiny Plates API?

With A bearer token in the Authorization header.

How many endpoints does the Tiny Plates API have?

16 operations on 16 paths (16 GET). The largest groups are ingredients, recipes, health, pantry.

Is forking the Tiny Plates API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.