fatsecret OAuth Scopes

generated: '2026-08-12'
method: searched
source: https://platform.fatsecret.com/docs/guides/authentication/oauth2
docs: https://platform.fatsecret.com/docs/guides/authentication/oauth2
note: >-
  Upgraded from derived to searched on 2026-08-12. The OpenAPI declares only two scopes (basic,
  premier); the provider's OAuth 2.0 guide documents SEVEN. The five the spec omits — barcode,
  localization, nlp, image-recognition, feedback — gate exactly the capabilities fatsecret sells as
  add-ons, so a client built from the spec alone will hit error 14 ("Missing scope") on the
  barcode, image-recognition and NLP methods with no indication why.
schemes:
  - name: oauth2
    source: openapi/_original/fatsecret-platform-openapi.yml
    flows:
      - flow: clientCredentials
        tokenUrl: https://oauth.fatsecret.com/connect/token
    openid_configuration: https://oauth.fatsecret.com/.well-known/openid-configuration
  - name: oauth1
    source: openapi/_original/fatsecret-platform-openapi.yml
    note: >-
      OAuth 1.0a 3-legged is used for member/profile data and carries no scope surface — the member
      authorization itself is the grant.
scopes:
  - scope: basic
    description: Basic access to food and recipe data
    flows: [clientCredentials]
    sources: [openapi/_original/fatsecret-platform-openapi.yml, https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: premier
    description: Premier access, including the enriched food data and global datasets sold on the Premier editions
    flows: [clientCredentials]
    sources: [openapi/_original/fatsecret-platform-openapi.yml, https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: barcode
    description: UPC / GTIN-13 barcode lookup (food.find_id_for_barcode)
    flows: [clientCredentials]
    sources: [https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: localization
    description: Region and language filtering of results across 200+ regions and 25 languages
    flows: [clientCredentials]
    sources: [https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: nlp
    description: Natural Language Processing — parse a free-text description of what was eaten into foods
    flows: [clientCredentials]
    sources: [https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: image-recognition
    description: Image Recognition — identify foods from an uploaded photo
    flows: [clientCredentials]
    sources: [https://platform.fatsecret.com/docs/guides/authentication/oauth2]
  - scope: feedback
    description: Feedback submission on API results
    flows: [clientCredentials]
    sources: [https://platform.fatsecret.com/docs/guides/authentication/oauth2]
scope_count: 7
missing_from_spec: [barcode, localization, nlp, image-recognition, feedback]