openapi: 3.1.0
info:
  title: Open Food Facts Cgi Taxonomy Suggestions API
  description: Open Food Facts is a collaborative, free, and open database of food products from around the world. The HTTP API provides read access to product data by barcode, full-text and faceted search, and access to Open Food Facts taxonomies.
  version: '2.0'
  contact:
    name: Open Food Facts
    url: https://world.openfoodfacts.org/
    email: reuse@openfoodfacts.org
  license:
    name: Open Database License (ODbL)
    url: https://opendatacommons.org/licenses/odbl/1-0/
servers:
- url: https://world.openfoodfacts.org
  description: Worldwide instance
- url: https://{country}.openfoodfacts.org
  description: Country-specific instance
  variables:
    country:
      default: world
      description: Country subdomain (e.g., us, fr, de)
tags:
- name: Taxonomy Suggestions
paths:
  /api/v3/taxonomy_suggestions:
    get:
      summary: Taxonomy autocomplete suggestions
      operationId: taxonomySuggestions
      parameters:
      - name: tagtype
        in: query
        required: true
        schema:
          type: string
      - name: string
        in: query
        schema:
          type: string
        description: Prefix to match.
      - name: lc
        in: query
        schema:
          type: string
      - name: limit
        in: query
        schema:
          type: integer
      responses:
        '200':
          description: List of taxonomy suggestions.
      tags:
      - Taxonomy Suggestions