Help us inform millions of consumers around the world about what they eat

group photo donation 2024
open food facts logo

Please give to our 2025 Fundraiser

Your donations fund the day-to-day operations of our non-profit association:

  • keeping our database open & available to all,
    • technical infrastructure (website/mobile app) & a small permanent team

  • remain independent of the food industry,

  • engage a community of committed citizens,

  • support the advancement of public health research.

Each donation counts! We appreciate your support in bringing further food transparency in the world.

Veri

Yeniden kullanım koşulları

Open Beauty Facts veritabanı, Açık Veritabanı Lisansıkapsamında mevcuttur.
Veritabanının bireysel içerikleri Veritabanı İçeriği Lisansıkapsamında mevcuttur.
Ürün görselleri Creative Commons Attribution ShareAlike lisansıkapsamında mevcuttur. Bazı durumlarda çoğaltılabilen (alıntı hakkı veya adil kullanım), telif haklarına veya diğer haklara tabi grafiksel ögeler içerebilirler.

Verileri yeniden kullanmadan önce lütfen Kullanım ve yeniden kullanım şart ve koşullarını okuyun.

Bize yeniden kullanımınızdan bahsedin

Open Beauty Facts verilerinin ne için kullanıldığını öğrenmekle çok ilgileniyoruz. Zorunlu değildir ancak Open Beauty Facts topluluğuyla paylaşabilmemiz için yeniden kullanımlarınız hakkında bize bilgi verirseniz çok memnun oluruz. Uygulamanızın öne çıkarılması şansını yakalamak için bu formu da doldurabilirsiniz.

Open Beauty Facts veri dışa aktarımaları

Veritabanı dökümleri ve dışa aktarımları her gece yapılır. Veritabanı çok büyük olduğundan, dışa aktarma biçimine bağlı olarak verileri kullanmanın farklı yollarını bulabilirsiniz.

MongoDB dökümü ve CSV dışa aktarımına ilişkin farklı alanlara ilişkin bilgilere https://world.openbeautyfacts.org/data/data-fields.txt adresinden ulaşılabilir

MongoDB dökümü

Tüm ürünler için veriler MongoDB veritabanı dökümünde mevcuttur.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.gz
sha256sum
https://static.openbeautyfacts.org/data/gz-sha256sum
md5sum
https://static.openbeautyfacts.org/data/gz-md5sum

Delta Dışa Aktarım

Günlük delta dışa aktarımlar önceki 14 gün için sağlanmaktadır. Şu anda mevcut olan delta dosyalarının listesi şu adreste bulunabilir: https://static.openbeautyfacts.org/data/delta/index.txt.

Her satır, https://static.openbeautyfacts.org/data/delta/{filename} adresinde bulunan bir dosyayı temsil eder.

Dosya adı, JSON dosyasındaki ilk ve son değişikliğin UNIX zaman damgasını içerir; böylece delta dosyaları mongoimport ile alfabetik sırayla içe aktarılabilir (çıkarıldıktan sonra).

Lütfen mongoexport'un yapısı gereği, delta dosyalarının silinen ürünler hakkında size bilgi veremeyeceğini unutmayın. Silinen ürünleri veritabanınızdan kaldırmak için MongoDB dökümünün tamamını içe aktarmanız gerekecektir.

CSV Veri Dışa Aktarımı

Veritabanının tamamı ayrıca her satırın bir JSON nesnesi olduğu JSONL format (bazen LDJSON veya NDJSON olarak da adlandırılır) mevcuttur. MongoDB dışa aktarımıyla aynı verileri temsil eder. Dosya gzip ile sıkıştırılmıştır.

Link
https://static.openbeautyfacts.org/data/openbeautyfacts-products.jsonl.gz

Veritabanından yararlanmanın uygun bir yolu, büyük miktarda veriyi saniyeler içinde işlemek için tasarlanmış bir süreç içi analitik araç olan DuckDB'yi kullanmaktır. You can read our blog post where we walk you through exploring and processing the Open Beauty Facts database with DuckDB

Hugging Face'te Parke Verisi Aktarımı

JSONL dökümünün basitleştirilmiş bir versiyonu Parquet formatında da mevcuttur. Dönüşüm sırasında, yinelenen bilgiler içeren, dahili hata ayıklama için kullanılan veya kullanıcılar için alakasız olan sütunları filtreledik.

Parke formatının kullanışlı olduğu kanıtlanmıştır:

  • Veriler satır yerine sütuna göre düzenlenir, bu da depolama alanından tasarruf sağlar ve analitik sorguları hızlandırır, yani yalnızca ilgilendiğiniz sütunları seçebilir, giriş seviyesi bilgisayarlarda bile sorgu performanslarını optimize edebilirsiniz.
  • Yüksek verimli veri sıkıştırma ve açma, her türlü büyük veri kümesinin depolanması ve paylaşılması için idealdir
  • Karmaşık veri türlerini ve gelişmiş iç içe geçmiş veri yapılarını destekler.

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

Link
https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/beauty.parquet?download=true

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

CSV Veri Dışa Aktarımı

