データ
再利用の条件
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):
- (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.
- Use bulk exports for offline, analytical, or caching needs: If you need access to all products or want to run complex queries, please download the nightly MongoDB dumps, CSV, or Parquet exports (described below) or build a local cache.
- Contribute back (Share-Alike in practice): In the spirit of the ODbL Share-Alike obligation, if your app allows users to add new products, update nutrition/ingredients, or submit photos, please send those contributions back to Open Pet Food Facts via our API or SDKs. This ensures everyone benefits from continuous data improvements.
- Prominent UI attribution: Clearly attribute Open Pet Food Facts in your app or website UI (for example, on product pages, search screens, and in the "About" or "Settings" sections) with clickable links back to Open Pet Food Facts and the ODbL license.
Compliance resources:
- Simple summary of the ODbL and our license on the wiki
- Attribution guidelines (how to attribute on mobile, web, and print)
- ODbL non-compliance registry: Check that your project is fully compliant. If your app is listed or you have questions, please reach out to us at reuse@openfoodfacts.org or in the #api channel on Slack so we can help you achieve compliance!
- API FAQ & legal questions
再利用について教えてください
私たちは、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 で圧縮されています。
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.
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 形式でも利用できます。のお知らせはフランス語で読むことができます。
画像データのエクスポート
すべての画像と 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 ドキュメントに記載されているようにフィルタリングできることに注意してください。
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 に変換する予定ですので、ご協力をお待ちしています :-)
(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までお問い合わせください。