🔌 API Publique
Accédez aux données halal via nos endpoints proxy. Les données proviennent d'Open Food Facts (4M+ produits).
GET Recherche de produits par texte
Utilise le moteur Search-a-licious d'Open Food Facts.
/proxy/search/search?q={query}&page_size={n}&page={p}
| Paramètre | Type | Description |
|---|---|---|
q | string | Texte à rechercher (nom, marque…) |
page_size | int | Résultats par page (max 100) |
page | int | Numéro de page (base 1) |
Exemple de réponse :
{
"hits": [
{
"code": "3017620422003",
"product_name": "Nutella",
"brands": "Ferrero",
"ingredients_text": "Sucre, huile de palme...",
"labels_tags": ["en:halal"]
}
],
"page": 1,
"page_size": 24,
"count": 12500
}
GET Catalogue par pays / catégorie
Utilise l'API v2 d'Open Food Facts (4M+ produits, sans limite de 10K).
/proxy/v2/search?categories_tags={cat}&countries_tags={country}&page_size={n}&page={p}&fields={fields}
| Paramètre | Type | Description |
|---|---|---|
categories_tags | string | Ex: en:beverages |
countries_tags | string | Ex: en:france |
labels_tags | string | Ex: en:halal |
page_size | int | Max 100 |
fields | string | Champs à retourner (séparés par virgule) |
GET Produit par code-barres
/proxy/v2/product/{barcode}.json
Exemple :
GET /proxy/v2/product/3017620422003.json
Retourne toutes les données d'un produit : ingrédients, allergènes, labels, Nutri-Score, etc.
GET Facettes (pays, catégories…)
/proxy/facets/countries.json /proxy/facets/categories.json /proxy/facets/labels.json
Retourne les listes de valeurs disponibles pour les filtres.
⚖️ Licence & Attribution
Les données produits proviennent d'Open Food Facts, publiées sous licence Open Database License (ODbL). Toute utilisation commerciale doit respecter les termes de cette licence et créditer Open Food Facts.