{"uid":"cap_d7ceqROIV-843pbGEzYW4","slug":"2s-io-dba02634","name":"2s.io Food Barcode Lookup","description":"Resolve a food product barcode (UPC, EAN-13, EAN-8, etc.) to structured product metadata via Open Food Facts — the CC0 community-maintained database of >3M food products. Returns product name, brand, ingredient list, allergens, nutriments (per-100g + per-serving), Nutri-Score grade (a-e), NOVA processing classification (1-4), Eco-Score, categories, manufacturing origin, packaging, and product image URLs.","url":"https://2s.io/api/food/barcode-lookup","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["barcode"],"properties":{"barcode":{"type":"string","description":"6-14 digit UPC/EAN barcode."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"barcode":"5901234123457"}}},"response":{"data":{"ok":true,"meta":{"found":true},"items":[{"name":"Sauce chiltepin","brands":"La lumbre","labels":["en:no-preservatives","es:sistema-de-etiquetado-frontal-de-alimentos-y-bebidas","en:no-colorings","es:exceso-sodio"],"barcode":"5901234123457","origins":"Mexico, fr:Aconchi, fr:Sonora","imageUrl":"https://images.openfoodfacts.org/images/products/590/123/412/3457/front_en.100.400.jpg","quantity":"190 ml","allergens":[],"countries":["en:france","en:mexico","en:morocco"],"novaGroup":4,"packaging":[],"categories":["en:plant-based-foods-and-beverages","en:plant-based-foods","en:fats","en:vegetable-fats","en:olive-tree-products","en:vegetable-oils","en:olive-oils"],"nutriments":{"fat":18,"salt":2.1,"energy":815.6,"sodium":0.84,"sugars":4.2,"fat_100g":18,"fat_unit":"g","proteins":2.8,"energy-kj":815.6,"fat_value":18,"salt_100g":2.1,"salt_unit":"g","nova-group":4,"salt_value":2.1,"energy-kcal":197,"energy_100g":815.6,"energy_unit":"kJ","fat_serving":18,"sodium_100g":0.84,"sodium_unit":"g","sugars_100g":4.2,"sugars_unit":"g","added-sugars":0,"energy_value":815.6,"salt_serving":2.1,"sodium_value":0.84,"sugars_value":4.2,"carbohydrates":6,"proteins_100g":2.8,"proteins_unit":"g","saturated-fat":12,"energy-kj_100g":815.6,"energy-kj_unit":"kJ","energy_serving":816,"proteins_value":2.8,"sodium_serving":0.84,"sugars_serving":4.2,"energy-kj_value":815.6,"energy_modifier":"~","nova-group_100g":4,"nova-group_unit":"","energy-kcal_100g":197,"energy-kcal_unit":"kcal","nova-group_value":4,"proteins_serving":2.8,"added-sugars_100g":0,"added-sugars_unit":"g","energy-kcal_value":197,"energy-kj_serving":816,"added-sugars_value":0,"carbohydrates_100g":6,"carbohydrates_unit":"g","energy-kj_modifier":"~","nova-group_serving":4,"saturated-fat_100g":12,"saturated-fat_unit":"g","carbohydrates_value":6,"energy-kcal_serving":197,"saturated-fat_value":12,"added-sugars_serving":0,"added-sugars_modifier":"~","carbohydrates_serving":6,"saturated-fat_serving":12,"fruits-vegetables-nuts-estimate-from-ingredients_100g":0,"fruits-vegetables-legumes-estimate-from-ingredients_100g":0},"servingSize":"1 serving (100 g)","ecoscoreGrade":"e","nutrientLevels":{"fat":"moderate","salt":"high","sugars":"low","saturated-fat":"high"},"ingredientsText":"Chiltepin, purified water, xanthan gum, sodium benzonate as a preservative and seasonings.","nutriscoreGrade":"e","manufacturingPlaces":null}],"total":1,"source":{"url":"https://world.openfoodfacts.org/","license":"ODbL (Open Food Facts)","provider":"Open Food Facts (community-maintained, CC0)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"food.barcode-lookup","settlement":{"txHash":"0x58733a6a15142b1f29db2814979ae287c1878674e67b93d088f430979e7395a3","network":"eip155:8453","success":true}}}},"exampleRequest":{"barcode":"5901234123457"},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.66","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_z-mYtgWqaCtM4uECbZTpy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a food product barcode (UPC/EAN) to structured nutritional and product metadata via the Open Food Facts database","exampleAgentPrompt":"Can you look up barcode 3017620422003 and tell me the product name, brand, ingredients, Nutri-Score grade, and whether it contains any allergens?","exampleUseCases":null,"resultDescription":"Returns structured product metadata including product name, brand, full ingredient list, allergens, per-100g and per-serving nutriments, Nutri-Score grade (a–e), NOVA processing classification (1–4), Eco-Score, product categories, manufacturing origin, packaging details, and product image URLs — sourced from the Open Food Facts CC0 database.","failureModes":["Barcode not found in Open Food Facts database — product may be too niche or not yet catalogued","Invalid barcode format (must be 6–14 digits) — returns validation error","Product entry exists but has incomplete community-sourced data — some fields may be null or empty","Payment required error if x402 micropayment header is missing or invalid","Rate limiting or upstream Open Food Facts API unavailability"],"whenToPreferThis":"Use this endpoint when you need to resolve a physical food product barcode (UPC, EAN-13, EAN-8, etc.) into rich structured nutritional metadata including Nutri-Score, NOVA processing level, allergens, and ingredient lists. Prefer it over general web search when you need machine-readable, structured nutrition data from a trusted community database with >3M products. Ideal for diet tracking apps, allergen checkers, grocery assistants, or any agent needing food product facts from a scan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":29,"lastUsedAt":"2026-07-19T02:19:17.795Z","lastSuccessfullyRanAt":"2026-07-19T02:19:17.795Z","lastHealthCheckAt":"2026-09-14T06:53:04.280Z","isFirstParty":false}