How Peppermint Signals Work
From raw retailer data to AI-powered nutrition intelligence.
Data SourcesConsumers
National Retailers
USDA
Specialty Grocers
Open Food Facts
Signals Engine
Product Matcher
Catalog API
AI Analyzer
Quality Scorer
Barcode Lookup
Search API
MCP / AI Agents
One request, complete nutrition intelligence
Scan a barcode. Get everything.
Request
curl https://api.peppermint.food/api/v1/catalog/products/barcode/00038000138416 \
-H "Authorization: Bearer pm_live_your_key_here"Response
{
"success": true,
"data": {
"name": "Cheerios",
"brand": "General Mills",
"gtin14": "00038000138416",
"data_quality": 0.95,
"nutrition": {
"calories": 140,
"serving_size": "1 1/2 cups (39g)",
"nutrients": {
"protein": { "value": 5, "unit": "g" },
"dietary_fiber": { "value": 4, "unit": "g" }
}
},
"dietary_profile": {
"health_score": 7.2,
"processing_level": "medium",
"dietary_flags": {
"is_vegan": true,
"is_high_fiber": true
},
"goal_scores": {
"heart_healthy": 7.8,
"diabetic_friendly": 6.5
}
}
}
}Three endpoints. That's it.
Everything you need to build a food-aware app.
GET
/products/barcode/{gtin}
Look up any product by UPC, EAN, or GTIN barcode
GET
/products/search?q={query}
Full-text search across 1.15M products with relevance ranking
GET
/products/{id}
Complete product details with nutrition, dietary profile, and allergens
What makes Signals different
Features no other food API has.
AI Dietary Profiles
Every product analyzed for health score, dietary flags (vegan, keto, gluten-free), processing level, and goal-specific scores. No other API has this.
Multi-Source Nutrition
Nutrition data merged from national retailers, USDA, specialty grocers, and Open Food Facts. We pick the highest-quality source per product.
Data Quality Scoring
Every product has a transparent 0–1.0 quality score with component breakdown. Filter by quality so your app only shows reliable data.
Works with AI agents
Drop-in MCP server for Claude, ChatGPT, and any MCP-compatible agent. Your AI can look up food data natively.
Claude Desktop / claude_desktop_config.json
{
"mcpServers": {
"peppermint": {
"command": "npx",
"args": ["-y", "@peppermint/catalog-mcp"],
"env": {
"PEPPERMINT_API_KEY": "pm_live_your_key_here"
}
}
}
}