{"uid":"cap_JjZUlojNUCuRTexwVmoCW","slug":"usda-fooddata-central-food-search-2571035a","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://api.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_yQ8XM9a385yCqQsFOUM6s","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 for foods by name in the USDA FoodData Central database, returning ranked matches with nutrition macros per 100g","exampleAgentPrompt":"Search the USDA FoodData Central database for 'avocado' and show me the top 5 ranked matches including their fdc_id, description, brand, and key macros per 100g — filter to Foundation foods only.","exampleUseCases":null,"resultDescription":"A ranked list of food matches from USDA FoodData Central, each containing fdc_id, food description, brand name, GTIN barcode, and key macronutrients (calories, protein, fat, carbohydrates) per 100g, ordered by relevance to the search query.","failureModes":["No matches found for obscure or misspelled food names","Query parameter missing returns validation error","Limit exceeds maximum of 25 returns error","Invalid dataType enum value returns error","Upstream USDA FoodData Central API unavailability causes 503"],"whenToPreferThis":"Use this endpoint when you need to search for foods by name and retrieve structured nutritional macro data from the authoritative US government food database. Ideal for dietary tracking apps, meal planners, ingredient analyzers, or any workflow needing standardized fdc_id identifiers or GTIN barcodes for foods. Prefer this over generic nutrition APIs when USDA provenance, public-domain data, or filtering by USDA data type (Foundation, Branded, SR Legacy, etc.) is important.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:37.513Z","isFirstParty":false}