Dünya çapında milyonlarca tüketiciyi ne yedikleri konusunda bilgilendirmemize yardımcı olun

group photo donation 2024
Open Food Facts logo

Lütfen 2026 Bağış Toplama Kampanyamıza bağışta bulunun

Bağışlarınız, kâr amacı gütmeyen derneğimizin günlük faaliyetlerini finanse ediyor:

  • veritabanımızı herkese açık ve erişilebilir tutarak,
    • teknik altyapı (web sitesi/mobil uygulama) ve küçük bir kalıcı ekip

  • gıda endüstrisinden bağımsız kalmak,

  • bağlı vatandaşlardan oluşan bir topluluğu harekete geçirmek,

  • halk sağlığı araştırmalarının ilerlemesini desteklemek.

Her bağış değerli! Dünyada gıda şeffaflığını daha da artırma yolundaki desteğiniz için teşekkür ederiz.

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. DuckDB ile Open Beauty Facts veritabanını keşfetme ve işleme konusunda size yol gösterdiğimiz blog yazımızı okuyabilirsiniz

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.

Veri seti, geliştiricilerin ve araştırmacıların modelleri ve veri setlerini paylaşabilecekleri işbirlikçi bir Makine Öğrenmesi ekosistemi olan Hugging Faceüzerinde mevcuttur.

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

Başlamak için veri yeniden kullanımına ilişkin yönergeler ve örnek sorgular da dahil olmak üzere daha fazla bilgiyi Wikiadresinde bulabilirsiniz.

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 (GZIP biçiminde sıkıştırılmış CSV: ~ 0,9 Gb, sıkıştırılmamış: ~ 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

API'nin dokümantasyonunu tamamlamak, kullanım senaryoları eklemek ve SDK üretimini otomatikleştirmek için sabırsızlanıyoruz. Eğer bir OpenAPI uzmanıysanız, yardımınıza açığız.

1 API çağrısı = kullanıcı tarafından yapılan 1 gerçek tarama olduğu sürece, API'yi üretim durumlarında kullanmanızdan memnuniyet duyarız. API kullanarak veritabanını taramaya yönelik her türlü girişim büyük ihtimalle engellenecektir, çünkü bu sayfada günlük tam veri aktarımları mevcuttur.

Ayrıca, API çağrınızla birlikte bir HTTP başlığı göndermek, herhangi bir sorun çıkması halinde bizimle iletişime geçmenin iyi bir yoludur.

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.
  • Belirli bir ürünle ilgili bilgiye ulaşamıyorsanız, kullanıcınızdan fotoğraf ve veri göndermesini isteyebilirsiniz; bu veriler daha sonra Open Beauty Facts AI ve katkıda bulunanlar tarafından işlenerek onlara göstermek istediğiniz hesaplanmış sonuca ulaştırılır.
  • 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
  • Open Beauty Facts Yapay Zekası - Robotoff - fotoğraflardan bazı türetilmiş veriler üretecek
  • Zamanla, diğer uygulamalar ve Open Beauty Facts topluluğu veri boşluklarını dolduracaktır

Kullanıcılarınız hemen sonuç bekliyorsa (örneğin Alerji uygulamaları)

  • İçerikleri + kategoriyi gönderin > İçerik analizi, katkı maddeleri, alerjenler, normalleştirilmiş içerikler, vegan, vejetaryen…alın
  • Eklenmiş değer için etiketler gönderin

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.

Soru sormanın ve API hakkında tartışmanın tercih edilen yolu olan Open Beauty Facts Slack sohbet odasına katılabilirsiniz. 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.