Open Food Facts

Open Food Facts API v3

Version 3 of the Open Food Facts HTTP API — the current recommended version, with standardized response envelopes, the v3.3 image structure and taxonomy-suggestion endpoints. Published by the project as an OpenAPI 3.1 document and marked "under development" by its own info block.

GitHub OpenAPI

Operations 12

GET /api/v3/product/{code} Get Product Data #
PATCH /api/v3/product/{code} Create or Update Product #
POST /api/v3/product/{code}/images Upload Product Image #
DELETE /api/v3/product/{code}/images/uploaded/{imgid} Delete Product Image #
GET /api/v3/taxonomy_canonicalize_tags Get canonical tags for a list of local tags #
GET /api/v3/taxonomy_display_tags Get display tags in a specific language for a list of taxonomy tags #
GET /api/v3/taxonomy_suggestions Get Taxonomy Suggestions #
GET /api/v3/tag/{tagtype}/{tag_or_tagid} Get Tag Knowledge Panels #
POST /api/v3/product_revert Revert Product to Previous Revision #
GET /api/v3/external_sources List external knowledge panel sources (JSON) #
GET /api/v3/preferences Get List of Preference Importance Values #
GET /api/v3.4/attribute_groups Get List of Attribute Groups and Attributes #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/openapi/open-food-facts-api-v3-openapi.yml
⚙
OpenAPI
https://openfoodfacts.github.io/openfoodfacts-server/api/ref/api-v3.yaml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/overlays/open-food-facts-api-v3-overlay.yaml
🔗
ChangeLog
https://openfoodfacts.github.io/openfoodfacts-server/api/ref-api-and-product-schema-change-log/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/open-food-facts-api-v3"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

open-food-facts-api-v3-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Open Food Facts Open API V3 - under development
  description: 'As a developer, the Open Food Facts API allows you to get information

    and contribute to the products database. You can create great apps to

    help people make better food choices and also provide data to enhance the database.


    **IMPORTANT**: Please read the [API introduction](https://openfoodfacts.github.io/openfoodfacts-server/api/) before using
    this API.


    **WARNING** v3 is under development and you should expect changes


    The current version of API v3 is v3.4

    See the [change log for the API and product schema](../ref-api-and-product-schema-change-log.md)

    '
  termsOfService: https://world.openfoodfacts.org/terms-of-use
  contact:
    name: Open Food Facts
    url: https://slack.openfoodfacts.org/
    email: reuse@openfoodfacts.org
  license:
    name: License (MIT, Apache 2.0, etc)
    url: https://opendatacommons.org/licenses/odbl/summary/index.html
  version: '3'
servers:
- url: https://world.openfoodfacts.org
  description: prod


# --- truncated at 32 KB (1193 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/open-food-facts/refs/heads/main/openapi/open-food-facts-api-v3-openapi.yml