Similar recipes
Recipes like the one a reader is looking at, served as the same course and keeping to its diet, with a score and the ingredients the two share.
/recipes/{id}/similarAPI keyReturns recipes like the one you name, most similar first, for a "you might also like" row on a recipe page. Similarity starts from what the recipes are about, then counts the ingredients they share (a rare one such as gochujang counts for more than garlic), the cuisine, the techniques and the time they take. A similar recipe is served as the same course, and keeps to the vegan, vegetarian or pescatarian diet the recipe keeps to. Copies of the recipe from other sites are left out, and the list mixes dishes rather than repeating one. A recipe that has only just been collected may not be searchable yet and returns an empty list.
Request
curl 'https://api.tinyplates.dev/recipes/6a9820e58f8122ec891b68a4/similar?limit=3' \
-H 'Authorization: Bearer rd_your_api_key'Sign in to run this request with your own key. Free, 50 requests a day and 300 a week.
Parameters
idstringrequiredThe recipe id, from a list or search response.
dietslugOnly return recipes known to suit this diet as well, declared by the site or inferred from the required ingredients. A recipe with an unknown flag is left out.
5 allowed values
dairy-freegluten-freepescatarianveganvegetarianlanguagestringOnly return recipes written in this language, as a two-letter ISO 639-1 code. Defaults to the language of the recipe.
limitintegerdefaults to101–20How many recipes to return. A value over 20 returns 20.
withoutstringLeave out recipes that contain any listed allergen feature (comma-separated ids from /vocabularies). Only recipes whose `allergens` value is `false` for every listed feature are returned, so the list can be shorter than `limit`. Informational, not medical advice. An unknown feature returns 400.
Response
recipes[]object[]
recipes[]object[]allergensobjectoptional
allergensobjectoptional<allergen>booleanOne key per allergen identifier from GET /vocabularies, such as "milk" or "gluten-cereals": true when the recipe contains it.
disclaimerstringThe required informational-use warning.
Whether the recipe contains each EU and US regulated allergen: one true or false for each of the 16 allergen identifiers, keyed by identifier, beside the disclaimer. Informational only; verify product labels before serving someone with an allergy.
authorobjectoptionalWho wrote the recipe, and a link to them when the site published one.
categoriesstring[]Normalized category slugs from an open set, such as "pasta" or "soup". The value the `category` filter takes.
coursesstring[]Course slugs from the closed list. The value the `course` filter takes.
createdAtstringWhen the recipe first entered the database. ISO 8601.
cuisinesstring[]Cuisine slugs from the closed list. The value the `cuisine` filter takes.
descriptionstringoptionalThe recipe’s own summary.
dietaryobjectoptionalDietary flags, declared by the site or inferred from the required ingredients. A declared flag wins; a missing flag is unknown, and false is a known no. An inferred `glutenFree` or `dairyFree` can disagree with `allergens` by design: the diet reads the required ingredients, so a dish is gluten-free once the optional pita is left out, while the allergen block counts every line and stays cautious.
equipmentstring[]optionalEquipment the recipe calls for, as words rather than slugs.
groupsstring[]The section headers of the recipe: the distinct `group` values of the ingredients and then the steps, in the order they first appear. Empty when the recipe has no sections.
idstringThe recipe id.
ingredients[]object[]
ingredients[]object[]displaystringThe line to render. Equal to the source line until the structure and the source part company — a converted unit, an amount enrichment filled in.
groupstringoptionalThe section header the line sat under, such as "For the sauce".
ingredientIdstringoptionalThe canonical ingredient id, such as "chicken-thigh". Absent until the recipe has been enriched, or when the name could not be resolved. This is the value the `ingredient` filter of GET /recipes takes.
localNamestringoptionalThe ingredient as this recipe’s own language names it, when that differs from `name`.
localPreparationstringoptionalHow the ingredient is prepared, in the recipe’s own words, such as "finhackade" where `preparation` says "finely chopped". Absent on an English recipe, where `preparation` already is the reader’s, and on a line that says nothing of the kind. `display` is written with this one.
namestringThe canonical English name.
notestringoptionalAnything the parser understood but could not place, such as "(400 g)". Kept as the source wrote it, in the recipe’s language, and never translated.
optionalbooleanWhether the recipe marks this ingredient as optional.
originalstringThe source line, verbatim. Rewriting a recipe — scaling it, converting its units — leaves this alone.
preparationstringoptionalHow the ingredient is prepared, in English, such as "finely chopped". Read `localPreparation` for the words the recipe itself uses.
quantityobjectoptional
quantityobjectoptionalmaxnumberoptionalThe top of a range.
unitstringoptionalOne of the units listed by GET /vocabularies.
valuenumberThe amount itself.
The amount. A range such as "2-3 tomatoes" is a value of 2 with a max of 3. A value with no unit is a count of pieces.
sizestringoptionalA size qualifier, such as "large".
One ingredient line, parsed. `original` is the line the site published; `display` is the same line written back from these fields, in the recipe’s own language.
instructions[]object[]
instructions[]object[]durationobjectoptional
durationobjectoptionalsecondsintegerSeconds.
A length of time. Always seconds, never a formatted string.
equipmentstring[]optionalEquipment slugs the step calls for.
groupstringoptionalThe section the step sat under or, where the page named no section, the heading the step carried of its own.
ingredientsstring[]optionalCanonical ingredient ids the step uses.
stepintegerThe step number. Steps always run 1, 2, 3… in order.
techniquesstring[]optionalTechnique slugs the step uses, such as "saute".
temperatureobjectoptionalAn oven or pan temperature, with its unit as "C" or "F".
textstringThe step text.
One step. The text is authoritative; everything else on a step comes from enrichment and may be absent.
languagestringThe language the recipe is written in, as a two-letter ISO 639-1 code.
media[]object[]
media[]object[]altstringoptionalAlternative text.
captionstringoptionalA caption published with the item.
idstringUnique within the recipe.
rolestringWhere the item sits in the recipe.
stepintegeroptionalFor role "step", the step number the item illustrates.
typestring"image" or "video".
urlstringThe file itself.
variantsobject[]optionalThe same photo in other sizes or crops. Images only.
Images and videos. An image carries a `role` of hero, gallery, step or thumbnail; a video carries gallery or step. A recipe has at most one hero image. Media belongs to its publisher: we return the URLs, but showing them in your app needs the publisher’s permission.
notesstring[]optionalWhat the writer added beside the method: storage, make-ahead, substitutions. One entry per note, in the order the page wrote them.
nutritionobjectoptional
nutritionobjectoptionalbasisobjectWhat the numbers are per. `type` is "serving", "recipe" or "100g"; `servings` is the serving count the site worked the numbers out on, which is not always the serving count the recipe is written for; `description` is the serving size the site named, such as "1 cup".
caloriesobjectoptionalEnergy, with its unit.
carbohydratesobjectoptionalCarbohydrates.
fatobjectoptionalFat.
fiberobjectoptionalFibre.
micronutrientsobjectoptionalAnything else the source declared, keyed by nutrient slug.
proteinobjectoptionalProtein.
saturatedFatobjectoptionalSaturated fat.
sodiumobjectoptionalSodium.
sourcestring"provided": the site published these numbers itself, in the structured data the recipe was read from, so they are as current as the last read of that page.
sugarobjectoptionalSugar.
Nutrition as the site published it. `basis` says whether the numbers are per serving, per recipe or per 100 g. The API does not compute nutrition from the ingredients, so a recipe whose site publishes none has no nutrition object at all.
ratingobjectoptionalThe rating the source published, with how many people rated it.
servingsobjectoptionalHow much the recipe makes. "Serves 4-6" is a quantity of 4 with a max of 6; "Makes 24 cookies" is a quantity of 24 with a unit of "cookie".
tagsstring[]The source site’s own keywords, cleaned but not mapped to any vocabulary.
techniquesstring[]optionalTechniques the recipe uses, as words rather than slugs.
textobject
textobjectingredientsstring[]One line per ingredient.
instructionsstring[]One line per step.
The recipe as plain lines: every ingredient’s `display` and every step’s `text`, in order. A convenience for rendering; nothing here is missing from the structured fields.
timesobject
timesobjectcookobjectoptional
cookobjectoptionalsecondsintegerSeconds.
A length of time. Always seconds, never a formatted string.
inactiveobjectoptional
inactiveobjectoptionalsecondsintegerSeconds.
A length of time. Always seconds, never a formatted string.
prepobjectoptional
prepobjectoptionalsecondsintegerSeconds.
A length of time. Always seconds, never a formatted string.
totalobjectoptional
totalobjectoptionalsecondsintegerSeconds.
A length of time. Always seconds, never a formatted string.
Preparation, cooking, inactive and total time, each in seconds.
titlestringThe recipe title.
updatedAtstringWhen the recipe was last written. ISO 8601.
urlstringThe page the recipe was read from. One source URL is one recipe.
similarityScorenumberHow similar this recipe is to the one you named, from 0 to 1. Compare it with the others in the same response rather than reading it as an absolute.
sharedIngredientsstring[]The ingredients this recipe shares with the one you named, as this recipe names them. Staples such as salt and oil, and optional lines, are left out.
The similar recipes, most similar first.
Example
{
"recipes": [
{
"id": "6a980d75ea7517554c2894b1",
"allergens": {
"celery": false,
"crustaceans": false,
"eggs": false,
"fish": false,
"gluten-cereals": false,
"lupin": false,
"milk": true,
"molluscs": false,
"mustard": false,
"nuts-eu": false,
"peanuts": true,
"sesame": false,
"soy": false,
"sulphites": false,
"tree-nuts-us": false,
"wheat": false,
"disclaimer": "Informational only; not medical advice. Verify ingredients and product labels before serving someone with an allergy."
},
"createdAt": "2026-09-02T11:50:13.886Z",
"dietary": {
"glutenFree": true,
"vegetarian": true
},
"instructions": [
{
"equipment": [
"oven"
],
"step": 1,
"temperature": {
"unit": "F",
"value": 325
},
"text": "Preheat oven to 325°."
},
{
"ingredients": [
"roma-tomato"
],
"step": 2,
"techniques": [
"slicing"
],
"text": "Slice tomatoes in half."
},
{
"ingredients": [
"salt",
"basil",
"oregano",
"thyme"
],
"step": 3,
"techniques": [
"seasoning"
],
"text": "Season with salt, basil, oregano and thyme."
},
{
"equipment": [
"baking-sheet"
],
"ingredients": [
"olive-oil",
"roma-tomato"
],
"step": 4,
"techniques": [
"spraying"
],
"text": "Spray a cookie sheet with olive oil spray and place tomatoes cut side up."
},
{
"duration": {
"seconds": 7200
},
"equipment": [
"oven"
],
"ingredients": [
"roma-tomato"
],
"step": 5,
"techniques": [
"baking"
],
"text": "Bake 2 hrs until skin gets wrinkled and crusty on the bottom and moist in the center."
},
{
"equipment": [
"food-processor"
],
"ingredients": [
"roma-tomato"
],
"step": 6,
"techniques": [
"pureeing"
],
"text": "Puree the tomatoes in a food processor."
},
{
"step": 7,
"text": "If it is too thick, you can thin with pasta water."
},
{
"ingredients": [
"roma-tomato"
],
"step": 8,
"text": "Serve over your favorite high fiber pasta and grated cheese."
}
],
"language": "en",
"media": [
{
"id": "hero",
"role": "hero",
"type": "image",
"url": "https://www.skinnytaste.com/wp-content/uploads/2008/08/roasted-tomatoe-sauce.jpg",
"variants": [
{
"url": "https://www.skinnytaste.com/wp-content/uploads/2008/08/roasted-tomatoe-sauce-425x270.jpg"
}
]
}
],
"nutrition": {
"basis": {
"type": "serving"
},
"calories": {
"unit": "kcal",
"value": 78.1
},
"carbohydrates": {
"unit": "g",
"value": 17.3
},
"fat": {
"unit": "g",
"value": 1.2
},
"fiber": {
"unit": "g",
"value": 4.1
},
"protein": {
"unit": "g",
"value": 3.2
},
"source": "provided"
},
"rating": {
"count": 1,
"reviewCount": 1,
"value": 5
},
"servings": {
"original": "4 servings",
"quantity": 4
},
"times": {},
"title": "Candied Tomato Sauce",
"updatedAt": "2026-09-06T01:39:14.527Z",
"categories": [],
"courses": [],
"cuisines": [
"italian"
],
"groups": [],
"ingredients": [
{
"display": "12 ripe Roma tomatoes",
"localName": "Roma tomatoes",
"ingredientId": "roma-tomato",
"name": "Roma tomato",
"optional": false,
"original": "12 ripe Roma tomatoes",
"quantity": {
"value": 12
},
"size": "ripe"
},
{
"display": "salt",
"localName": "salt",
"ingredientId": "salt",
"name": "salt",
"note": "to taste",
"optional": false,
"original": "salt to taste"
},
{
"display": "1 tsp thyme",
"localName": "thyme",
"ingredientId": "thyme",
"name": "thyme",
"optional": false,
"original": "1 tsp thyme",
"quantity": {
"unit": "tsp",
"value": 1
}
},
{
"display": "1 tsp oregano",
"localName": "oregano",
"ingredientId": "oregano",
"name": "oregano",
"optional": false,
"original": "1 tsp oregano",
"quantity": {
"unit": "tsp",
"value": 1
}
},
{
"display": "olive oil spray",
"localName": "olive oil",
"ingredientId": "olive-oil",
"name": "olive oil",
"optional": false,
"original": "olive oil spray",
"preparation": "spray"
},
{
"display": "2 tbsp basil, chopped",
"localName": "basil",
"ingredientId": "basil",
"name": "basil",
"optional": false,
"original": "2 tbsp basil, chopped",
"preparation": "chopped",
"quantity": {
"unit": "tbsp",
"value": 2
}
}
],
"tags": [
"freezer meals",
"gluten free",
"vegetarian meals"
],
"text": {
"ingredients": [
"12 ripe Roma tomatoes",
"salt",
"1 tsp thyme",
"1 tsp oregano",
"olive oil spray",
"2 tbsp basil, chopped"
],
"instructions": [
"Preheat oven to 325°.",
"Slice tomatoes in half.",
"Season with salt, basil, oregano and thyme.",
"Spray a cookie sheet with olive oil spray and place tomatoes cut side up.",
"Bake 2 hrs until skin gets wrinkled and crusty on the bottom and moist in the center.",
"Puree the tomatoes in a food processor.",
"If it is too thick, you can thin with pasta water.",
"Serve over your favorite high fiber pasta and grated cheese."
]
},
"url": "https://www.skinnytaste.com/candied-tomato-sauce-0-ww-pts/",
"equipment": [
"baking sheet",
"food processor",
"oven"
],
"techniques": [
"baking",
"pureeing",
"seasoning",
"slicing",
"spraying"
],
"sharedIngredients": [
"Roma tomatoes"
],
"similarityScore": 0.712
}
]
}Errors
- 404
recipe_not_found
Recipe not found.
No recipe has that id. Ids are opaque strings from a list or search response, not slugs.
- 400
invalid_parameter
The "diet" parameter must be one of dairy-free, gluten-free, pescatarian, vegan, vegetarian; got "paleo".
A parameter was not a value the API accepts. The message names the parameter, the value it was given and where the allowed values are listed.
- 400
invalid_parameter
The "language" parameter must be a two-letter code such as "en" or "sv"; got "english".
A parameter was not a value the API accepts. The message names the parameter, the value it was given and where the allowed values are listed.
- 400
invalid_parameter
The "without" parameter must be a comma-separated list of allergen features from GET /vocabularies, such as "milk,peanuts"; got "dairy".
A parameter was not a value the API accepts. The message names the parameter, the value it was given and where the allowed values are listed.
- 401
api_key_required
An API key is required. Pass it as an Authorization: Bearer header.
No key was sent. Every endpoint except the root, /health, /docs and /openapi.json requires one.
- 401
invalid_api_key
Invalid API key.
The key does not exist. Check for a truncated copy, or create a new one on your dashboard.
- 401
api_key_disabled
This API key has been disabled.
The key was revoked. Create a new one on your dashboard.
- 401
api_key_expired
This API key has expired.
The key was created with an expiry that has passed. Create a new one.
- 429
daily_limit_reached
Daily limit of 50 requests on the Free plan reached. It resets at midnight UTC. Paid plans include more; see https://www.tinyplates.dev/pricing.
The account has used its plan's limit for the day. The message names the plan and the number, which differ between accounts. The limit is per account, so another key will not help. It resets at midnight UTC, and the Retry-After header says how many seconds away that is.
- 429
weekly_limit_reached
Weekly limit of 300 requests on the Free plan reached. It covers the last 7 days. Paid plans include more; see https://www.tinyplates.dev/pricing.
The account has used its weekly limit over the last 7 days, today included. The message names the plan and the number. Room comes back as older days drop out of the window, at midnight UTC; the Retry-After header says how many seconds away that is.
- 500
internal_error
Something went wrong. Please try again.
The API could not answer. The request was not your fault; retry it, and report it if it keeps happening.