# USDA API: Get nutrition facts > Looks up a food in USDA FoodData Central and returns its nutrients per 100 g and for a chosen amount (grams, ounces, or a listed household portion). Unofficial. Not affiliated with or endorsed by USDA. - Page: https://fous.com/methods/fdc.nal.usda.gov/get-nutrition-facts - Method: `fdc.nal.usda.gov/get_nutrition_facts`, version 1 - Website: fdc.nal.usda.gov - Returns: matched food name, amount weight, nutrients per 100 g and per amount, page link, FDC id, data source type - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `food` | string | yes | `"cooked brown rice"` | Food in plain words, for example banana or cooked brown rice. | | `amount` | string | no | `"1 cup"` | Amount to calculate, for example 1 cup, 150 g, or 2 large. Defaults to 100 g. Default "100 g". | ## Output From a run on Oct 23, 2026. Its input: ```json { "food": "cooked brown rice", "amount": "1 cup" } ``` Its output: ```json { "fdc_id": 169704, "page_link": "https://fdc.nal.usda.gov/food-details/169704/nutrients", "per_100_g": { "fiber_g": 1.6, "iron_mg": 0.56, "sugars_g": 0.24, "protein_g": 2.74, "sodium_mg": 4, "calcium_mg": 3, "total_fat_g": 0.97, "potassium_mg": 86, "vitamin_c_mg": 0, "vitamin_d_ug": 0, "calories_kcal": 123, "cholesterol_mg": 0, "carbohydrates_g": 25.6, "saturated_fat_g": 0.26 }, "per_amount": { "fiber_g": 3.232, "iron_mg": 1.1312, "sugars_g": 0.4848, "protein_g": 5.5348, "sodium_mg": 8.08, "calcium_mg": 6.06, "total_fat_g": 1.9594, "potassium_mg": 173.72, "vitamin_c_mg": 0, "vitamin_d_ug": 0, "calories_kcal": 248.46, "cholesterol_mg": 0, "carbohydrates_g": 51.712, "saturated_fat_g": 0.5252 }, "amount_used": "1 cup", "amount_weight_g": 202, "data_source_type": "SR Legacy", "matched_food_name": "Rice, brown, long-grain, cooked (Includes foods for USDA's Food Distribution Program)" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"fdc.nal.usda.gov/get_nutrition_facts","input":{"food":"cooked brown rice","amount":"1 cup"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - How many calories and protein are in 150 g of cooked brown rice? - Nutrition breakdown for one medium banana, per 100 g and per banana - What's the sodium and fiber content of 2 ounces of raw spinach? - Look up the USDA nutrient profile for 1 cup of rolled oats - Protein, fat, and carbs in 3 large eggs according to USDA FoodData Central ## Input schema ```json { "type": "object", "required": [ "food" ], "properties": { "food": { "type": "string", "minLength": 1, "description": "Food in plain words, for example banana or cooked brown rice." }, "amount": { "type": "string", "default": "100 g", "description": "Amount to calculate, for example 1 cup, 150 g, or 2 large. Defaults to 100 g." } } } ``` ## Output schema ```json { "type": "object", "required": [ "matched_food_name", "amount_used", "amount_weight_g", "per_100_g", "per_amount", "page_link", "fdc_id", "data_source_type" ], "properties": { "fdc_id": { "type": "integer", "x-fous-developer": true }, "page_link": { "type": "string" }, "per_100_g": { "type": "object", "required": [ "calories_kcal", "protein_g", "carbohydrates_g", "sugars_g", "fiber_g", "total_fat_g", "saturated_fat_g", "cholesterol_mg", "sodium_mg", "potassium_mg", "calcium_mg", "iron_mg", "vitamin_c_mg", "vitamin_d_ug" ], "properties": { "fiber_g": { "type": [ "number", "null" ], "description": "Fiber in grams" }, "iron_mg": { "type": [ "number", "null" ], "description": "Iron in milligrams" }, "sugars_g": { "type": [ "number", "null" ], "description": "Sugars in grams" }, "protein_g": { "type": [ "number", "null" ], "description": "Protein in grams" }, "sodium_mg": { "type": [ "number", "null" ], "description": "Sodium in milligrams" }, "calcium_mg": { "type": [ "number", "null" ], "description": "Calcium in milligrams" }, "total_fat_g": { "type": [ "number", "null" ], "description": "Total fat in grams" }, "potassium_mg": { "type": [ "number", "null" ], "description": "Potassium in milligrams" }, "vitamin_c_mg": { "type": [ "number", "null" ], "description": "Vitamin C in milligrams" }, "vitamin_d_ug": { "type": [ "number", "null" ], "description": "Vitamin D in micrograms" }, "calories_kcal": { "type": [ "number", "null" ], "description": "Calories in kilocalories" }, "cholesterol_mg": { "type": [ "number", "null" ], "description": "Cholesterol in milligrams" }, "carbohydrates_g": { "type": [ "number", "null" ], "description": "Carbohydrates in grams" }, "saturated_fat_g": { "type": [ "number", "null" ], "description": "Saturated fat in grams" } }, "additionalProperties": false }, "per_amount": { "type": "object", "required": [ "calories_kcal", "protein_g", "carbohydrates_g", "sugars_g", "fiber_g", "total_fat_g", "saturated_fat_g", "cholesterol_mg", "sodium_mg", "potassium_mg", "calcium_mg", "iron_mg", "vitamin_c_mg", "vitamin_d_ug" ], "properties": { "fiber_g": { "type": [ "number", "null" ], "description": "Fiber in grams" }, "iron_mg": { "type": [ "number", "null" ], "description": "Iron in milligrams" }, "sugars_g": { "type": [ "number", "null" ], "description": "Sugars in grams" }, "protein_g": { "type": [ "number", "null" ], "description": "Protein in grams" }, "sodium_mg": { "type": [ "number", "null" ], "description": "Sodium in milligrams" }, "calcium_mg": { "type": [ "number", "null" ], "description": "Calcium in milligrams" }, "total_fat_g": { "type": [ "number", "null" ], "description": "Total fat in grams" }, "potassium_mg": { "type": [ "number", "null" ], "description": "Potassium in milligrams" }, "vitamin_c_mg": { "type": [ "number", "null" ], "description": "Vitamin C in milligrams" }, "vitamin_d_ug": { "type": [ "number", "null" ], "description": "Vitamin D in micrograms" }, "calories_kcal": { "type": [ "number", "null" ], "description": "Calories in kilocalories" }, "cholesterol_mg": { "type": [ "number", "null" ], "description": "Cholesterol in milligrams" }, "carbohydrates_g": { "type": [ "number", "null" ], "description": "Carbohydrates in grams" }, "saturated_fat_g": { "type": [ "number", "null" ], "description": "Saturated fat in grams" } }, "additionalProperties": false }, "amount_used": { "type": "string" }, "amount_weight_g": { "type": "number" }, "data_source_type": { "type": "string", "x-fous-developer": true }, "matched_food_name": { "type": "string" } }, "additionalProperties": false } ``` ## See more - [USDA API: Search foods](https://fous.com/methods/fdc.nal.usda.gov/search-foods.md): Searches USDA FoodData Central foods and branded products by food or brand name, ranked by relevance. Calories and serving sizes are null when not supplied. - [McDonald's API: Get menu item nutrition](https://fous.com/methods/mcdonalds.com/get-menu-item-nutrition.md): Looks up a McDonald's menu item by name on the US, UK or Canada site and returns its nutrition, allergens, ingredients and photo link. - [Open Food Facts API: Search packaged foods](https://fous.com/methods/openfoodfacts.org/search-products.md): Searches Open Food Facts packaged foods by name, optionally filtered by diet, country where sold and brand, ordered by popularity (most scanned first). - [Open Food Facts API: Get packaged food product](https://fous.com/methods/openfoodfacts.org/get-product.md): Looks up a packaged food by barcode or by product name and brand, returning ingredients, allergens, Nutri-Score, NOVA processing level and nutrition from Open Food Facts. - [FDA API: Search food recalls](https://fous.com/methods/open.fda.gov/search-food-recalls.md): Finds FDA food recall enforcement reports by product, brand, or allergen, newest first. Reports are updated weekly and recall statuses may lag. - [ALDI API: Search products](https://fous.com/methods/aldi.us/search-products.md): Search ALDI US groceries in site order with prices for the selected store. Prices and availability vary by store; related search results may follow direct matches. - [Food Standards Agency API: Find food hygiene ratings](https://fous.com/methods/ratings.food.gov.uk/get-hygiene-rating.md): Finds food businesses by name and town, street or postcode and returns their official food hygiene rating, inspection date and score descriptions. Scottish ratings usually have no component scores. - [NIH API: Get chemical facts by name or CAS number](https://fous.com/methods/pubchem.ncbi.nlm.nih.gov/get-chemical.md): Looks up a chemical on PubChem by common name or CAS number and returns its formula, molecular weight, names, description, SMILES, InChIKey and 2D structure image link. - [All USDA methods](https://fous.com/methods/usda.gov.md)