FoodData Central · Example Payload

Get Foods Batch

Example request and response for batch retrieval of up to 20 foods using POST /v1/foods

HealthPublic APIs

Get Foods Batch is an example object payload from FoodData Central, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

summarydescriptionrequestresponse

Example Payload

{
  "summary": "Retrieve multiple foods by FDC IDs",
  "description": "Example request and response for batch retrieval of up to 20 foods using POST /v1/foods",
  "request": {
    "method": "POST",
    "url": "https://api.nal.usda.gov/fdc/v1/foods?api_key=DEMO_KEY",
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "fdcIds": [534358, 373052, 616350],
      "format": "abridged",
      "nutrients": [203, 204, 205, 208]
    }
  },
  "response": {
    "status": 200,
    "body": [
      {
        "fdcId": 534358,
        "dataType": "Branded",
        "description": "NUT 'N BERRY MIX",
        "publicationDate": "4/1/2019",
        "brandOwner": "Kar Nut Products Company",
        "gtinUpc": "077034085228",
        "foodNutrients": [
          { "number": 203, "name": "Protein", "amount": 14.29, "unitName": "g" },
          { "number": 204, "name": "Total lipid (fat)", "amount": 32.14, "unitName": "g" },
          { "number": 205, "name": "Carbohydrate, by difference", "amount": 42.86, "unitName": "g" },
          { "number": 208, "name": "Energy", "amount": 500, "unitName": "kcal" }
        ]
      },
      {
        "fdcId": 373052,
        "dataType": "Branded",
        "description": "APPLE JUICE",
        "publicationDate": "4/1/2019",
        "foodNutrients": [
          { "number": 203, "name": "Protein", "amount": 0.1, "unitName": "g" },
          { "number": 204, "name": "Total lipid (fat)", "amount": 0.1, "unitName": "g" },
          { "number": 205, "name": "Carbohydrate, by difference", "amount": 11.3, "unitName": "g" },
          { "number": 208, "name": "Energy", "amount": 46, "unitName": "kcal" }
        ]
      },
      {
        "fdcId": 616350,
        "dataType": "Branded",
        "description": "WHOLE GRAIN BREAD",
        "publicationDate": "4/1/2019",
        "foodNutrients": [
          { "number": 203, "name": "Protein", "amount": 7.14, "unitName": "g" },
          { "number": 204, "name": "Total lipid (fat)", "amount": 3.57, "unitName": "g" },
          { "number": 205, "name": "Carbohydrate, by difference", "amount": 46.43, "unitName": "g" },
          { "number": 208, "name": "Energy", "amount": 250, "unitName": "kcal" }
        ]
      }
    ]
  }
}

Work with this as data

Every example here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This example

curl "https://apis.io/api/v1/examples/get-foods-batch"

All examples

curl "https://apis.io/api/v1/examples?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.