Pricing

from $13.40 / 1,000 fndds nutrient records

Try for free

Go to Apify Store

USDA FNDDS Ingredient-Nutrient Matrix

Try for free

One fndds_nutrient_record per row of USDA FoodData Central's fndds_ingredient_nutrient_value table — a single nutrient value for an FNDDS ingredient in a given survey cycle — carried source-native and verbatim.

Pricing

from $13.40 / 1,000 fndds nutrient records

Rating

0.0

(0)

Developer

NexGen Watch

Actor stats

Bookmarked

Total users

Monthly active users

13 hours ago

Last modified

Categories

Automation

Developer tools

Lead generation

You can access the USDA FNDDS Ingredient-Nutrient Matrix programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "lP2LLvnaVLEwqMyky"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nexgenwatch~usda-fndds-ingredient-nutrient-matrix/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nexgenwatch-usda-fndds-ingredient-nutrient-matrix",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/nexgenwatch~usda-fndds-ingredient-nutrient-matrix/runs": {
      "post": {
        "operationId": "runs-sync-nexgenwatch-usda-fndds-ingredient-nutrient-matrix",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/nexgenwatch~usda-fndds-ingredient-nutrient-matrix/run-sync": {
      "post": {
        "operationId": "run-sync-nexgenwatch-usda-fndds-ingredient-nutrient-matrix",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "ingredientCodes": {
            "title": "Ingredient codes (filter)",
            "type": "array",
            "description": "FNDDS ingredient codes, e.g. [\"1001\"]. At least one of ingredientCodes / nutrientCodes / fdcIds is REQUIRED — the member is never emitted in full.",
            "default": []
          },
          "nutrientCodes": {
            "title": "Nutrient codes (filter)",
            "type": "array",
            "description": "Nutrient codes, e.g. [\"203\"] (Protein).",
            "default": []
          },
          "fdcIds": {
            "title": "FDC IDs (filter)",
            "type": "array",
            "description": "Ingredient FoodData Central fdc_id linkage values.",
            "default": []
          },
          "maxRecords": {
            "title": "maxRecords",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "Max FNDDS nutrient records delivered (buyer bound; one charge per delivered record). Hard-capped at 5000.",
            "default": 2500
          },
          "maxScanRows": {
            "title": "maxScanRows",
            "minimum": 1000,
            "maximum": 3000000,
            "type": "integer",
            "description": "Hard scan bound over the streamed member — a finite run. Default 300000; PARTIAL if the cap is not reached within it.",
            "default": 300000
          },
          "releaseUrl": {
            "title": "Release URL (override)",
            "type": "string",
            "description": "Pin a specific FoodData_Central_csv_<date>.zip URL. Default: newest release auto-resolved."
          },
          "userAgent": {
            "title": "userAgent",
            "type": "string",
            "description": "Override the transparent crawler UA."
          },
          "searchText": {
            "title": "Search text (keep rows containing…)",
            "type": "string",
            "description": "Optional. Keep only rows where any field contains this text (case-insensitive, substring). Applied after the source is read and BEFORE the maxRecords cap, so the cap counts matches and only delivered matches are billed. Zero matches = EMPTY_SELECTION, nothing charged beyond the start fee."
          },
          "fieldMatch": {
            "title": "Field match (column → text)",
            "type": "object",
            "description": "Optional. {\"column\": \"text\"} keeps rows whose named output column contains the text (case-insensitive); a list of texts means any of them; several columns must all match. Column names are the dataset fields shown in the sample output. Applied BEFORE the maxRecords cap and before billing."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

USDA FNDDS Ingredient-Nutrient Matrix OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for USDA FNDDS Ingredient-Nutrient Matrix from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

USDA FNDDS Ingredient-Nutrient Matrix API in Python

USDA FNDDS Ingredient-Nutrient Matrix API in JavaScript

USDA FNDDS Ingredient-Nutrient Matrix API through CLI

USDA FNDDS Ingredient-Nutrient Matrix API

Cosing Ingredient Checker — No Login, $3.5/1k

fortuitous_pirate/cosing-ingredient-checker

EU CosIng Cosmetic Ingredient Safety Checker. No login or cookies. MCP-ready for AI agents. $3.5 per 1,000 records.

Fortuitous Pirate

INCI Beauty Safety Score & Ingredients Scraper

extractify-labs/incibeauty-inci-ingredients

Scrape INCI Beauty by barcode: the 0-20 safety score, full risk-rated INCI composition and ingredient reference dictionary. Score INCI, pay per result.

Extractify Labs

USDA Food Nutrition Scraper — Calories, Protein & Macros

copious_atoll/usda-food-nutrition

Extract USDA FoodData Central nutritional data. Search 300K+ foods for calories, protein, fat, carbs, vitamins, minerals. Branded and generic foods. Free USDA API, no proxy needed.

Grim R

UK Licensed Sponsor Register (Workers)

nexgenwatch/uk-licensed-sponsor-register

Each record carries the organisation, town/city, county, licence type & rating, and immigration route from the newest official CSV, with the register's release date stamped on every row.

NexGen Watch

Africa Startup Funding Rounds Scraper

nexgenwatch/africa-startup-funding-tracker

Scrape African startup funding rounds from TechCabal's public funding feed: company, amount, stage, investors and date. One record per result. Pay per result.

NexGen Watch

BambooHR Jobs Scraper - Any Employer Board

nexgenwatch/bamboohr-job-feed

Scrape job postings from any BambooHR careers board: title, location, department, posting date and apply link. One record per result. Pay per result.

NexGen Watch

USDA FoodData Scraper - Nutrition and Branded Foods

benthepythondev/usda-fooddata-scraper

Search USDA FoodData Central and export food IDs, descriptions, brands, ingredients, categories and nutrient data.

Ben

EIA-Renewable / Storage Asset Detail

nexgenwatch/eia-renewable-storage-asset-detail

One renewable_storage_record per generator row of EIA-860's wind, solar and energy-storage worksheets — the technology-specific fields of each worksheet carried verbatim.

NexGen Watch

USDA FDC Nutrient Observation Matrix

nexgenwatch/usda-fdc-nutrient-observation-matrix

One nutrient_observation per row of USDA FoodData Central's food_nutrient table — the analytical observation as USDA records it: amount, data_points, statistical min / max / median / loq, footnote, min_year_acquired, percent_daily_value.

NexGen Watch

CMS Coverage Related-Document Graph

nexgenwatch/cms-coverage-related-document-graph

One structured edge per filed related-document link between coverage policies in the official CMS Medicare Coverage Database — the source policy (LCD/Article) and its typed related endpoints (a related Article, a related LCD.

NexGen Watch