Focus on Research & Community

Open Food Facts Days 2026

Fri 13th – Sat 14th November
Paris, France

Register here

データ

再利用の条件

Open Pet Food Facts データベースは、 オープン データベース ライセンスに基づいて利用できます。
データベースの個々のコンテンツは、 データベース コンテンツ ライセンスに基づいて利用できます。
データベースの個々のコンテンツは、 データベース コンテンツ ライセンスに基づいて利用できます。 これらには著作権またはその他の権利の対象となるグラフィック要素が含まれる場合がありますが、場合によっては複製が認められる場合があります(引用権または公正使用)。

データを再利用する前に、 利用規約と再利用に関する条項 をお読みください。

Simplified ODbL summary

This is a human-readable summary of the ODbL 1.0 license (see also the Open Data Commons summary):

You are free:

  • To share: To copy, distribute and use the database.
  • To create: To produce works (such as applications, websites, services, or analytical studies) from the database.
  • To adapt: To modify, transform and build upon the database.

As long as you:

  • Attribute: You must attribute any public use of the database, or works produced from the database, in the manner specified in the ODbL (e.g. "Contains data from Open Pet Food Facts, available under the Open Database License"). For any redistribution of the database, or works produced from it, you must make clear to others the license of the database and keep intact any notices on the original database.
  • Share-Alike: If you publicly use any adapted version of this database, or works produced from an adapted database, you must also offer that adapted database under the ODbL and share your modifications back.
  • Keep open: If you redistribute the database, or an adapted version of it, you may use technological measures that restrict the work (such as DRM) only as long as you also redistribute a version without such measures.

Be on the legal side: The technical route to compliance

We want everyone to succeed with their projects while keeping data open for everyone! To ensure your application or reuse complies with the license and our infrastructure policies, please follow this technical checklist (see also our license compliance tutorial):

Compliance resources:

再利用について教えてください

私たちは、Open Pet Food Facts データが何に使用されているかを知りたいと思っています。 It is not mandatory, but we would very much appreciate it if you tell us about your re-uses so that we can share them with the Open Pet Food Facts community. また、 このフォームに記入 して、アプリが特集されるチャンスを得ることもできます。

Open Pet Food Facts データエクスポート

データベースのダンプとエクスポートは毎晩生成されます。データベースは非常に大きいため、エクスポートのフレーバーに応じて、データのさまざまな使用方法 見つけることができます。

MongoDB ダンプと CSV エクスポートのさまざまなフィールドに関する情報は、 https://world.openpetfoodfacts.org/data/data-fields.txtで入手できます。

MongoDB ダンプ

すべての製品のデータは、MongoDB データベース ダンプで入手できます。

リンク
https://static.openpetfoodfacts.org/data/openpetfoodfacts-mongodbdump.gz
sha256sum
https://static.openpetfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openpetfoodfacts.org/data/gz-md5sum

デルタエクスポート

過去 14 日間の毎日のデルタ エクスポートが提供されます。現在利用可能なデルタ ファイルのリストは、 https://static.openpetfoodfacts.org/data/delta/index.txtにあります。

各行は、 https://static.openpetfoodfacts.org/data/delta/{filename}で入手できるファイルを表します。

ファイル名には、JSON ファイルに含まれる最初の変更と最後の変更の UNIX タイムスタンプが含まれているため、デルタ ファイルは (抽出後に) mongoimport を使用してアルファベット順にインポートできます。

mongoexportの性質上、デルタ ファイルでは削除された製品に関する情報を取得できないことに注意してください。削除された製品をデータベースから削除するには、MongoDB ダンプ全体をインポートする必要があります。

CSVデータのエクスポート

データベース全体は、各行が JSON オブジェクトである JSONL 形式 (LDJSON または NDJSON と呼ばれることもあります) でも利用できます。これは MongoDB エクスポートと同じデータを表します。ファイルは gzip で圧縮されています。

リンク
https://static.openpetfoodfacts.org/data/openpetfoodfacts-products.jsonl.gz

Hugging FaceでのParquetデータエクスポート

The dataset is available on Hugging Face, a collaborative Machine Learning ecosystem where developers and researchers can share models and datasets.

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.
リンク
https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/petfood.parquet?download=true

Find more information in the Wiki, including guidelines for data reuse and example queries to get started.

