Data source: Open Food Facts (community database)
https://context.gnist.ai/rest/openfoodfacts/
AuthenticationAll requests require a Gnist-API-Key header (or api_key query parameter).
Free tier: 100 calls/day. Get your API key.
Tools (3)
get_food_productLook up a food product by barcode (EAN-13 or UPC-A).
Returns product name, brand, Nutri-Score, NOVA group, ingredients, and
full nutrition facts per 100g.
Args:
barcode: Product barcode (e.g. "3017620422003" for Nutella).
| Parameter | Type | Required | Description |
|---|---|---|---|
barcode | string | required |
{
"barcode": "example"
}search_food_productsSearch the Open Food Facts database for food products by name.
Returns matching products with barcode, name, brand, and Nutri-Score.
Args:
query: Product name search (e.g. "nutella", "oat milk", "granola").
limit: Maximum number of results (1-50, default 10).
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | |
limit | integer | optional | (default: 10) |
{
"query": "example"
}report_feedbackReport a bug, feature request, or general feedback for this data source.
Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.
Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |
{
"feedback": "example"
}Quick Start
curl -X POST "https://context.gnist.ai/rest/openfoodfacts/get_food_product" \
-H "Content-Type: application/json" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"barcode": "example"}'
import httpx
resp = httpx.post(
"https://context.gnist.ai/rest/openfoodfacts/get_food_product",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
json={
"barcode": "example"
},
)
print(resp.json())