--- type: "firecrawl-provider" description: "USDA Agricultural Research Service FoodData Central: the authoritative US food-composition database (Foundation Foods, SR Legacy, Survey/FNDDS, Branded Foods, Experimental Foods). Food search and listing by data type, the complete nutrient record of one food (per 100 g values, data points, min/max/median, derivation, portions, conversion factors, brand and label data), nutrient-centric search (which foods carry a given nutrient such as biotin, chromium, molybdenum or an amino acid, ranked by amount), the nutrient reference list and the food-category lists. Anonymous JSON backend of the public web portal; public-domain data (CC0 1.0)." use_when: "USDA Agricultural Research Service FoodData Central: the authoritative US food-composition database (Foundation Foods, SR Legacy, Survey/FNDDS, Branded Foods, Experimental Foods). Food search and listing by data type, the complete nutrient record of one food (per 100 g values, data points, min/max/median, derivation, portions, conversion factors, brand and label data), nutrient-centric search (which foods carry a given nutrient such as biotin, chromium, molybdenum or an amino acid, ranked by amount), the nutrient reference list and the food-category lists. Anonymous JSON backend of the public web portal; public-domain data (CC0 1.0)." categories: "Public records" capabilities: 5 credits_per_call: 5 --- # USDA FoodData Central (fdc.nal.usda.gov) on Firecrawl Alexandria USDA Agricultural Research Service FoodData Central: the authoritative US food-composition database (Foundation Foods, SR Legacy, Survey/FNDDS, Branded Foods, Experimental Foods). Food search and listing by data type, the complete nutrient record of one food (per 100 g values, data points, min/max/median, derivation, portions, conversion factors, brand and label data), nutrient-centric search (which foods carry a given nutrient such as biotin, chromium, molybdenum or an amino acid, ranked by amount), the nutrient reference list and the food-category lists. Anonymous JSON backend of the public web portal; public-domain data (CC0 1.0). - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `fdc-nal-usda-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/fdc-nal-usda-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/openapi.json) ## Capabilities - [Get food](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/get_food): The complete FoodData Central record of one food by FDC id (GET /portal-data/external/{fdcId}, the web portal's own backend; also accepts a pasted fdc.nal.usda.gov/food-details/{fdcId}/... URL). Returns identity (data type, NDB number / FNDDS food code / GTIN-UPC, category, publication and update dates), every nutrient with its per-100 g value, unit, data points, min/max/median, derivation and source, portions with gram weights, nutrient conversion factors, ontology attributes (FoodOn, NCBI taxon), the Survey input foods, and for Branded foods the brand, ingredients, serving size and label nutrients. Section-header rows without a value (e.g. 'Proximates') and the per-sample laboratory analysis details of Foundation foods are not returned; `analyses` counts them. Missing optional fields are null. An unknown id is `not_found`. - [List food categories](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/list_food_categories): The food category list of one data type (GET /portal-data/external/foundationSRFoodCategoryList, sRLegacySRFoodCategoryList or surveyWWEIAFoodCategoryList): the Foundation and SR Legacy food groups with their 4-digit codes (Dairy and Egg Products 0100, ...) and the WWEIA food categories of Survey (FNDDS) foods (code is null there). Category descriptions are what `search_foods` reports as `food_category` and `get_food` as `food_category.description`. - [List nutrients](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/list_nutrients): The FoodData Central nutrient reference list (GET /portal-data/external/fullNutrientList): every nutrient the database can report (267 entries) with its id (the key `search_foods_by_nutrient` takes), nutrient number (the public API's key), name, unit, display rank and indent level. An optional case-insensitive text filter matches the name, short name or number, so 'biotin', 'chromium', 'molybdenum' or an amino acid name return just those rows; no match is a valid empty list. - [Search foods](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/search_foods): Search FoodData Central foods (POST /portal-data/external/search, the web portal's own backend) by free text across one or more data types (Foundation, SR Legacy, Survey (FNDDS), Branded, Experimental). The text matches descriptions, brand owners, ingredients and GTIN/UPC codes; an empty query lists every food of the selected data types (e.g. all ~400 Foundation foods), sorted by description or published date. 50 results per page; `total_hits` and `counts_by_data_type` report how many foods match in every data type regardless of the filter. Each result carries the FDC id that `get_food` takes, the data-type specific identifier (NDB number, FNDDS food code or GTIN/UPC), brand and category fields where the data type has them (null otherwise) and, when `include_nutrients` is true, the per-100 g nutrient values the portal returns with every result. A page past the last page is `not_found`; a query with no match is a valid empty result. - [Search foods by nutrient](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/search_foods_by_nutrient): Nutrient-centric search (POST /portal-data/external/nutrientList/search, the web portal's 'Nutrient search'): the foods that carry a value for one nutrient, ranked by amount per 100 g, optionally restricted to data types. Takes the nutrient id from `list_nutrients` (e.g. 1176 Biotin, 1096 Chromium, 1102 Molybdenum, 1100 Iodine, 1210 Tryptophan, 1051 Water), not the nutrient number. Returns the nutrient's reference identity and unit, the matching foods with their FDC id, data type, native identifier (NDB number, UPC/GTIN or food code), value and the portal's household measure, plus `counts_by_data_type` (matching foods per data type across all types). This is the tool for coverage questions: which Foundation or SR Legacy foods have biotin at all. An unknown nutrient id is `not_found`; a nutrient no food carries is a valid empty result. 25 results per page by default (1-100). ## 1. Choose this provider when USDA Agricultural Research Service FoodData Central: the authoritative US food-composition database (Foundation Foods, SR Legacy, Survey/FNDDS, Branded Foods, Experimental Foods). Food search and listing by data type, the complete nutrient record of one food (per 100 g values, data points, min/max/median, derivation, portions, conversion factors, brand and label data), nutrient-centric search (which foods carry a given nutrient such as biotin, chromium, molybdenum or an amino acid, ranked by amount), the nutrient reference list and the food-category lists. Anonymous JSON backend of the public web portal; public-domain data (CC0 1.0). ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "fdc-nal-usda-gov", "capability": "foods/get_food", "options": { "fdc_id": 2705709 } } ``` ## 3. Add provider options Use only the options needed for the task: - `fdc_id` (number): FoodData Central id (e.g. 328637 Cheese, cheddar; 2705709 Survey cheddar; 2672832 a Branded cracker). Give either fdc_id or url. Example: `10` - `url` (string): A food page URL such as https://fdc.nal.usda.gov/food-details/328637/nutrients. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "fdc-nal-usda-gov", capability: "foods/get_food", options: { fdc_id: 2705709, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "fdc-nal-usda-gov", "capability": "foods/get_food", "options": { "fdc_id": 2705709 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "fdc-nal-usda-gov", "capability": "foods/get_food", "options": { "fdc_id": 2705709 } } }' ``` ### CLI ```sh firecrawl scrape 'fdc-nal-usda-gov/foods/get_food' \ --options '{"fdc_id":2705709}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "fdc-nal-usda-gov", "capability": "foods/get_food", "options": { "fdc_id": 2705709 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "fdc-nal-usda-gov", "capability": "foods/get_food", "options": { "fdc_id": 2705709 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "attributes": [ { "name": "WWEIA Category description", "value": "Cheese" }, { "name": "WWEIA Category number", "value": "1602" }, { "name": null, "value": "Wisconsin" }, { "name": null, "value": "sharp cheese" }, { "name": null, "value": "Hoop" }, { "name": null, "value": "Tillamook" }, { "name": null, "value": "Longhorn" }, { "name": null, "value": "Pioneer" }, { "name": null, "value": "Coon" }, { "name": null, "value": "New York" }, { "name": null, "value": "Moisture change: 0%" } ], "brand": null, "conversion_factors": [], "data_type": "Survey (FNDDS)", "description": "Cheese, Cheddar", "fdc_id": 2705709, "food_category": { "code": null, "description": "Cheese", "id": 3298966 }, "food_class": "Survey", "food_code": "14104100", "gtin_upc": null, "is_historical_reference": null, "label_nutrients": null, "last_updated": "10/31/2024", "ndb_number": null, "nutrient_count": 65, "nutrients": [ { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Protein", "number": "203", "nutrient_id": 1003, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 23.3 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Total lipid (fat)", "number": "204", "nutrient_id": 1004, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 34 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carbohydrate, by difference", "number": "205", "nutrient_id": 1005, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 2.44 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Energy", "number": "208", "nutrient_id": 1008, "percent_daily_value": null, "source_description": null, "unit": "kcal", "value": 409 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Alcohol, ethyl", "number": "221", "nutrient_id": 1018, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Water", "number": "255", "nutrient_id": 1051, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 36.6 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Caffeine", "number": "262", "nutrient_id": 1057, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Theobromine", "number": "263", "nutrient_id": 1058, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Total Sugars", "number": "269", "nutrient_id": 2000, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.33 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fiber, total dietary", "number": "291", "nutrient_id": 1079, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Calcium, Ca", "number": "301", "nutrient_id": 1087, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 707 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Iron, Fe", "number": "303", "nutrient_id": 1089, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.16 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Magnesium, Mg", "number": "304", "nutrient_id": 1090, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 27 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Phosphorus, P", "number": "305", "nutrient_id": 1091, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 458 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Potassium, K", "number": "306", "nutrient_id": 1092, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 77 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Sodium, Na", "number": "307", "nutrient_id": 1093, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 654 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Zinc, Zn", "number": "309", "nutrient_id": 1095, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 3.67 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Copper, Cu", "number": "312", "nutrient_id": 1098, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.033 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Selenium, Se", "number": "317", "nutrient_id": 1103, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 28.3 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Retinol", "number": "319", "nutrient_id": 1105, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 316 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin A, RAE", "number": "320", "nutrient_id": 1106, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 316 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carotene, beta", "number": "321", "nutrient_id": 1107, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carotene, alpha", "number": "322", "nutrient_id": 1108, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin E (alpha-tocopherol)", "number": "323", "nutrient_id": 1109, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.75 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin D (D2 + D3)", "number": "328", "nutrient_id": 1114, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0.6 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Cryptoxanthin, beta", "number": "334", "nutrient_id": 1120, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Lycopene", "number": "337", "nutrient_id": 1122, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Lutein + zeaxanthin", "number": "338", "nutrient_id": 1123, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin C, total ascorbic acid", "number": "401", "nutrient_id": 1162, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Thiamin", "number": "404", "nutrient_id": 1165, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.029 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Riboflavin", "number": "405", "nutrient_id": 1166, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.441 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Niacin", "number": "406", "nutrient_id": 1167, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.052 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-6", "number": "415", "nutrient_id": 1175, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.069 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, total", "number": "417", "nutrient_id": 1177, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-12", "number": "418", "nutrient_id": 1178, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 1.06 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Choline, total", "number": "421", "nutrient_id": 1180, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 16.5 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin K (phylloquinone)", "number": "430", "nutrient_id": 1185, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 2.4 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folic acid", "number": "431", "nutrient_id": 1186, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, food", "number": "432", "nutrient_id": 1187, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, DFE", "number": "435", "nutrient_id": 1190, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin E, added", "number": "573", "nutrient_id": 1242, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-12, added", "number": "578", "nutrient_id": 1246, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Cholesterol", "number": "601", "nutrient_id": 1253, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 100 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total saturated", "number": "606", "nutrient_id": 1258, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 19.2 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 4:0", "number": "607", "nutrient_id": 1259, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.653 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 6:0", "number": "608", "nutrient_id": 1260, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.543 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 8:0", "number": "609", "nutrient_id": 1261, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.349 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 10:0", "number": "610", "nutrient_id": 1262, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.843 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 12:0", "number": "611", "nutrient_id": 1263, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.963 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 14:0", "number": "612", "nutrient_id": 1264, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 3.1 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 16:0", "number": "613", "nutrient_id": 1265, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 8.79 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 18:0", "number": "614", "nutrient_id": 1266, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 3.39 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 18:1", "number": "617", "nutrient_id": 1268, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 7.41 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:2", "number": "618", "nutrient_id": 1269, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 1.16 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:3", "number": "619", "nutrient_id": 1270, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.121 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 20:4", "number": "620", "nutrient_id": 1271, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.051 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 22:6 n-3 (DHA)", "number": "621", "nutrient_id": 1272, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 16:1", "number": "626", "nutrient_id": 1275, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.516 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:4", "number": "627", "nutrient_id": 1276, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 20:1", "number": "628", "nutrient_id": 1277, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.064 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 20:5 n-3 (EPA)", "number": "629", "nutrient_id": 1278, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.01 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 22:1", "number": "630", "nutrient_id": 1279, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 22:5 n-3 (DPA)", "number": "631", "nutrient_id": 1280, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.018 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total monounsaturated", "number": "645", "nutrient_id": 1292, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 7.44 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total polyunsaturated", "number": "646", "nutrient_id": 1293, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 1.18 } ], "observed_at_ms": 1791014877628, "portions": [ { "amount": null, "data_points": null, "description": "1 slice", "gram_weight": 21, "id": 291559, "modifier": "61935", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, diced", "gram_weight": 132, "id": 291562, "modifier": "10066", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, shredded", "gram_weight": 113, "id": 291561, "modifier": "10159", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, NFS", "gram_weight": 113, "id": 291564, "modifier": "10010", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, melted", "gram_weight": 244, "id": 291563, "modifier": "10120", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, cubed", "gram_weight": 132, "id": 291565, "modifier": "10310", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cracker-size slice", "gram_weight": 9, "id": 291558, "modifier": "64017", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "Quantity not specified", "gram_weight": 21, "id": 291567, "modifier": "90000", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 stick", "gram_weight": 28.35, "id": 291560, "modifier": "62239", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cubic inch", "gram_weight": 17, "id": 291566, "modifier": "51000", "unit": "undetermined" } ], "published_date": "10/31/2024", "source_url": "https://fdc.nal.usda.gov/portal-data/external/2705709", "survey": { "end_date": "12/31/2023", "input_foods": [ { "description": "Cheese, cheddar", "gram_weight": 100, "portion_description": "NONE", "sr_code": "1009" } ], "start_date": "1/1/2021" }, "total_refuse": 0, "url": "https://fdc.nal.usda.gov/food-details/2705709/nutrients" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get food - Capability: `foods/get_food` - Description: The complete FoodData Central record of one food by FDC id (GET /portal-data/external/{fdcId}, the web portal's own backend; also accepts a pasted fdc.nal.usda.gov/food-details/{fdcId}/... URL). Returns identity (data type, NDB number / FNDDS food code / GTIN-UPC, category, publication and update dates), every nutrient with its per-100 g value, unit, data points, min/max/median, derivation and source, portions with gram weights, nutrient conversion factors, ontology attributes (FoodOn, NCBI taxon), the Survey input foods, and for Branded foods the brand, ingredients, serving size and label nutrients. Section-header rows without a value (e.g. 'Proximates') and the per-sample laboratory analysis details of Foundation foods are not returned; `analyses` counts them. Missing optional fields are null. An unknown id is `not_found`. - Instructions: After `search_foods` or `search_foods_by_nutrient` returned an FDC id, or when the user pastes a food-details URL. - Cost: 5 credits per call - Capability file: [Get food](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/get_food) Accepted options: - `fdc_id` (number): FoodData Central id (e.g. 328637 Cheese, cheddar; 2705709 Survey cheddar; 2672832 a Branded cracker). Give either fdc_id or url. Example: `10` - `url` (string): A food page URL such as https://fdc.nal.usda.gov/food-details/328637/nutrients. Example: `` Response schema example: ```json { "attributes": [ { "name": "WWEIA Category description", "value": "Cheese" }, { "name": "WWEIA Category number", "value": "1602" }, { "name": null, "value": "Wisconsin" }, { "name": null, "value": "sharp cheese" }, { "name": null, "value": "Hoop" }, { "name": null, "value": "Tillamook" }, { "name": null, "value": "Longhorn" }, { "name": null, "value": "Pioneer" }, { "name": null, "value": "Coon" }, { "name": null, "value": "New York" }, { "name": null, "value": "Moisture change: 0%" } ], "brand": null, "conversion_factors": [], "data_type": "Survey (FNDDS)", "description": "Cheese, Cheddar", "fdc_id": 2705709, "food_category": { "code": null, "description": "Cheese", "id": 3298966 }, "food_class": "Survey", "food_code": "14104100", "gtin_upc": null, "is_historical_reference": null, "label_nutrients": null, "last_updated": "10/31/2024", "ndb_number": null, "nutrient_count": 65, "nutrients": [ { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Protein", "number": "203", "nutrient_id": 1003, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 23.3 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Total lipid (fat)", "number": "204", "nutrient_id": 1004, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 34 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carbohydrate, by difference", "number": "205", "nutrient_id": 1005, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 2.44 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Energy", "number": "208", "nutrient_id": 1008, "percent_daily_value": null, "source_description": null, "unit": "kcal", "value": 409 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Alcohol, ethyl", "number": "221", "nutrient_id": 1018, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Water", "number": "255", "nutrient_id": 1051, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 36.6 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Caffeine", "number": "262", "nutrient_id": 1057, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Theobromine", "number": "263", "nutrient_id": 1058, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Total Sugars", "number": "269", "nutrient_id": 2000, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.33 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fiber, total dietary", "number": "291", "nutrient_id": 1079, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Calcium, Ca", "number": "301", "nutrient_id": 1087, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 707 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Iron, Fe", "number": "303", "nutrient_id": 1089, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.16 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Magnesium, Mg", "number": "304", "nutrient_id": 1090, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 27 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Phosphorus, P", "number": "305", "nutrient_id": 1091, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 458 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Potassium, K", "number": "306", "nutrient_id": 1092, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 77 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Sodium, Na", "number": "307", "nutrient_id": 1093, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 654 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Zinc, Zn", "number": "309", "nutrient_id": 1095, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 3.67 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Copper, Cu", "number": "312", "nutrient_id": 1098, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.033 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Selenium, Se", "number": "317", "nutrient_id": 1103, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 28.3 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Retinol", "number": "319", "nutrient_id": 1105, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 316 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin A, RAE", "number": "320", "nutrient_id": 1106, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 316 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carotene, beta", "number": "321", "nutrient_id": 1107, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Carotene, alpha", "number": "322", "nutrient_id": 1108, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin E (alpha-tocopherol)", "number": "323", "nutrient_id": 1109, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.75 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin D (D2 + D3)", "number": "328", "nutrient_id": 1114, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0.6 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Cryptoxanthin, beta", "number": "334", "nutrient_id": 1120, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Lycopene", "number": "337", "nutrient_id": 1122, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Lutein + zeaxanthin", "number": "338", "nutrient_id": 1123, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin C, total ascorbic acid", "number": "401", "nutrient_id": 1162, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Thiamin", "number": "404", "nutrient_id": 1165, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.029 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Riboflavin", "number": "405", "nutrient_id": 1166, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.441 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Niacin", "number": "406", "nutrient_id": 1167, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.052 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-6", "number": "415", "nutrient_id": 1175, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0.069 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, total", "number": "417", "nutrient_id": 1177, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-12", "number": "418", "nutrient_id": 1178, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 1.06 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Choline, total", "number": "421", "nutrient_id": 1180, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 16.5 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin K (phylloquinone)", "number": "430", "nutrient_id": 1185, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 2.4 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folic acid", "number": "431", "nutrient_id": 1186, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, food", "number": "432", "nutrient_id": 1187, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Folate, DFE", "number": "435", "nutrient_id": 1190, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 21 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin E, added", "number": "573", "nutrient_id": 1242, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Vitamin B-12, added", "number": "578", "nutrient_id": 1246, "percent_daily_value": null, "source_description": null, "unit": "µg", "value": 0 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Cholesterol", "number": "601", "nutrient_id": 1253, "percent_daily_value": null, "source_description": null, "unit": "mg", "value": 100 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total saturated", "number": "606", "nutrient_id": 1258, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 19.2 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 4:0", "number": "607", "nutrient_id": 1259, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.653 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 6:0", "number": "608", "nutrient_id": 1260, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.543 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 8:0", "number": "609", "nutrient_id": 1261, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.349 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 10:0", "number": "610", "nutrient_id": 1262, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.843 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 12:0", "number": "611", "nutrient_id": 1263, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.963 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 14:0", "number": "612", "nutrient_id": 1264, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 3.1 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 16:0", "number": "613", "nutrient_id": 1265, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 8.79 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "SFA 18:0", "number": "614", "nutrient_id": 1266, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 3.39 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 18:1", "number": "617", "nutrient_id": 1268, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 7.41 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:2", "number": "618", "nutrient_id": 1269, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 1.16 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:3", "number": "619", "nutrient_id": 1270, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.121 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 20:4", "number": "620", "nutrient_id": 1271, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.051 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 22:6 n-3 (DHA)", "number": "621", "nutrient_id": 1272, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 16:1", "number": "626", "nutrient_id": 1275, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.516 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 18:4", "number": "627", "nutrient_id": 1276, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 20:1", "number": "628", "nutrient_id": 1277, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.064 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 20:5 n-3 (EPA)", "number": "629", "nutrient_id": 1278, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.01 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "MUFA 22:1", "number": "630", "nutrient_id": 1279, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.001 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "PUFA 22:5 n-3 (DPA)", "number": "631", "nutrient_id": 1280, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 0.018 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total monounsaturated", "number": "645", "nutrient_id": 1292, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 7.44 }, { "analyses": null, "data_points": null, "derivation_code": null, "derivation_description": null, "max": null, "median": null, "min": null, "name": "Fatty acids, total polyunsaturated", "number": "646", "nutrient_id": 1293, "percent_daily_value": null, "source_description": null, "unit": "g", "value": 1.18 } ], "observed_at_ms": 1791014877628, "portions": [ { "amount": null, "data_points": null, "description": "1 slice", "gram_weight": 21, "id": 291559, "modifier": "61935", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, diced", "gram_weight": 132, "id": 291562, "modifier": "10066", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, shredded", "gram_weight": 113, "id": 291561, "modifier": "10159", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, NFS", "gram_weight": 113, "id": 291564, "modifier": "10010", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, melted", "gram_weight": 244, "id": 291563, "modifier": "10120", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cup, cubed", "gram_weight": 132, "id": 291565, "modifier": "10310", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cracker-size slice", "gram_weight": 9, "id": 291558, "modifier": "64017", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "Quantity not specified", "gram_weight": 21, "id": 291567, "modifier": "90000", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 stick", "gram_weight": 28.35, "id": 291560, "modifier": "62239", "unit": "undetermined" }, { "amount": null, "data_points": null, "description": "1 cubic inch", "gram_weight": 17, "id": 291566, "modifier": "51000", "unit": "undetermined" } ], "published_date": "10/31/2024", "source_url": "https://fdc.nal.usda.gov/portal-data/external/2705709", "survey": { "end_date": "12/31/2023", "input_foods": [ { "description": "Cheese, cheddar", "gram_weight": 100, "portion_description": "NONE", "sr_code": "1009" } ], "start_date": "1/1/2021" }, "total_refuse": 0, "url": "https://fdc.nal.usda.gov/food-details/2705709/nutrients" } ``` ### List food categories - Capability: `foods/list_food_categories` - Description: The food category list of one data type (GET /portal-data/external/foundationSRFoodCategoryList, sRLegacySRFoodCategoryList or surveyWWEIAFoodCategoryList): the Foundation and SR Legacy food groups with their 4-digit codes (Dairy and Egg Products 0100, ...) and the WWEIA food categories of Survey (FNDDS) foods (code is null there). Category descriptions are what `search_foods` reports as `food_category` and `get_food` as `food_category.description`. - Instructions: To see how FoodData Central groups foods of a data type, or to resolve a category code. - Cost: 5 credits per call - Capability file: [List food categories](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/list_food_categories) Accepted options: - `data_type` (string, required): Branded foods have no portal category list (their GPC category is a free string on each record). Example: `Foundation` Response schema example: ```json { "categories": [ { "code": "1800", "description": "Baked Products", "id": 18 }, { "code": "1300", "description": "Beef Products", "id": 13 }, { "code": "1400", "description": "Beverages", "id": 14 }, { "code": "2000", "description": "Cereal Grains and Pasta", "id": 20 }, { "code": "0100", "description": "Dairy and Egg Products", "id": 1 }, { "code": "0400", "description": "Fats and Oils", "id": 4 }, { "code": "1500", "description": "Finfish and Shellfish Products", "id": 15 }, { "code": "0900", "description": "Fruits and Fruit Juices", "id": 9 }, { "code": "1700", "description": "Lamb, Veal, and Game Products", "id": 17 }, { "code": "1600", "description": "Legumes and Legume Products", "id": 16 }, { "code": "1200", "description": "Nut and Seed Products", "id": 12 }, { "code": "1000", "description": "Pork Products", "id": 10 }, { "code": "0500", "description": "Poultry Products", "id": 5 }, { "code": "3600", "description": "Restaurant Foods", "id": 25 }, { "code": "0700", "description": "Sausages and Luncheon Meats", "id": 7 }, { "code": "0600", "description": "Soups, Sauces, and Gravies", "id": 6 }, { "code": "0200", "description": "Spices and Herbs", "id": 2 }, { "code": "1900", "description": "Sweets", "id": 19 }, { "code": "1100", "description": "Vegetables and Vegetable Products", "id": 11 } ], "count": 19, "data_type": "Foundation", "observed_at_ms": 1791014891311, "source_url": "https://fdc.nal.usda.gov/portal-data/external/foundationSRFoodCategoryList" } ``` ### List nutrients - Capability: `foods/list_nutrients` - Description: The FoodData Central nutrient reference list (GET /portal-data/external/fullNutrientList): every nutrient the database can report (267 entries) with its id (the key `search_foods_by_nutrient` takes), nutrient number (the public API's key), name, unit, display rank and indent level. An optional case-insensitive text filter matches the name, short name or number, so 'biotin', 'chromium', 'molybdenum' or an amino acid name return just those rows; no match is a valid empty list. - Instructions: To find a nutrient id or unit before `search_foods_by_nutrient`, or to see which nutrients the database tracks at all. - Cost: 5 credits per call - Capability file: [List nutrients](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/list_nutrients) Accepted options: - `query` (string): Case-insensitive substring of the nutrient name, short name or number. Omitted returns all nutrients. Example: `` Response schema example: ```json { "count": 1, "nutrients": [ { "decimals": 3, "id": 1176, "indent_level": 1, "is_label": false, "name": "Biotin", "number": "416", "rank": 6850, "shortest_name": "Biotin", "unit": "µg" } ], "observed_at_ms": 1791014886840, "query": "biotin", "source_url": "https://fdc.nal.usda.gov/portal-data/external/fullNutrientList", "total": 267 } ``` ### Search foods - Capability: `foods/search_foods` - Description: Search FoodData Central foods (POST /portal-data/external/search, the web portal's own backend) by free text across one or more data types (Foundation, SR Legacy, Survey (FNDDS), Branded, Experimental). The text matches descriptions, brand owners, ingredients and GTIN/UPC codes; an empty query lists every food of the selected data types (e.g. all ~400 Foundation foods), sorted by description or published date. 50 results per page; `total_hits` and `counts_by_data_type` report how many foods match in every data type regardless of the filter. Each result carries the FDC id that `get_food` takes, the data-type specific identifier (NDB number, FNDDS food code or GTIN/UPC), brand and category fields where the data type has them (null otherwise) and, when `include_nutrients` is true, the per-100 g nutrient values the portal returns with every result. A page past the last page is `not_found`; a query with no match is a valid empty result. - Instructions: Start here to find FDC ids by name, brand, UPC or to enumerate a data type; then call `get_food` for the full record. - Cost: 5 credits per call - Capability file: [Search foods](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/search_foods) Accepted options: - `data_types` (string[]): Data types to include, as FoodData Central names them. Default: all five. Example: `[]` - `include_nutrients` (boolean): Include each result's per-100 g nutrient values (the portal returns them with every result; a Branded page can be large). Example: `false` - `page` (number): 1-based page of 50 results. Example: `1` - `query` (string): Search text (food description words, a brand owner, an ingredient or a GTIN/UPC). Empty or omitted lists every food of the selected data types. Example: `` - `require_all_words` (boolean): Match only foods containing every word of the query (the portal's default); false matches any word. Example: `false` - `sort_by` (string): Sort column: food description (default) or publication date. Example: `description` - `sort_direction` (string): sort_direction Example: `asc` Response schema example: ```json { "counts_by_data_type": { "Branded": 18773, "Foundation": 1, "SR Legacy": 14, "Survey (FNDDS)": 13 }, "data_types": [ "Foundation" ], "foods": [ { "brand_name": null, "brand_owner": null, "data_type": "Foundation", "description": "Cheese, cheddar", "fdc_id": 328637, "food_category": "Dairy and Egg Products", "food_code": null, "gtin_upc": null, "ingredients": null, "market_country": null, "ndb_number": "1009", "package_weight": null, "published_date": "2019-04-01", "score": 458.08142, "serving_size": null, "serving_size_unit": null, "url": "https://fdc.nal.usda.gov/food-details/328637/nutrients" } ], "observed_at_ms": 1791014871353, "page": 1, "page_size": 50, "query": "cheddar cheese", "source_url": "https://fdc.nal.usda.gov/portal-data/external/search", "total_hits": 1, "total_pages": 1 } ``` ### Search foods by nutrient - Capability: `foods/search_foods_by_nutrient` - Description: Nutrient-centric search (POST /portal-data/external/nutrientList/search, the web portal's 'Nutrient search'): the foods that carry a value for one nutrient, ranked by amount per 100 g, optionally restricted to data types. Takes the nutrient id from `list_nutrients` (e.g. 1176 Biotin, 1096 Chromium, 1102 Molybdenum, 1100 Iodine, 1210 Tryptophan, 1051 Water), not the nutrient number. Returns the nutrient's reference identity and unit, the matching foods with their FDC id, data type, native identifier (NDB number, UPC/GTIN or food code), value and the portal's household measure, plus `counts_by_data_type` (matching foods per data type across all types). This is the tool for coverage questions: which Foundation or SR Legacy foods have biotin at all. An unknown nutrient id is `not_found`; a nutrient no food carries is a valid empty result. 25 results per page by default (1-100). - Instructions: To find which foods have data for a specific nutrient, or the richest sources of it; `get_food` then gives the full record. - Cost: 5 credits per call - Capability file: [Search foods by nutrient](https://firecrawl.dev/alexandria/agents/providers/fdc-nal-usda-gov/foods/search_foods_by_nutrient) Accepted options: - `data_types` (string[]): Restrict to these data types; omitted means all. Example: `[]` - `nutrient_id` (number, required): FoodData Central nutrient id (from `list_nutrients`): 1176 Biotin, 1096 Chromium, 1102 Molybdenum, 1100 Iodine, 1210 Tryptophan, 1003 Protein, 1051 Water. Example: `10` - `page` (number): page Example: `1` - `page_size` (number): page_size Example: `25` - `sort_direction` (string): Order by nutrient value; the portal's default is descending (richest first). Example: `desc` Response schema example: ```json { "counts_by_data_type": { "Branded": 1289, "Foundation": 122 }, "data_types": [ "Foundation" ], "nutrient": { "id": 1176, "name": "Biotin", "number": "416", "unit": "µg" }, "observed_at_ms": 1791014882278, "page": 1, "page_size": 25, "results": [ { "data_type": "Foundation", "description": "Sorghum bran, white, unenriched, dry, raw", "fdc_id": 2710839, "food_weight": 45, "identifier": "100365", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 49, "url": "https://fdc.nal.usda.gov/food-details/2710839/nutrients", "value": 109 }, { "data_type": "Foundation", "description": "Peanut butter, creamy", "fdc_id": 2262072, "food_weight": 100, "identifier": "16098", "identifier_type": "NDB #", "measure": "100 g", "measure_value": 87.8, "url": "https://fdc.nal.usda.gov/food-details/2262072/nutrients", "value": 87.8 }, { "data_type": "Foundation", "description": "Flour, almond", "fdc_id": 2261420, "food_weight": 15, "identifier": "100273", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 10.4, "url": "https://fdc.nal.usda.gov/food-details/2261420/nutrients", "value": 69.1 }, { "data_type": "Foundation", "description": "Almond butter, creamy", "fdc_id": 2262074, "food_weight": 100, "identifier": "12195", "identifier_type": "NDB #", "measure": "100 g", "measure_value": 57.3, "url": "https://fdc.nal.usda.gov/food-details/2262074/nutrients", "value": 57.3 }, { "data_type": "Foundation", "description": "Nuts, almonds, whole, raw", "fdc_id": 2346393, "food_weight": 30, "identifier": "12061", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 17.1, "url": "https://fdc.nal.usda.gov/food-details/2346393/nutrients", "value": 57 }, { "data_type": "Foundation", "description": "Eggs, Grade A, Large, egg yolk", "fdc_id": 748236, "food_weight": 17, "identifier": "1125", "identifier_type": "NDB #", "measure": "1 egg, yolk", "measure_value": 7.8, "url": "https://fdc.nal.usda.gov/food-details/748236/nutrients", "value": 45.9 }, { "data_type": "Foundation", "description": "Flaxseed, ground", "fdc_id": 2262075, "food_weight": 15, "identifier": "12220", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 5.07, "url": "https://fdc.nal.usda.gov/food-details/2262075/nutrients", "value": 33.8 }, { "data_type": "Foundation", "description": "Mushroom, maitake", "fdc_id": 2003602, "food_weight": 85, "identifier": "11993", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 27.7, "url": "https://fdc.nal.usda.gov/food-details/2003602/nutrients", "value": 32.6 }, { "data_type": "Foundation", "description": "Flour, quinoa", "fdc_id": 2512372, "food_weight": 30, "identifier": "100288", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 7.88, "url": "https://fdc.nal.usda.gov/food-details/2512372/nutrients", "value": 26.2 }, { "data_type": "Foundation", "description": "Sorghum, whole grain, white, dry, raw", "fdc_id": 2710842, "food_weight": 45, "identifier": "100368", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 11.7, "url": "https://fdc.nal.usda.gov/food-details/2710842/nutrients", "value": 26.1 }, { "data_type": "Foundation", "description": "Flour, amaranth", "fdc_id": 2512371, "food_weight": 30, "identifier": "100287", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 7.61, "url": "https://fdc.nal.usda.gov/food-details/2512371/nutrients", "value": 25.4 }, { "data_type": "Foundation", "description": "Flour, sorghum", "fdc_id": 2512373, "food_weight": 45, "identifier": "100289", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 10.9, "url": "https://fdc.nal.usda.gov/food-details/2512373/nutrients", "value": 24.2 }, { "data_type": "Foundation", "description": "Nuts, pecans, halves, raw", "fdc_id": 2346395, "food_weight": 30, "identifier": "12142", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 6.8, "url": "https://fdc.nal.usda.gov/food-details/2346395/nutrients", "value": 22.7 }, { "data_type": "Foundation", "description": "Oats, whole grain, steel cut", "fdc_id": 2346397, "food_weight": 40, "identifier": "100282", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 8.8, "url": "https://fdc.nal.usda.gov/food-details/2346397/nutrients", "value": 22 }, { "data_type": "Foundation", "description": "Oats, whole grain, rolled, old fashioned", "fdc_id": 2346396, "food_weight": 40, "identifier": "20038", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 8.76, "url": "https://fdc.nal.usda.gov/food-details/2346396/nutrients", "value": 21.9 }, { "data_type": "Foundation", "description": "Flour, oat, whole grain", "fdc_id": 2261421, "food_weight": 30, "identifier": "100274", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 6.04, "url": "https://fdc.nal.usda.gov/food-details/2261421/nutrients", "value": 20.2 }, { "data_type": "Foundation", "description": "Buckwheat, whole grain", "fdc_id": 2512378, "food_weight": 100, "identifier": "20008", "identifier_type": "NDB #", "measure": "100 g", "measure_value": 18.6, "url": "https://fdc.nal.usda.gov/food-details/2512378/nutrients", "value": 18.6 }, { "data_type": "Foundation", "description": "Nuts, walnuts, English, halves, raw", "fdc_id": 2346394, "food_weight": 30, "identifier": "12155", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 5.18, "url": "https://fdc.nal.usda.gov/food-details/2346394/nutrients", "value": 17.3 }, { "data_type": "Foundation", "description": "Mushroom, lion's mane", "fdc_id": 1999626, "food_weight": 85, "identifier": "100259", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 14.4, "url": "https://fdc.nal.usda.gov/food-details/1999626/nutrients", "value": 16.9 }, { "data_type": "Foundation", "description": "Mushroom, pioppini", "fdc_id": 2003604, "food_weight": 85, "identifier": "100265", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 13, "url": "https://fdc.nal.usda.gov/food-details/2003604/nutrients", "value": 15.3 }, { "data_type": "Foundation", "description": "Flour, buckwheat", "fdc_id": 2512374, "food_weight": 30, "identifier": "20011", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 4.53, "url": "https://fdc.nal.usda.gov/food-details/2512374/nutrients", "value": 15.1 }, { "data_type": "Foundation", "description": "Chia seeds, dry, raw", "fdc_id": 2710819, "food_weight": 45, "identifier": "12006", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 6.53, "url": "https://fdc.nal.usda.gov/food-details/2710819/nutrients", "value": 14.5 }, { "data_type": "Foundation", "description": "Sesame butter, creamy", "fdc_id": 2262073, "food_weight": 100, "identifier": "100271", "identifier_type": "NDB #", "measure": "100 g", "measure_value": 13.3, "url": "https://fdc.nal.usda.gov/food-details/2262073/nutrients", "value": 13.3 }, { "data_type": "Foundation", "description": "Nuts, pine nuts, raw", "fdc_id": 2346392, "food_weight": 30, "identifier": "12147", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 3.87, "url": "https://fdc.nal.usda.gov/food-details/2346392/nutrients", "value": 12.9 }, { "data_type": "Foundation", "description": "Mushroom, crimini", "fdc_id": 2003601, "food_weight": 85, "identifier": "11266", "identifier_type": "NDB #", "measure": "1 RACC", "measure_value": 10.7, "url": "https://fdc.nal.usda.gov/food-details/2003601/nutrients", "value": 12.6 } ], "source_url": "https://fdc.nal.usda.gov/portal-data/external/nutrientList/search", "total_hits": 122, "total_pages": 5 } ```