Help ons miljoenen consumenten over de hele wereld te informeren over wat ze eten

group photo donation 2024
Open Food Facts logo

Doneer alstublieft aan onze 2026 inzamelingsactie

Met uw donaties financieren wij de dagelijkse activiteiten van onze non-profitorganisatie:

  • onze database open en beschikbaar houden voor iedereen,
    • technische infrastructuur (website/mobiele app) & een klein vast team

  • onafhankelijk blijven van de voedingsindustrie,

  • een gemeenschap van toegewijde burgers betrekken,

  • de vooruitgang van onderzoek op het gebied van de volksgezondheid ondersteunen.

Elke donatie telt! Wij waarderen uw steun om meer voedseltransparantie in de wereld te brengen.

Gegevens

Voorwaarden voor hergebruik

De Open Pet Food Facts-database is beschikbaar onder de Open Database-licentie.
De individuele inhoud van de database is beschikbaar onder de Database Contents License.
Productafbeeldingen zijn beschikbaar onder de Creative Commons Attribution ShareAlike-licentie. Ze kunnen grafische elementen bevatten die onderhevig zijn aan auteursrechten of andere rechten, die in sommige gevallen kunnen worden gereproduceerd (citaatrecht of redelijk gebruik).

Lees Voorwaarden voor gebruik en hergebruik voordat u de gegevens opnieuw gebruikt.

Vertel ons over uw hergebruik

We willen graag weten hoe de gegevens van Open Pet Food Facts worden gebruikt. Het is niet verplicht, maar we stellen het zeer op prijs als u ons vertelt over uw hergebruik zodat we dit kunnen delen met de Open Pet Food Facts-community. U kunt ook dit formulier invullen om kans te maken dat uw app wordt aanbevolen.

Open Pet Food Facts gegevensexport

Database dumps en exports worden elke nacht gegenereerd. De database is erg groot, daarom zijn er verschillende manieren om de gegevens te exporteren, afhankelijk van de gewenste toepassing.

Informatie over de verschillende velden voor de MongoDB-dump en CSV-export is beschikbaar op https://world.openpetfoodfacts.org/data/data-fields.txt

MongoDB-dump

Alle productdata is beschikbaar in een MongoDB-databasedump.

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

Delta-export

Dagelijkse delta-exporten zijn beschikbaar voor de afgelopen 14 dagen. De lijst met beschikbare delta-bestanden kan worden gevonden op https://static.openpetfoodfacts.org/data/delta/index.txt.

Elke regel vertegenwoordigt een bestand dat beschikbaar is op https://static.openpetfoodfacts.org/data/delta/{filename}.

De bestandsnaam bevat UNIX-tijdstempel van de eerste en de laatste wijziging in het JSON-bestand, zodat de delta-bestanden kunnen worden geïmporteerd (na extractie) met mongoimport in alfabetische volgorde.

Let op: vanwege de aard van mongoexport , bevatten de deltabestanden geen informatie over verwijderde producten. Om verwijderde producten uit uw database te verwijderen, moet u de volledige MongoDB-dump importeren.

JSONL-gegevens exporteren

De hele database is beschikbaar in JSONL formaat (soms LDJSON of NDJSON) waarbij elke regel een JSON object is. Het zijn dezelfde gegevens als de MongoDB-export. Het bestand is gecomprimeerd met gzip.

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

Een geschikte manier om de database te exploiteren is door gebruik te maken van DuckDB, een in-process analytische tool die is ontworpen om grote hoeveelheden data in een fractie van een seconde te verwerken. Je kunt onze blog post lezen waarin we je helpen bij het verkennen en verwerken van de Open Pet Food Facts database met DuckDB

CSV Data export

Gegevens voor alle producten, of sommige producten, kunnen worden gedownload in het CSV-formaat (leesbaar met LibreOffice, Excel en vele andere spreadsheet-software) via het geavanceerd zoekformulier.

Links
https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz (gecomprimeerde CSV in GZIP-formaat: ~ 0,9 Gb, ongecomprimeerd: ~ 9 Gb)

De bestandscodering is Unicode UTF-8. Het teken dat velden scheidt is <tab> (tabulatie).

RDF-gegevensexport

De database is ook beschikbaar in RDF-formaat. U kunt de aankondiging lezen in Frans.

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

Afbeeldingsgegevens exporteren

Alle afbeeldingen en OCR-resultaten kunnen worden gedownload van onze server of van AWS (via het AWS Open Data Program). Bekijk onze documentatie voor meer informatie over het downloaden van afbeeldingen.

Live JSON en XML API

Een JSON API is beschikbaar om de productgegevens te lezen. Deze API wordt met name gebruikt in de Open Pet Food Facts mobiele app voor iPhone en Android.