データベースを活用する適切な方法は、DuckDBを使用することです。 これは、大量のデータを数秒で処理するために設計されたインプロセス分析ツールです。 DuckDBを使用してOpen Pet Food Factsデータベースを探索および処理する方法について説明した ブログ投稿 をお読みください。

画像データのエクスポート

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.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

ファイルのエンコーディングは Unicode UTF-8 です。フィールドを区切る文字は <tab> (タブ) です。

RDFデータのエクスポート

データベースは RDF 形式でも利用できます。のお知らせはフランス語で読むことができます。

リンク
https://world.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.rdf.gz

画像データのエクスポート

すべての画像と OCR 結果は、当社のサーバーから、または AWS (AWS オープンデータプログラム経由) からダウンロードできます。画像をダウンロードする方法の詳細については、ドキュメント 参照してください。

ライブ JSON および XML API

製品のデータを読み取るための JSON API も利用できます。この API は、特に iPhone および Android 向けの Open Pet Food Facts モバイル アプリで使用されます。

私たちはAPIの残業を改善しますが、後方互換性を保つように注意しています。 Please get in touch if you use it, so that we can tell you about potential changes.

URL to read data for a product: https://world.openpetfoodfacts.org/api/v3/product/[barcode].json

Example: https://world.openpetfoodfacts.org/api/v0/product/3600550578041.json

出力が多すぎる場合は、API ドキュメントに記載されているようにフィルタリングできることに注意してください。

Digital Commons • Non-Profit NGO

Benefiting from our API? Support the infrastructure that powers your project

Open Food Facts is an independent, non-profit digital commons built for public benefit. We provide our database and API 100% free of charge and open to all, without commercial paywalls or advertising.

Serving millions of real-time queries daily incurs real costs in servers, database clusters, bandwidth, and maintenance. If your application, startup, research project, or company saves time and builds value with our API, please consider supporting Open Food Facts financially. Your contribution keeps our open infrastructure fast, resilient, and freely accessible to everyone worldwide.

OpenAPI ヘルプ募集

私たちは、API のドキュメントを完成させ、ユースケースを追加し、SDK の生成を自動化したいと考えています。 OpenAPI の専門家であれば、ぜひ協力していただければ幸いです。

1 回の API 呼び出し = ユーザーによる 1 回の実際のスキャンである限り、本番環境で API を自由に使用できます。 完全な毎日のエクスポートがこのページで利用できるため、API を使用してデータベースをスクレイピングする試みはブロックされる可能性が非常に高くなります。

また、API 呼び出しで HTTP ヘッダーを送信すると、問題が発生した場合に連絡を取ることができます。

何か不明な点や質問がある場合(愚かな質問はありません) お気軽に Slack の #api チャンネルでお問い合わせください :-)

実験用 XML API

.xml を使用して結果を XML で取得することもできます。

(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.

この 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 Pet 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 Pet Food Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Pet Food Facts community will fill the data gaps

ユーザーがすぐに結果を期待している場合(例:栄養やアレルギーのアプリ)

  • 原材料 + カテゴリを送信 > 原材料分析、添加物、アレルゲン、標準化原材料、ビーガン、ベジタリアン…
  • 付加価値のためにラベルを提出する
  • Submit nutrition

AndroidおよびiPhoneモバイルアプリ

The code for the current universal app called Open Food Facts is available on GitHub (Flutter). ペットフードをスキャンして追加できます。 Android で引き続き利用可能な従来の Open Pet Food Facts モバイル アプリは、Kotlin で構築されています。計画としては、これを Flutter アプリの Open Pet Food Facts ブランド版に更新することです。

廃止予定の Kotlin および Swift コードベースを Kotlin および Swift SDK に変換する予定ですので、ご協力をお待ちしています :-)

Kotlin Android と Swift iOS

(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 Pet Food Facts Slack チャットルーム に参加できます。 これは、質問したり API について話し合ったりするための推奨される方法です。ご質問は #api チャンネルまでお寄せください

1 回の API 呼び出し = ユーザーによる 1 回の実際のスキャンである限り、本番環境で API を自由に使用できます。 完全な毎日のエクスポートがこのページで利用できるため、API を使用してデータベースをスクレイピングする試みはブロックされる可能性が非常に高くなります。

データに関するご質問は、 reuse@openfoodfacts.orgまでお問い合わせください。