Vocabularies

The closed lists recipes are classified with: cuisines, courses, diets, allergens and units.

GET/vocabulariesAPI key

Returns the closed lists recipes are classified with. These are the values the `course`, `cuisine` and `diet` filters accept, the allergens a recipe can declare, and the units a quantity can carry. They change rarely; fetch them once and cache them.

Request

curl 'https://api.tinyplates.dev/vocabularies' \
  -H 'Authorization: Bearer rd_your_api_key'

Create an account Sign in

Parameters

This endpoint takes no parameters.

Response

allergensstring[]

The EU-declarable allergens a recipe can carry.

coursesstring[]

The values the `course` filter accepts.

cuisinesstring[]

The values the `cuisine` filter accepts.

dietsstring[]

The values the `diet` filter accepts.

unitsstring[]

The units a quantity can carry.

Example

{
  "allergens": [
    "celery",
    "crustaceans",
    "eggs",
    "fish",
    "gluten",
    "lupin",
    "milk",
    "molluscs",
    "mustard",
    "peanuts",
    "sesame",
    "soy",
    "sulphites",
    "tree-nuts"
  ],
  "courses": [
    "appetizer",
    "breakfast",
    "brunch",
    "dessert",
    "dinner",
    "drink",
    "lunch",
    "main-course",
    "side-dish",
    "snack"
  ],
  "cuisines": [
    "african",
    "american",
    "argentinian",
    "asian",
    "australian",
    "austrian",
    "belgian",
    "brazilian",
    "british",
    "cajun",
    "caribbean",
    "chinese",
    "cuban",
    "danish",
    "dutch",
    "eastern-european",
    "egyptian",
    "ethiopian",
    "filipino",
    "finnish",
    "french",
    "german",
    "greek",
    "hungarian",
    "indian",
    "indonesian",
    "iranian",
    "irish",
    "israeli",
    "italian",
    "jamaican",
    "japanese",
    "korean",
    "latin-american",
    "lebanese",
    "malaysian",
    "mediterranean",
    "mexican",
    "middle-eastern",
    "moroccan",
    "norwegian",
    "pakistani",
    "peruvian",
    "polish",
    "portuguese",
    "russian",
    "scandinavian",
    "southern-us",
    "spanish",
    "swedish",
    "swiss",
    "tex-mex",
    "thai",
    "turkish",
    "vietnamese"
  ],
  "diets": [
    "dairy-free",
    "gluten-free",
    "pescatarian",
    "vegan",
    "vegetarian"
  ],
  "units": [
    "g",
    "kg",
    "lb",
    "oz",
    "cl",
    "cup",
    "dl",
    "fl-oz",
    "gallon",
    "l",
    "ml",
    "pint",
    "quart",
    "tbsp",
    "tsp",
    "bag",
    "bottle",
    "box",
    "bunch",
    "can",
    "clove",
    "cube",
    "dash",
    "drop",
    "handful",
    "head",
    "jar",
    "leaf",
    "package",
    "piece",
    "pinch",
    "scoop",
    "sheet",
    "slice",
    "sprig",
    "stalk",
    "stick"
  ]
}

Errors

401
An API key is required. Pass it as an Authorization: Bearer header.
No key was sent, and this deployment requires one. Keys are optional today and will become required.
401
Invalid API key.
The key does not exist. Check for a truncated copy, or create a new one on your dashboard.
401
This API key has been disabled.
The key was revoked. Create a new one on your dashboard.
401
This API key has expired.
The key was created with an expiry that has passed. Create a new one.
429
Rate limit exceeded for this API key. Try again later.
The account has used its 500 requests for the day. The allowance is per account, so another key will not help. It resets at midnight UTC.