FatSecret · Schema

FatSecret Recipe

A recipe in the FatSecret Platform database, including ingredients, directions, and nutrition.

Barcode ScanningCaloriesDietsExerciseFitnessFood DiaryHealthMacronutrientsNutritionRecipesWeight Tracking

Properties

Name Type Description
recipe_id string
recipe_name string
recipe_description string
recipe_url string
recipe_image string
number_of_servings string
preparation_time_min string
cooking_time_min string
rating string
recipe_types object
ingredients object
directions object
serving_sizes object
View JSON Schema on GitHub

JSON Schema

fatsecret-recipe-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/fatsecret/refs/heads/main/json-schema/fatsecret-recipe-schema.json",
  "title": "FatSecret Recipe",
  "description": "A recipe in the FatSecret Platform database, including ingredients, directions, and nutrition.",
  "type": "object",
  "required": ["recipe_id", "recipe_name"],
  "properties": {
    "recipe_id": { "type": "string" },
    "recipe_name": { "type": "string" },
    "recipe_description": { "type": "string" },
    "recipe_url": { "type": "string", "format": "uri" },
    "recipe_image": { "type": "string", "format": "uri" },
    "number_of_servings": { "type": "string" },
    "preparation_time_min": { "type": "string" },
    "cooking_time_min": { "type": "string" },
    "rating": { "type": "string" },
    "recipe_types": {
      "type": "object",
      "properties": {
        "recipe_type": {
          "oneOf": [
            { "type": "string" },
            { "type": "array", "items": { "type": "string" } }
          ]
        }
      }
    },
    "ingredients": {
      "type": "object",
      "properties": {
        "ingredient": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "food_id": { "type": "string" },
              "food_name": { "type": "string" },
              "ingredient_description": { "type": "string" },
              "number_of_units": { "type": "string" },
              "measurement_description": { "type": "string" }
            }
          }
        }
      }
    },
    "directions": {
      "type": "object",
      "properties": {
        "direction": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "direction_number": { "type": "string" },
              "direction_description": { "type": "string" }
            }
          }
        }
      }
    },
    "serving_sizes": {
      "type": "object"
    }
  }
}