FatSecret Food Diary API

openapi: 3.0.3
info:
  title: FatSecret Platform Exercise Diary Food Diary 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: Food Diary
  description: Daily food entries and summaries
paths:
  /food-entries/v2:
    get:
      tags:
      - Food Diary
      summary: Get food diary entries
      operationId: getFoodEntries
      parameters:
      - name: date
        in: query
        schema:
          type: string
          format: date
      responses:
        '200':
          description: Entries
    post:
      tags:
      - Food Diary
      summary: Create food diary entry
      operationId: createFoodEntry
      responses:
        '200':
          description: Created
  /food-entries/month/v2:
    get:
      tags:
      - Food Diary
      summary: Monthly food diary summary
      operationId: getFoodEntriesMonth
      parameters:
      - name: month
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Monthly summary
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