We veranderen de API in de loop van de tijd, maar we zorgen ervoor dat de compatibiliteit met eerdere versies behouden blijft. Neem contact op als je het gebruikt, zodat we je kunnen informeren over mogelijke wijzigingen.

URL om gegevens voor een product te lezen: https://world.openpetfoodfacts.org/api/v2/product/[barcode].json

Voorbeeld: https://world.openpetfoodfacts.org/api/v3/product/737628064502.json

Houd er rekening mee dat als de uitvoer te overweldigend is, u deze kunt filteren, zoals beschreven in de API-documentatie.

OpenAPI-hulp gezocht

We willen graag de documentatie van de API afronden, use-cases toevoegen en de SDK-generatie automatiseren. Als u een OpenAPI connaisseur bent, bent u van harte welkom om te helpen.

U mag de API gerust gebruiken voor productiedoeleinden, zolang 1 API-aanroep resulteert in 1 echte scan door een gebruiker. Elke poging om de database met behulp van de API te scrapen, zal zeer waarschijnlijk worden geblokkeerd, omdat volledige dagelijkse export op deze pagina beschikbaar is.

Het verzenden van een HTTP-header met uw API-call is ook een goede manier om contact met ons op te nemen, mocht er zich een probleem voordoen.

Als je ergens niet zeker van bent, of een vraag hebt (er zijn geen domme vragen), stel hem dan gerust op het #api-kanaal op Slack :-)

Experimentele XML-API

U kunt het resultaat ook in XML krijgen door .xmlte gebruiken

Voorbeeld: https://world.openpetfoodfacts.org/api/v2/product/737628064502.xml

Deze API wordt niet actief onderhouden en is niet officieel gedocumenteerd.

Wrappers en SDKs

Waarschijnlijk hebben we een wrapper voor je favoriete programmeertaal. Als die wrapper bestaat, dan kan je die gebruiken en verbeteren. Als we de gewenste wrapper niet hebben, kan je helpen met die te maken.

Hiermee kunt u gegevens consumeren en uw gebruikers nieuwe gegevens laten bijdragen

Algemene principes om uw gebruikers blij te maken

  • Je kunt op zoek gaan naar productinformatie, inclusief veel nuttige berekende productwaarden.
  • Als u de informatie over een specifiek product niet kunt vinden, kunt u uw gebruiker toestemming geven om foto's en gegevens te versturen. Deze worden vervolgens verwerkt door Open Pet Food Facts AI en bijdragers om het berekende resultaat te verkrijgen dat u wilt laten zien.
  • Je kunt ook de volledige flow implementeren zodat ze met enige moeite direct resultaat krijgen.

Als jouw gebruikers niet onmiddellijk een resultaat verwachten (bijvoorbeeld inventaris-apps)

  • Foto's indienen (voorkant/voeding/ingrediënten): het gemakkelijkst voor uw gebruikers
  • De Open Pet Food Facts - AI Robotoff - zal gegevens uit de foto's afleiden
  • Na verloop van tijd zullen andere apps en de Open Pet Food Facts-community de lacunes in de gegevens opvullen

Als uw gebruikers direct een resultaat verwachten (bijvoorbeeld apps voor voedingswaarden of allergieën)

  • Ingrediënten + categorie indienen > verkrijg ingrediëntenanalyse, additieven, allergenen, genormaliseerde ingrediënten, veganistisch, vegetarisch…
  • Labels verzenden voor toegevoegde waarde
  • Voedingswaarde indienen

Mobiele Android- en iPhone-app

De code voor de huidige universele app genaamd Open Food Facts is beschikbaar op GitHub (Flutter. Het kan dierenvoer scannen en toevoegen. De oude Open Pet Food Facts mobiele app, nog steeds beschikbaar voor Android, is gebouwd met behulp van Kotlin. Het plan is om de app te updaten naar een Open Pet Food Facts-variant van de Flutter-app.

We willen de verouderde Kotlin- en Swift-codebases omzetten in Kotlin- en Swift-SDK's. Hulp is welkom :-)

Kotlin Android en Swift iOS

De app staat gebruikers toe om de barcode van producten te scannen, om de productinformatie te bekijken en om foto's en gegevens te bekijken en te verzenden voor ontbrekende producten.

Je bent van harte welkom om de code opnieuw te gebruiken (het is open source) en ons te helpen deze te verbeteren, voor iedereen, op de hele planeet.

SDK's

Bespreking van gegevens, API en export

U kunt kijken naar FAQ's over de API en Data Exports en algemene Open Food Facts vragen

Je kunt lid worden van de Open Pet Food Facts Slack-chatroom. Dit is de beste manier om vragen te stellen en de API te bespreken. Stel uw vragen in het #api kanaal

U kunt een thread openen in onze API documentatie repository

Voor vragen over de gegevens kunt u contact met ons opnemen via reuse@openfoodfacts.org