API pública
Una API JSON de solo lectura, servida desde nuestra propia base. Te pedimos moderación: 20 solicitudes por segundo como máximo, y guarda las respuestas en caché.
| Punto de acceso | Descripción |
|---|---|
GET /proxy/v2/search?q=… | Recherche plein texte. Paramètres : q, prefix=1 (saisie partielle), page (≤ 200), page_size (≤ 100), sort_by (unique_scans_n, last_modified_t, product_name), fields. Un code-barres dans q renvoie directement le produit (barcode_match). |
… &is_halal=1 / &is_excluded=1 | Produits au statut halal / haram (aussi : &halal_status=doubtful). |
… &labels_tags=en:organic | Filtres par tag exact : labels_tags, categories_tags, countries_tags (répétables). |
GET /proxy/v2/product/{code}.json | Fiche complète, dont halal_status et halal (raisons détaillées). |
GET /proxy/stats | Chiffres clés. Répond 503 + Retry-After pendant le calcul. |
GET /proxy/facets/{type}.json | countries, labels, categories, contributors. |
GET /proxy/top · /proxy/recent | Produits les plus consultés / modifiés récemment (page_size ≤ 50). |
Statut halal (halal_status)
halal- Etiqueta halal declarada, o ingredientes indicados sin alcohol ni cerdo.
haram- Alcohol o cerdo en los ingredientes, o etiqueta de alcohol / no halal declarada.
doubtful- Etiquetas contradictorias, o ingrediente de origen incierto (gelatina, E120, E471, cuajo…) sin etiqueta halal.
unknown- Falta la lista de ingredientes.
Estos estados no son certificaciones. Datos bajo licencia ODbL : cita Halal Open Beauty Facts y Open Beauty Facts.
Ejemplo
curl "https://halalopenbeautyfacts.org/proxy/v2/search?q=couscous&is_halal=1&page_size=5&fields=code,product_name,halal_status"