データ
The Open Food Facts database is available under the Open Database License.
The individual contents of the database are available under the Database Contents License.
Products images are available under the Creative Commons Attribution ShareAlike licence.
They may contain graphical elements subject to copyright or other rights, that may in some cases be reproduced (quotation rights or fair use).
Please read Terms and conditions of use and re-use before re-using the data.
We are very interested in learning what the Open Food Facts data is used for. 必須ではありませんが、Open Food Facts コミュニティと共有できるように、再利用 について ていただければ幸いです。
Open Food Facts data exports
Database dumps and exports are generated nightly. データベースは非常に大きいため、エクスポートのフレーバーに応じて、データのさまざまな使用方法 見つけることができます。
Information on the different fields for the MongoDB dump and CSV exports is available at https://world.openfoodfacts.org/data/data-fields.txt
MongoDB dump
Data for all products is available in a MongoDB database dump.
- Link
- https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.tar.gz
- sha256sum
- https://static.openfoodfacts.org/data/sha256sum
- md5sum
- https://static.openfoodfacts.org/data/md5sum
Delta Export
Daily delta exports are provided for the previous 14 days. The list of currently available delta files can be found at
https://static.openfoodfacts.org/data/delta/index.txt.
Each line represents a file that is available at https://static.openfoodfacts.org/data/delta/{filename}
.
The filename contains UNIX timestamp of the first and the last change contained in the JSON file, so that the delta files can
be imported (after extraction) with mongoimport
in alphabetical order.
Please note that due to the nature of mongoexport
, the delta files cannot tell you about deleted products. To remove
deleted products from your database, you will need to import the full MongoDB dump.
JSONL data export
The whole database is also available in JSONL format (sometimes called LDJSON or NDJSON) where each line is a JSON object. It represents the same data as the MongoDB export. The file is compressed with gzip.
CSV Data Export
Data for all products, or some of the products, can be downloaded in CSV format (readable with OpenOffice, Excel and many other software) through the advanced search form.
- リンク
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (raw CSV)
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format)
The file encoding is Unicode UTF-8. The character that separates fields is <tab> (tabulation).
RDF Data Export
The database is also available in the RDF format. フランス語でのアナウンス.
画像データのエクスポート
すべての画像と OCR 結果は、当社のサーバーまたは AWS から (AWS オープンデータ プログラムを通じて) ダウンロードできます。 画像をダウンロードする方法の詳細については、ドキュメント 参照してください。
Live JSON and XML API
A JSON API is also available to read the data for a product. This API is in particular used in the Open Food Facts mobile app for iPhone and Android.
私たちはAPIの残業を改善しますが、後方互換性を保つように注意しています。 変更の可能性についてお知らせしますので、使用する場合は 連絡 してください。
URL to read data for a product: https://world.openfoodfacts.org/api/v0/product/[barcode].json
Example: https://world.openfoodfacts.org/api/v0/product/737628064502.json
.xml
を使用して結果を XML で取得することもできます。
例: https://world.openfoodfacts.org/api/v0/product/737628064502.xml
- API V1- Wiki で入手可能な古いドキュメント (重要な注意: このページは、読み取り用と書き込み用のサブページに分かれています)。
- API V2 - 包括的ですが、OpenAPI に準拠していません - 製品を表示するためのユースケースが含まれており、ユーザーが Nutri-Score、NOVA 分類、添加物、および Eco-Score を取得するために必要なデータを追加できるようにします。
- API V2 - 新しい OpenAPI ドキュメント - 進行中の作業
- API V2 - 新しい OpenAPI ドキュメント - 進行中の作業
You are very welcome to use the API for production cases, as long as 1 API call = 1 real scan by a user. Any attempt to scrape the database using the API will very likely be blocked, as full daily exports are available on this very page.
Also, sending an HTTP header with your API call is a good way we can get in touch, should any issue arise.
何か不明な点や質問がある場合(愚かな質問はありません) お気軽に Slack の #api チャンネルでお問い合わせください :-)
Android and iPhone mobile app
Open Food Facts モバイル アプリのコードは GitHub で入手できます。 (Android iOS )。 The app allows users to scan the barcode of products, to view the product information, and to take and submit pictures and data for missing products.
Android 用のクラシック アプリは Kotlin で開発されています。
iOS用のクラシックアプリはSwiftで開発されています。
新しいクロスプラットフォーム アプリは Dart/Flutter アプリです。
You are welcome to reuse the code (it's open source) and help us improve it, for everyone, on all the planet.
Wrappers and SDKs
We probably have a wrapper for your favorite programming language. If we do, you can use it and improve it. If we don't, you can help create it.
They will let you consume data, as well as let your users contribute new data
General principles
- 多くの有用な計算値を含む製品に関する情報を検索できます。
- If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Food Facts AI and contributors to get the computed result you want to show them.
- You can also implement the complete flow so that they get immediately the result with some effort on their side.
If your users do not expect a result immediately (e.g. Inventory apps)
- 写真を送信する (正面/栄養/材料): ユーザーにとって最も負担の少ないもの
- The Open Food Facts AI Robotoff will generate some derived data from the photos
- Over time, other apps, and the Open Food Facts community will fill the data gaps
If your users expect a result immediately (e.g. Nutrition apps)
- 栄養成分表を提出 + カテゴリー > ニュートリスコアを取得
- 原材料を提出します > NOVAグループ(食品の超加工について)、添加物、アレルゲン、正規化された食材、ビーガン、ベジタリアン…
- カテゴリ + ラベル > を送信すると、すぐにエコ スコアが表示されます (環境への影響について)
- Cordova: GitHub (old Open Food Facts official app)
- DART: GitHub - Package on pub.dev
- Elixir: GitHub
- Go: GitHub
- Java: GitHub
- Kotlin: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
- Rust: GitHub
Discussing data, API and exports
API ドキュメンテーションリポジトリでスレッドを開くことができます
お問い合わせ
For any question regarding the data, you can contact us at contact@openfoodfacts.org