FatSecret Reference API

Reference data for brands, categories, and exercises

OpenAPI Specification

fatsecret-reference-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: FatSecret Platform Exercise Diary Reference API
  description: The FatSecret Platform API provides programmatic access to a global food nutrition database covering more than 1.9 million verified food items across 56 countries. It supports food and recipe search, barcode scanning, image recognition, natural language processing, and full profile-based food diary, exercise diary, and weight tracking management.
  version: '3.0'
  contact:
    name: FatSecret Platform
    url: https://platform.fatsecret.com/platform-api
servers:
- url: https://platform.fatsecret.com/rest
  description: REST endpoint for URL-based and method-based integration
security:
- oauth2: []
- oauth1: []
tags:
- name: Reference
  description: Reference data for brands, categories, and exercises
paths:
  /food-brands/v2:
    get:
      tags:
      - Reference
      summary: List food brands
      operationId: listFoodBrands
      responses:
        '200':
          description: Brands
  /food-categories/v2:
    get:
      tags:
      - Reference
      summary: List food categories
      operationId: listFoodCategories
      responses:
        '200':
          description: Categories
  /food-sub-categories/v2:
    get:
      tags:
      - Reference
      summary: List food sub-categories
      operationId: listFoodSubCategories
      responses:
        '200':
          description: Sub-categories
  /exercises/v2:
    get:
      tags:
      - Reference
      summary: List exercises
      operationId: listExercises
      responses:
        '200':
          description: Exercises
components:
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://oauth.fatsecret.com/connect/token
          scopes:
            basic: Basic access to food and recipe data
            premier: Premier access including image recognition and NLP
    oauth1:
      type: http
      scheme: oauth
      description: OAuth 1.0a request signing