{"uid":"cap_3iPl_nIkh1gySDl7zYjt0","slug":"nutripulse-food-nutrition-lookup-3a51dc91","name":"NutriPulse Food Nutrition Lookup","description":"Food nutrition lookup for nutrition and health agents. Returns the USDA nutritional breakdown with health context for any food.","url":"https://nutripulse-alpha.vercel.app/api/nutrition/food","method":"GET","headers":{},"bodySchema":{"type":"object","required":["query"],"properties":{"lang":{"type":"string","description":"lang"},"query":{"type":"string","description":"query"}}},"responseSchema":{"type":"json","example":{}},"example":{"request":{"lang":"en","query":"medium apple"},"response":{"raw":"{\n  \"food\": \"Apple, medium, raw with skin\",\n  \"serving_size\": \"1 medium apple (182g)\",\n  \"calories_per_serving\": 95,\n  \"macros\": {\n    \"protein_g\": 0.5,\n    \"carbs_g\": 25.1,\n    \"fat_g\": 0.3,\n    \"fiber_g\": 4.4,\n    \"sugar_g\": 19.0\n  },\n  \"key_micronutrients\": [\n    {\n      \"name\": \"Vitamin C\",\n      \"amount\": \"8.4 mg\",\n      \"pct_daily_value\": \"14%\",\n      \"benefit\": \"Antioxidant; supports immune function, collagen synthesis, and iron absorption\"\n    },\n    {\n      \"name\": \"Potassium\",\n      \"amount\": \"195 mg\",\n      \"pct_daily_value\": \"6%\",\n      \"benefit\": \"Regulates blood pressure, supports heart rhythm, aids muscle contraction\"\n    },\n    {\n      \"name\": \"Manganese\",\n      \"amount\": \"0.08 mg\",\n      \"pct_daily_value\": \"3%\",\n      \"benefit\": \"Bone development, metabolism, antioxidant enzyme function\"\n    },\n    {\n      \"name\": \"Copper\",\n      \"amount\": \"0.04 mg\",\n      \"pct_daily_value\": \"4%\",\n      \"benefit\": \"Iron metabolism, connective tissue formation, antioxidant defense\"\n    }\n  ],\n  \"health_benefits\": [\n    \"High in soluble fiber (pectin) — supports gut health, satiety, and may improve cholesterol profile\",\n    \"Low glycemic index (~36) — minimal blood sugar spike; beneficial for glucose management\",\n    \"Polyphenol-rich (especially in skin) — quercetin, catechin, chlorogenic acid with anti-inflammatory and neuroprotective properties\",\n    \"Natural hydration — 86% water content supports cellular function\",\n    \"May reduce risk of type 2 diabetes and cardiovascular disease (epidemiological evidence)\",\n    \"Supports dental health — natural acidity and fiber promote saliva production and tooth cleaning\"\n  ],\n  \"best_for\": [\n    \"Weight management (low calorie density, high fiber = satiety)\",\n    \"Post-workout snack (carbs + hydration, minimal fat/protein)\",\n    \"Stable energy release (low GI, natural sugars + fiber)\",\n    \"Gut microbiome diversity (fermentable fiber feeds beneficial bacteria)\",\n    \"Blood sugar stability (when paired with protein/fat)\",\n    \"Sustained focus (slow glucose release vs. refined sugars)\"\n  ],\n  \"preparation_tips\": [\n    \"Leave skin on — contains ~70% of quercetin and 2× fiber of peeled apple\",\n    \"Eat whole rather than juiced — juice loses fiber and concentrates natural sugars\",\n    \"Pair with protein (yogurt, almond butter, cheese) to slow glucose absorption\",\n    \"Store at room temperature for 1 week or in refrigerator for up to 3 weeks (cold slows ripening)\",\n    \"Cut and toss with lemon juice if prepping ahead to prevent oxidation (browning)\",\n    \"Baked apple (180°C, 15–20 min) becomes softer and more digestible; pectin concentration increases as water evaporates\"\n  ],\n  \"pair_with\": [\n    \"Almond or peanut butter — adds protein, healthy fats, extends satiety\",\n    \"Greek yogurt — complete protein + probiotics + slower glucose absorption\",\n    \"Sharp cheddar or aged cheese — casein protein + fat-soluble vitamin absorption\",\n    \"Walnuts or flaxseeds — omega-3s, additional fiber, polyphenol synergy\",\n    \"Cinnamon — may improve insulin sensitivity (compounds like cinnamaldehyde)\",\n    \"Raw honey (1 tsp) — adds polyphenols, slower glycemic effect than processed sweeteners\"\n  ],\n  \"avoid_if\": [\n    \"Fructose malabsorption (FODMAP sensitivity) — apples are high in fructose; try banana or blueberry instead\",\n    \"Pesticide concern — buy organic or wash thoroughly (apples consistently rank in 'Dirty Dozen'); peeling removes ~70% of residues but also removes skin polyphenols\",\n    \"Tooth sensitivity or enamel erosion — eat apple with meals rather than as sole snack; rinse mouth with water afterward\",\n    \"Insulin resistance or Type 2 diabetes (unmanaged) — pair with protein/fat always; monitor individual glucose response via CGM if available\"\n  ],\n  \"whole_vs_processed\": \"Medium apple is a whole food with intact cell structure, natural fiber matrix, and bioavailable polyphenols. Applesauce loses structural fiber (pectin matrix broken), and juice concentrates natural sugars while removing fiber entirely (fructose absorption accelerated). Dried apples add concentrated sugars and often sulfites as preservatives. Choose whole apple first.\",\n  \"food_label_intelligence\": null,\n  \"pregnancy_lactation_notes\": \"Apples are safe and beneficial during pregnancy/lactation. Provide quercetin (mild anti-inflammatory), vitamin C (immune support), and fiber (addresses common pregnancy constipation). Wash thoroughly due to potential Listeria contamination on surface. No mercury or toxin concerns. Excellent vehicle for pairing with prenatal-required nutrients: pair with nut butters (choline, iron bioavailability), Greek yogurt (iodine, protein, calcium).\",\n  \"refeeding_protocol\": null,\n  \"amazon_search\": \"organic medium apples fresh\",\n  \"disclaimer\": \"For informational purposes only. Nutritional values are estimates and vary by source, variety (Gala vs. Granny Smith vs. Fuji), ripeness, and preparation. Values based on USDA FoodData Central. Individual responses (glucose, satiety) vary by insulin sensitivity and microbiome composition.\",\n  \"pulse_suggestions\": [\n    {\n      \"vertical\": \"MealPulse\",\n      \"url\": \"https://mealpulse.vercel.app\",\n      \"why\": \"If you're building a balanced meal plan, MealPulse can auto-generate recipes featuring apples with optimal macros, grocery prices by retailer, and shopping lists.\",\n      \"suggested_endpoint\": \"recipe_builder + macro_calculator + grocery_pricing\"\n    },\n    {\n      \"vertical\": \"ClimatePulse\",\n      \"url\": \"https://climatepulse-six.vercel.app\",\n      \"why\": \"If you grow apples or source locally, ClimatePulse provides USDA grow zone + frost date guidance to optimize yield and ripeness.\",\n      \"suggested_endpoint\": \"grow_zone_lookup + frost_date_calculator\"\n    }\n  ]\n}\n```\n\n---\n\n### Key Insight: **Skin Matters**\n\nA medium apple with skin delivers **4.4g fiber** (soluble pectin); peeled, it drops to ~2.2g. The skin polyphenols (quercetin especially) are responsible for most anti-inflammatory and cognitive benefits. If pesticide concern is high, buy organic Gala or Fuji apples (lower spray index than Granny Smith).\n\n**Glucose tip**: Eat whole + pair with 1 Tbsp almond butter to flatten the glucose curve and extend satiety by 3–4 hours.","meta":{"usda_matched":2},"affiliates":{"supplements":"https://www.amazon.com/s?k=medium%20apple&tag=pulsenetwork7-20","macro_tracking":"https://www.macrofactorapp.com/","global_supplements":"https://www.myprotein.com/","nutrition_tracking":"https://cronometer.com/premium/","functional_supplements":"https://www.onnit.com/"},"parse_error":true,"generated_at":"2026-06-18T05:34:30.266Z"}},"exampleRequest":{"lang":"en","query":"medium apple"},"tags":["x402"],"displayCostAmount":"0.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.08/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.08","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dMtOO2ICnbiTkkZmdM1z3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.08","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USDA nutritional breakdown with health context for any specified food item","exampleAgentPrompt":"Can you pull the full USDA nutritional breakdown with health context for a medium avocado — I want to see the calories, macros, vitamins, and any relevant health notes?","exampleUseCases":[{"title":"Daily meal prep nutrient tracking","prompt":"I'm planning my meals for tomorrow and need to check the nutritional breakdown for chicken breast, brown rice, and broccoli — can you pull the USDA data with calorie counts and macros so I can hit my daily protein targets?"},{"title":"Prenatal nutrition guidance support","prompt":"I'm pregnant and trying to understand which foods are best for fetal development — can you get the full nutritional breakdown for spinach, salmon, and eggs so I can see which ones have the most folate and iron?"},{"title":"Supplement stack optimization analysis","prompt":"I'm building a personalized supplement routine and want to understand the nutritional gaps in my diet — can you pull the detailed micronutrient profiles for almonds, greek yogurt, and kale so I know what I'm already getting from food?"}],"resultDescription":"A structured nutritional profile for the queried food item sourced from USDA data, including calorie count, macronutrients (protein, fat, carbohydrates), micronutrients (vitamins, minerals), and health context or dietary notes.","failureModes":["Food item not found in USDA database — returns 404 or empty result","Ambiguous food query with no match — may return generic or incorrect item","Payment not processed — x402 payment required before response is returned","Rate limiting or quota exceeded — returns 429 error","Malformed or missing food query parameter — returns 400 bad request"],"whenToPreferThis":"Choose this endpoint when you need USDA-backed nutritional data with added health context for a specific food item. It is ideal for dietary tracking, meal planning assistants, health apps, or any use case requiring authoritative nutritional information rather than general web-scraped or estimated values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:38:31.181Z","isFirstParty":false}