Tüm ürünlere veya bazı ürünlere ilişkin veriler, gelişmiş arama formu aracılığıyla CSV formatında (OpenOffice, Excel ve diğer birçok yazılımla okunabilir) indirilebilir.

Bağlantılar
https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

Dosya kodlaması Unicode UTF-8'dir. Alanları ayıran karakter <tab> (tablolama)'dır.

RDF Veri Dışa Aktarımı

Veritabanı RDF formatında da mevcuttur. Fransızca duyuruyu okuyabilirsiniz.

Link
https://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf.gz

Görüntü Verilerini Dışa Aktarma

Tüm görüntüler ve OCR sonuçları sunucumuzdan veya AWS'den (AWS Açık Veri Programı aracılığıyla) indirilebilir. Resimlerin nasıl indirileceği hakkında daha fazla bilgi edinmek için belgelerimize göz atın.

Canlı JSON ve XML API'si

Bir ürünün verilerini okumak için bir JSON API de mevcuttur. Bu API, özellikle iPhone ve Android için Open Beauty Facts mobil uygulamasında kullanılır.

API'yi zamanla geliştiriyoruz ancak geriye dönük uyumluluğu korumaya özen gösteriyoruz. Lütfen bunu kullanırsanız bize bildirin, böylece olası değişikliklerde sizi haberdar edebiliriz.

Bir ürünün verilerini okumak için URL: https://world.openbeautyfacts.org/api/v2/product/[barcode].json

Örnek: https://world.openbeautyfacts.org/api/v2/product/3600550578041.json

Çıktı çok yoğunsa API belgelerinde açıklandığı gibi filtreleyebileceğinizi unutmayın.

OpenAPI yardımı aranıyor

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.

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.

Herhangi bir konuda emin değilseniz veya herhangi bir sorunuz varsa (aptalca soru diye bir şey yoktur), Slack'teki #api kanalında sormaya çekinmeyin :-)

Deneysel XML API'si

Sonucu .xmlkullanarak XML'de de alabilirsiniz.

Veri

Bu API aktif olarak korunmaz ve resmi olarak belgelenmez.

Wrapper'lar ve SDK'lar

Muhtemelen en sevdiğiniz programlama dili için bir wrapper'ımız vardır. Eğer varsa, onu kullanabilir ve iyileştirebilirsiniz. Eğer yoksa, oluşturmamıza yardımcı olabilirsiniz.

Soru sormak ve API'yi tartışmak için tercih edilen yol olan Open Food Facts Slack sohbet odasına katılabilirsiniz.

Kullanıcılarınızı mutlu edecek genel prensipler

  • Birçok faydalı hesaplanmış değer de dahil olmak üzere ürünler hakkında bilgi arayabilirsiniz.
  • 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 Beauty Facts AI and contributors to get the computed result you want to show them.
  • Ayrıca, kendi taraflarında biraz çaba harcayarak sonucu hemen almaları için tam akışı da uygulayabilirsiniz.

Kullanıcılarınız hemen bir sonuç beklemiyorsa (örn. Envanter uygulamaları)

  • Fotoğrafları gönderin (ön yüz/besin değerleri/içindekiler): Kullanıcılar anlayabileceği en basit haliyle
  • The Open Beauty Facts AI - Robotoff - will generate some derived data from the photos
  • Over time, other apps, and the Open Beauty Facts community will fill the data gaps

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

  • Submit ingredients + category > get Ingredient analysis, additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit labels for added value

Android ve iPhone mobil uygulaması

API V2 - Kapsamlı ancak OpenAPI uyumlu değil - Bir ürünü görüntülemek ve kullanıcılarınızın Nutri-Score, NOVA sınıflandırması, katkı maddeleri ve Eco-Score'u almak için gereken verileri eklemesine olanak tanıyan kullanım senaryoları içerir.

Kullanımdan kaldırılan Kotlin ve Swift kod tabanlarını Kotlin ve Swift SDK'larına dönüştürmeye çalışıyoruz. Uygulama, kullanıcıların ürünlerin barkodunu taramasına, ürün bilgilerini görüntülemesine ve eksik ürünler için fotoğraf ve veri çekip göndermesine olanak tanır.

Uygulama, kullanıcıların ürünlerin barkodunu taramasına, ürün bilgilerini görüntülemesine ve eksik ürünler için resim ve veri çekip göndermesine olanak tanır.

Kodu (açık kaynaktır) yeniden kullanmaya ve gezegen üzerindeki herkes için iyileştirmemize yardımcı olabilirsiniz.

SDK'lar

Verileri, API'yi ve dışa aktarımları tartışmak

API ve Veri Dışa Aktarma işlemleriyle ilgili yaygın sıkça sorulan sorulara ve Open Food Facts'le ilgili yaygın sorulara bakabilirsiniz.

You can join the Open Beauty Facts Slack chatroom which is the preferred way to ask questions and discuss the API. Lütfen sorularınızı #api kanalında sorun

https://github.com/openfoodfacts/api-documentation/discussions

Verilerle ilgili herhangi bir sorunuz varsa reuse@openfoodfacts.org adresinden bizimle iletişime geçebilirsiniz.