Open Food Facts の支援者になってください
毎月、私たちは800万人の訪問者にサービスを提供し、API経由ではその何倍もの利用があります。あなたの支援は次のために不可欠です:
-
Open Food Facts を誰にでも開かれた状態で維持すること、
- 小規模な常設チームでインフラ、ウェブサイト、モバイルアプリ、APIを支えること
-
食品業界から独立し、
-
コミュニティを支えること
-
科学を支えること
データ
再利用の条件
Open Food Facts データベースは、 オープン データベース ライセンスに基づいて利用できます。
データベースの個々のコンテンツは、 データベース コンテンツ ライセンスに基づいて利用できます。
これらには著作権またはその他の権利の対象となるグラフィック要素が含まれる場合がありますが、場合によっては複製が認められる場合があります（引用権または公正使用）。
データを再利用する前に、 利用規約と再利用に関する条項 をお読みください。
再利用について教えてください
私たちは、Open Food Facts データが何に使用されているかを知りたいと思っています。 必須ではありませんが、再利用について お知らせいただければ 、Open Food Facts コミュニティと共有させていただきます。 また、 このフォームに記入 して、アプリが特集されるチャンスを得ることもできます。
オープンフードファクトデータのエクスポート
データベースのダンプとエクスポートは毎晩生成されます。 データベースは非常に大きいため、エクスポートのフレーバーに応じて、データのさまざまな使用方法 見つけることができます。
MongoDBダンプとCSVエクスポートのさまざまなフィールドに関する情報は、 https://world.openfoodfacts.org/data/data-fields.txtで入手できます。
MongoDB ダンプ
すべての製品のデータは、MongoDB データベース ダンプで入手できます。
- リンク
- https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
- sha256sum
- https://static.openfoodfacts.org/data/gz-sha256sum
- md5sum
- https://static.openfoodfacts.org/data/gz-md5sum
デルタエクスポート
過去 14 日間の毎日のデルタ エクスポートが提供されます。 現在利用可能なデルタファイルのリストは、 https://static.openfoodfacts.org/data/delta/index.txtにあります。
各行は、 https://static.openfoodfacts.org/data/delta/{filename}で入手できるファイルを表します。
ファイル名には、JSON ファイルに含まれる最初の変更と最後の変更の UNIX タイムスタンプが含まれているため、デルタ ファイルは (抽出後に) mongoimport を使用してアルファベット順にインポートできます。
mongoexportの性質上、デルタ ファイルでは削除された製品に関する情報を取得できないことに注意してください。 削除された製品をデータベースから削除するには、MongoDB ダンプ全体をインポートする必要があります。
JSONLデータのエクスポート
データベース全体は、各行が JSON オブジェクトである JSONL 形式 (LDJSON または NDJSON と呼ばれることもあります) でも利用できます。 これは MongoDB エクスポートと同じデータを表します。 ファイルは gzip で圧縮されています。
データベースを活用する適切な方法は、DuckDBを使用することです。 これは、大量のデータを数秒で処理するために設計されたインプロセス分析ツールです。 DuckDBを使用してOpen Food Factsデータベースを探索および処理する方法について説明した ブログ投稿 をお読みください。
Hugging FaceでのParquetデータエクスポート
JSONL ダンプの簡略化されたバージョンは、 Parquet 形式でも利用できます。 変換中に、重複した情報を含む列、内部デバッグに使用される列、またはユーザーにとって無関係な列をフィルターしました。
Parquet 形式は便利であることが証明されています。
- Data is organized by column, rather than by row, which saves storage space and speeds up analytics queries, i.e. you can select just the columns you care about, optimizing query performances, even on entry-level computers.
- Highly efficient data compression and decompression, making it good for storing and sharing big datasets of any kind,
- Supports complex data types and advanced nested data structures.
The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.
Find more information in the Wiki, including guidelines for data reuse and example queries to get started.
CSVデータのエクスポート
すべての製品または一部の製品のデータは、 詳細検索フォームを通じて CSV 形式 (LibreOffice、Excel、その他の多くのスプレッドシート ソフトウェアで読み取り可能) でダウンロードできます。
- リンク
- 食品: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (GZIP 形式で圧縮された CSV: 約 0.9 Gb、非圧縮: 約 9 Gb)
- 化粧品: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz
- ペットフード: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz
- その他すべての製品: https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz
ファイルのエンコーディングは Unicode UTF-8 です。 フィールドを区切る文字は <tab> (タブ) です。
RDFデータのエクスポート
データベースは RDF 形式でも利用できます (これは実験段階であり、現在は積極的にメンテナンスされていません)。 のお知らせはフランス語で読むことができます。
画像データのエクスポート
すべての画像と OCR 結果は、当社のサーバーから、または AWS (AWS オープンデータプログラム経由) からダウンロードできます。 画像のダウンロード方法の詳細については、ドキュメントをご覧ください
ライブ JSON および XML API
製品のデータを読み取るための JSON API も利用できます。 この API は特に Open Food Facts モバイル アプリで使用されます。
私たちはAPIの残業を改善しますが、後方互換性を保つように注意しています。 ご使用の場合は、潜在的な変更についてお知らせできるよう、 ご連絡ください 。
APIをご覧くださいAPIとOpenAPIドキュメントの改善に貢献する
私たちは、API のドキュメントを完成させ、ユースケースを追加し、SDK の生成を自動化したいと考えています。 OpenAPI の専門家であれば、ぜひ協力していただければ幸いです。
1 回の API 呼び出し = ユーザーによる 1 回の実際のスキャンである限り、本番環境で API を自由に使用できます。 完全な毎日のエクスポートがこのページで利用できるため、API を使用してデータベースをスクレイピングする試みはブロックされる可能性が非常に高くなります。 完全な毎日のエクスポートがこのページで利用できるため、API を使用してデータベースをスクレイピングする試みはブロックされる可能性が非常に高くなります。 完全な毎日のエクスポートがこのページで利用できるため、API を使用してデータベースをスクレイピングする試みはブロックされる可能性が非常に高くなります。
また、API 呼び出しで HTTP ヘッダーを送信すると、問題が発生した場合に連絡を取ることができます。
XML API（サポートされていません）
.xml を使用して結果を XML で取得することもできます。
例: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
この API は積極的にメンテナンスされておらず、公式に文書化されていません。ラッパーとSDK
あなたのお気に入りのプログラミング言語用のラッパーがおそらくあるでしょう。 もしそうなら、それを使用して改善することができます。 もしそうでないなら、あなたがそれを作るのを手伝うことができます。
データの消費だけでなく、ユーザーが新しいデータを投稿できるようにもなります
ユーザーを満足させるための一般原則
- You can search for information about products, including many useful computed values.
- 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.
ユーザーがすぐに結果を期待していない場合（例：在庫管理アプリ）
- Submit photos (front/nutrition/ingredients): most painless thing for your users
- 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
ユーザーがすぐに結果を期待している場合（例：栄養アプリ）
- Submit nutrition facts + category > get Nutri-Score
- Submit ingredients > get the NOVA group (about food ultra-processing), additives, allergens, normalized ingredients, vegan, vegetarian…
- Submit category + labels > soon get the Eco-Score (about environmental impact)
AndroidおよびiPhoneモバイルアプリ
Open Food Facts モバイル アプリのコードは、GitHub (Flutter、 Kotlin Android および Swift iOS) で入手できます。
廃止予定の Kotlin および Swift コードベースを Kotlin および Swift SDK に変換する予定ですので、ご協力をお待ちしています :-)
(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.
コードを再利用して（オープンソースなので）、地球上のすべての人々のためにコードの改善にご協力ください。
SDK
| アイコン | 言語 / フレームワーク | リソース | 議論 |
|---|---|---|---|
| Cordova（旧アプリ） | GitHub | 該当なし | |
| ダート | GitHub pub.dev | 該当なし | |
| エリクサー | GitHub | Slackチャンネル | |
| 行く | GitHub | Slackチャンネル | |
| ジャワ | GitHub | Slackチャンネル | |
| スプリングブート | GitHub | Slackチャンネル | |
| コトリン | GitHub | Slackチャンネル | |
| JavaScript | GitHub | Slackチャンネル | |
| PHP | GitHub | Slackチャンネル | |
| PHP（ララベル） | GitHub | Slackチャンネル | |
| パイソン | GitHub | Slackチャンネル | |
| リアクトネイティブ | GitHub | Slackチャンネル | |
| ルビー | GitHub | Slackチャンネル | |
| 赤茶色 | GitHub | Slackチャンネル | |
| R | GitHub | Slackチャンネル | |
| 迅速 | GitHub | Slackチャンネル | |
| .NET/C# | GitHub | Slackチャンネル |
データ、API、エクスポートについて議論する
APIとデータエクスポートに関するよくある質問 と Open Food Factsに関するよくある質問をご覧ください。
Open Food Facts Slack チャットルーム に参加できます。 これは、質問したり API について話し合ったりするための推奨される方法です。 ご質問は #api チャンネルまでお寄せください
https://github.com/openfoodfacts/openfoodfacts-server/discussions
データに関するご質問は、 reuse@openfoodfacts.orgまでお問い合わせください。