{"uid":"cap_Ry0Sqh9xTipTXzhmBwIbK","slug":"usda-fooddata-central-food-search-91be4eb5","name":"USDA FoodData Central Food Search","description":"Search foods by name in USDA FoodData Central (public domain). Returns ranked matches with fdc_id, description, brand, GTIN and key macros per 100g.","url":"https://payai.agentstools.dev/nutrition/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Food name to search for"},"limit":{"type":"integer","maximum":25,"minimum":1,"description":"Max ranked matches (default 10)"},"dataType":{"enum":["Foundation","SR Legacy","Branded","Survey (FNDDS)","Experimental"],"type":"string","description":"Optional USDA data-type filter"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_f35T1l6c0SEzV3psW6MJw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search foods by name against USDA FoodData Central and return ranked matches with nutrition macros per 100g","exampleAgentPrompt":"Search the USDA FoodData Central database for 'chicken breast' and return up to 5 ranked matches with their macros per 100g — limit it to Foundation foods only.","exampleUseCases":null,"resultDescription":"A ranked list of food matches (up to 25), each with fdc_id, description, brand name, GTIN/barcode, and key macronutrients (calories, protein, fat, carbohydrates) per 100g, sourced from USDA FoodData Central.","failureModes":["Empty or whitespace query returns no results or validation error","Unrecognized dataType enum value causes filter to fail or be ignored","limit out of range (below 1 or above 25) triggers schema validation error","Very generic query terms may return poorly ranked or irrelevant results","USDA FoodData Central upstream unavailability causes service errors","No matching foods found returns empty results array"],"whenToPreferThis":"Choose this endpoint when you need authoritative USDA nutritional data for a food by name, especially when you need fdc_ids for further lookups, want macros per 100g across multiple food types (Foundation, SR Legacy, Branded, Survey), or need to resolve branded food GTINs. Prefer this over generic nutrition APIs when regulatory-grade or public-domain data provenance matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:09:59.452Z","isFirstParty":false}