Help us make food transparency the norm!

As a non-profit organization, we depend on your donations to continue informing consumers around the world about what they eat.

The food revolution starts with you!

기부
close

데이터

Conditions for reuse

Open Food Facts 데이터베이스는 Open Database License에 따라 제공됩니다.
데이터베이스의 개별 내용은 Database Contents License에 따라 사용 가능합니다.
제품 이미지는 Creative Commons Attribution ShareAlike licence에 따라 제공됩니다. 여기엔 저작권이나 다른 권리의 영향을 받는 그래픽 요소를 포함할 수 있으며, 경우에 따라 복제될 수 있습니다(인용 권리 또는 공정한 사용).

데이터를 다시 사용하기 전에 이용 약관을 읽고 다시 사용하십시오.

Tell us about your reuse

우리는 Open 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 Food Facts community. You can also fill this form to get a chance to get your app featured.

Open Food Facts 데이터 내보내기

데이터베이스 덤프 및 내보내기는 밤마다 생성됩니다. The database is very big, so you can find different ways to use the data, depending on the export flavor.

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

델타(Delta) 내보내기

지난 14 일 동안 매일 델타 내보내기가 제공되었습니다. The list of currently available delta files can be found at https://static.openfoodfacts.org/data/delta/index.txt.

각 줄은 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.

mongoexport의 특성상 델타 파일이 삭제된 제품에 대해 알려줄 수 없다는 점에 유의하십시오. To remove deleted products from your database, you will need to import the full MongoDB dump.

CSV 데이터 내보내기

전체 데이터베이스는 JSONL 형식 (LDJSON 또는 NDJSON이라고도 함)으로도 사용할 수 있습니다. 여기서 각 행은 JSON 객체입니다. MongoDB 내보내기와 동일한 데이터를 나타냅니다. 파일은 gzip으로 압축됩니다.

링크
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

CSV 데이터 내보내기

Data for all products, or some of the products, can be downloaded in the CSV format (readable with LibreOffice, Excel and many other spreadsheet software) through the advanced search form.

Links
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

파일 인코딩은 유니코드 UTF-8입니다. 필드를 구분하는 문자는 <tab>(표)이다.

RDF 데이터 내보내기

데이터베이스도 RDF 형식으로 이용할 수 있다. You can read the announcement in French.

링크
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

Image Data Export

All images and OCR results can either be downloaded from our server or from AWS (through the AWS Open Data Program). Check out our documentation to learn more about how to download images.

OpenAPI Documentation for the JSON API

제품의 데이터를 읽는 데 JSON API를 사용할 수도 있습니다. 이 API는 특히 아이폰과 안드로이드용 오픈 푸드 팩트 모바일 앱에서 많이 쓰입니다.

We improve the API over-time but we are careful to keep backwards compatibility. Please get in touch if you use it, so that we can tell you about potential changes.

예시: https://world.openfoodfacts.org/api/v2/product/737628064502.json

Example: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Note that if the output is too overwhelming, you can filter it - as described in the API documentation.

OpenAPI help wanted

We're eager to finish the documentation of the API, add use-cases, and automate SDK generation. If you are an OpenAPI connoisseur, you are very welcome to help.

사용자가 1 번의 API 호출 = 1 번의 실제 스캔을하는 한 프로덕션 사례에 API를 사용하는 것이 매우 좋습니다. 이 페이지에서 매일 전체 내보내기를 사용할 수 있으므로 API를 사용하여 데이터베이스를 긁어 내려는 시도가 차단 될 가능성이 큽니다.

어떤 것에 대해 확신이 없거나 질문이 있다면(어리석은 질문은 없으니) Slack에 자유롭게 물어보십시오 :-)

If you are unsure about anything, or have any question (there is no silly question), feel free to ask it on the #api channel on Slack :-)

Experimental XML API

You can also get the result in XML by using .xml

Example: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

This API is not actively maintained, and not officially documented.

Wrappers 및 SDKs

우리는 아마도 당신이 가장 좋아하는 프로그래밍 언어의 wrapper를 가지고 있을 것입니다. 우리가 사용한다면 그것을 사용하고 향상시킬 수 있습니다. 그렇지 않은 경우 만들 수 있습니다.

질문을 하고 API를 토론하는 데 선호되는 방법인 Open Food Facts Slack 채팅방에 가입할 수 있습니다.

General principles to make your users happy

  • You can search for information about products, including many useful computed values.
  • DART: GitHub
  • 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)

  • 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

If your users expect a result immediately (e.g. Nutrition apps)

  • 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 and iPhone mobile app

The code for the Open Food Facts mobile app is available on GitHub (Flutter, Kotlin Android and Swift iOS).

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

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.

코드를 다시 사용하고(오픈 소스) 지구상의 모든 사람들을 위해 우리가 코드를 개선하도록 도와주십시오.

SDKs

데이터, API 논의 및 내보내기

You can look at common FAQ questions about the API and Data Exports and common Open Food Facts questions

You can join the Open Food Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Please ask your questions in the #api channel

You can open a thread on our API documentation repository

For any question regarding the data, you can contact us at reuse@openfoodfacts.org