USDA FoodData Central · 食品营养资料API

USDA FoodData Central官方REST API可按关键词搜索食品或按FDC ID取详情，需data.gov API key，数据按CC0公开。普通与DEMO key限额不同，超额可429。仅文档整理，未查询；完整响应结构、数据版本与运行可用性未验证。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-a3e445b08d876f8a44901dcd
Card version: 2
Updated: 2026-10-24T18:19:26.4628649+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

The USDA FoodData Central API provides assistance to application developers wishing to incorporate nutrient data into their applications or websites.

Inputs

/foods/search接query关键词，可选dataType数组、sortBy/sortOrder等，按具体schema使用。
/food/{fdcId}为GET单详情；/foods为GET/POST多ID；/foods/list为GET/POST分页列表。
示例pageSize与分类过滤存在，完整参数上限需OpenAPI细表，本页未展开。

Outputs

按关键词匹配的食品列表、单个或多食品详情及分页abridged列表，具体营养字段需对应data type文档。
当前指南没有完整响应样例/schema，不能推断每种食品都有同一组完整营养值。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u6BCF\u4E2A\u8BF7\u6C42api_key\u53C2\u6570\u4F20data.gov API key\uFF1BDEMO_KEY\u4EC5\u521D\u6B65\u63A2\u7D22\u4E14\u9650\u989D\u5F88\u4F4E\uFF0C\u4E0D\u662F\u533F\u540D\u65E0\u9650\u670D\u52A1\u3002\u672C\u8F6E\u672A\u6CE8\u518C\u6216\u4F7F\u7528\u4EFB\u4F55key\u3002"
  },
  "command": null,
  "entry_url": "https://api.nal.usda.gov/fdc/v1/foods/search",
  "kind": "http_api",
  "method": null,
  "request_example": null,
  "requirements": [
    "data.gov API key\u53CAHTTP\u5BA2\u6237\u7AEF\uFF1B\u6839\u636E\u6570\u636E\u7C7B\u578B\u6587\u6863\u89E3\u91CA\u8425\u517B\u5B57\u6BB5\u3001\u5355\u4F4D\u548C\u98DF\u54C1\u7C7B\u522B\u3002",
    "GET/POST\u6309\u7AEF\u70B9\u652F\u6301\u533A\u5206\uFF0CPOST\u4F7F\u7528application/json\uFF1B\u672C\u9875\u5305\u542B\u516C\u5F00\u793A\u4F8B\u4F46\u4E0D\u6267\u884C\u3002",
    "\u4E0D\u8981\u628A\u98DF\u54C1\u8425\u517B\u6570\u636E\u67E5\u8BE2\u7B49\u540C\u4E2A\u4F53\u8BCA\u7597\u6216\u996E\u98DF\u65B9\u6848\u9A8C\u8BC1\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "FDC\u6570\u636E\u660E\u786Epublic domain/CC0 1.0\uFF0C\u65E0\u9700\u8BB8\u53EF\u5E76\u5EFA\u8BAE\u6CE8\u660EUSDA FoodData Central\u6765\u6E90\uFF1B\u5F53\u524D\u9875\u6CA1\u6709API\u6536\u8D39\u4EF7\u683C\uFF0C\u4ECD\u9700key\u53CA\u914D\u989D\uFF0C\u4E0D\u80FD\u628A\u5F00\u653E\u6570\u636E\u8BB8\u53EF\u5F53\u65E0\u9650\u670D\u52A1\u627F\u8BFA\u3002",
  "source_url": "https://fdc.nal.usda.gov/api-guide/"
}

{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8BF7\u6C42\u4F1A\u53D1\u9001\u98DF\u54C1\u67E5\u8BE2\u8BCD\u3001ID\u548Ckey\uFF0C\u65E5\u5FD7/\u7559\u5B58\u672A\u77E5\u3002CC0\u9002\u7528\u4E8E\u6240\u8FF0FDC\u6570\u636E\uFF0C\u4E0D\u80FD\u81EA\u52A8\u63A8\u5E7F\u4E3A\u7B2C\u4E09\u65B9\u4EE3\u7801\u6216\u7528\u6237\u63D0\u4EA4\u6570\u636E\u8BB8\u53EF\u3002\u672C\u8F6E\u672A\u4E0A\u4F20\u996E\u98DF\u3001\u60A3\u8005\u6216\u4E2A\u4EBA\u8D44\u6599\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

默认1000请求/小时/IP，超额可使key暂封1小时并429；需读X-RateLimit-Limit/Remaining。
DEMO_KEY仅30请求/小时和50请求/天/IP，不混同普通key额度。
旧USDA Food Composition API已停更，当前应使用FDC路径；文档引用年份不是现场release验证。
数据公开许可不保证每项最新、完整或适合特定健康用途。

Unknowns

实际响应schema、当前数据release、查询结果和认证未验证。
API计费、提高额度条件、服务SLA与日志留存未知。
未调用食品API、分析用户饮食或运行医学能力测试。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T18:18:38.2206891\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://fdc.nal.usda.gov/api-guide/"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u5B9E\u9645\u8BF7\u6C42\u4F1A\u53D1\u9001\u98DF\u54C1\u67E5\u8BE2\u8BCD\u3001ID\u548Ckey\uFF0C\u65E5\u5FD7/\u7559\u5B58\u672A\u77E5\u3002CC0\u9002\u7528\u4E8E\u6240\u8FF0FDC\u6570\u636E\uFF0C\u4E0D\u80FD\u81EA\u52A8\u63A8\u5E7F\u4E3A\u7B2C\u4E09\u65B9\u4EE3\u7801\u6216\u7528\u6237\u63D0\u4EA4\u6570\u636E\u8BB8\u53EF\u3002\u672C\u8F6E\u672A\u4E0A\u4F20\u996E\u98DF\u3001\u60A3\u8005\u6216\u4E2A\u4EBA\u8D44\u6599\u3002"
  },
  "description": "The USDA FoodData Central API provides assistance to application developers wishing to incorporate nutrient data into their applications or websites.",
  "inputs": [
    "/foods/search\u63A5query\u5173\u952E\u8BCD\uFF0C\u53EF\u9009dataType\u6570\u7EC4\u3001sortBy/sortOrder\u7B49\uFF0C\u6309\u5177\u4F53schema\u4F7F\u7528\u3002",
    "/food/{fdcId}\u4E3AGET\u5355\u8BE6\u60C5\uFF1B/foods\u4E3AGET/POST\u591AID\uFF1B/foods/list\u4E3AGET/POST\u5206\u9875\u5217\u8868\u3002",
    "\u793A\u4F8BpageSize\u4E0E\u5206\u7C7B\u8FC7\u6EE4\u5B58\u5728\uFF0C\u5B8C\u6574\u53C2\u6570\u4E0A\u9650\u9700OpenAPI\u7EC6\u8868\uFF0C\u672C\u9875\u672A\u5C55\u5F00\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u6BCF\u4E2A\u8BF7\u6C42api_key\u53C2\u6570\u4F20data.gov API key\uFF1BDEMO_KEY\u4EC5\u521D\u6B65\u63A2\u7D22\u4E14\u9650\u989D\u5F88\u4F4E\uFF0C\u4E0D\u662F\u533F\u540D\u65E0\u9650\u670D\u52A1\u3002\u672C\u8F6E\u672A\u6CE8\u518C\u6216\u4F7F\u7528\u4EFB\u4F55key\u3002"
    },
    "command": null,
    "entry_url": "https://api.nal.usda.gov/fdc/v1/foods/search",
    "kind": "http_api",
    "method": null,
    "request_example": null,
    "requirements": [
      "data.gov API key\u53CAHTTP\u5BA2\u6237\u7AEF\uFF1B\u6839\u636E\u6570\u636E\u7C7B\u578B\u6587\u6863\u89E3\u91CA\u8425\u517B\u5B57\u6BB5\u3001\u5355\u4F4D\u548C\u98DF\u54C1\u7C7B\u522B\u3002",
      "GET/POST\u6309\u7AEF\u70B9\u652F\u6301\u533A\u5206\uFF0CPOST\u4F7F\u7528application/json\uFF1B\u672C\u9875\u5305\u542B\u516C\u5F00\u793A\u4F8B\u4F46\u4E0D\u6267\u884C\u3002",
      "\u4E0D\u8981\u628A\u98DF\u54C1\u8425\u517B\u6570\u636E\u67E5\u8BE2\u7B49\u540C\u4E2A\u4F53\u8BCA\u7597\u6216\u996E\u98DF\u65B9\u6848\u9A8C\u8BC1\u3002"
    ]
  },
  "limitations": [
    "\u9ED8\u8BA41000\u8BF7\u6C42/\u5C0F\u65F6/IP\uFF0C\u8D85\u989D\u53EF\u4F7Fkey\u6682\u5C011\u5C0F\u65F6\u5E76429\uFF1B\u9700\u8BFBX-RateLimit-Limit/Remaining\u3002",
    "DEMO_KEY\u4EC530\u8BF7\u6C42/\u5C0F\u65F6\u548C50\u8BF7\u6C42/\u5929/IP\uFF0C\u4E0D\u6DF7\u540C\u666E\u901Akey\u989D\u5EA6\u3002",
    "\u65E7USDA Food Composition API\u5DF2\u505C\u66F4\uFF0C\u5F53\u524D\u5E94\u4F7F\u7528FDC\u8DEF\u5F84\uFF1B\u6587\u6863\u5F15\u7528\u5E74\u4EFD\u4E0D\u662F\u73B0\u573Arelease\u9A8C\u8BC1\u3002",
    "\u6570\u636E\u516C\u5F00\u8BB8\u53EF\u4E0D\u4FDD\u8BC1\u6BCF\u9879\u6700\u65B0\u3001\u5B8C\u6574\u6216\u9002\u5408\u7279\u5B9A\u5065\u5EB7\u7528\u9014\u3002"
  ],
  "outputs": [
    "\u6309\u5173\u952E\u8BCD\u5339\u914D\u7684\u98DF\u54C1\u5217\u8868\u3001\u5355\u4E2A\u6216\u591A\u98DF\u54C1\u8BE6\u60C5\u53CA\u5206\u9875abridged\u5217\u8868\uFF0C\u5177\u4F53\u8425\u517B\u5B57\u6BB5\u9700\u5BF9\u5E94data type\u6587\u6863\u3002",
    "\u5F53\u524D\u6307\u5357\u6CA1\u6709\u5B8C\u6574\u54CD\u5E94\u6837\u4F8B/schema\uFF0C\u4E0D\u80FD\u63A8\u65AD\u6BCF\u79CD\u98DF\u54C1\u90FD\u6709\u540C\u4E00\u7EC4\u5B8C\u6574\u8425\u517B\u503C\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "FDC\u6570\u636E\u660E\u786Epublic domain/CC0 1.0\uFF0C\u65E0\u9700\u8BB8\u53EF\u5E76\u5EFA\u8BAE\u6CE8\u660EUSDA FoodData Central\u6765\u6E90\uFF1B\u5F53\u524D\u9875\u6CA1\u6709API\u6536\u8D39\u4EF7\u683C\uFF0C\u4ECD\u9700key\u53CA\u914D\u989D\uFF0C\u4E0D\u80FD\u628A\u5F00\u653E\u6570\u636E\u8BB8\u53EF\u5F53\u65E0\u9650\u670D\u52A1\u627F\u8BFA\u3002",
    "source_url": "https://fdc.nal.usda.gov/api-guide/"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T18:18:38.2206891\u002B00:00",
      "title": "API Guide | USDA FoodData Central",
      "url": "https://fdc.nal.usda.gov/api-guide/"
    }
  ],
  "summary": "USDA FoodData Central\u5B98\u65B9REST API\u53EF\u6309\u5173\u952E\u8BCD\u641C\u7D22\u98DF\u54C1\u6216\u6309FDC ID\u53D6\u8BE6\u60C5\uFF0C\u9700data.gov API key\uFF0C\u6570\u636E\u6309CC0\u516C\u5F00\u3002\u666E\u901A\u4E0EDEMO key\u9650\u989D\u4E0D\u540C\uFF0C\u8D85\u989D\u53EF429\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u67E5\u8BE2\uFF1B\u5B8C\u6574\u54CD\u5E94\u7ED3\u6784\u3001\u6570\u636E\u7248\u672C\u4E0E\u8FD0\u884C\u53EF\u7528\u6027\u672A\u9A8C\u8BC1\u3002",
  "tags": [
    "USDA",
    "FoodData Central",
    "\u98DF\u54C1\u8425\u517B",
    "REST API",
    "data.gov API key",
    "CC0",
    "\u516C\u5F00\u6570\u636E"
  ],
  "terms_url": null,
  "title": "USDA FoodData Central \u00B7 \u98DF\u54C1\u8425\u517B\u8D44\u6599API",
  "unknowns": [
    "\u5B9E\u9645\u54CD\u5E94schema\u3001\u5F53\u524D\u6570\u636Erelease\u3001\u67E5\u8BE2\u7ED3\u679C\u548C\u8BA4\u8BC1\u672A\u9A8C\u8BC1\u3002",
    "API\u8BA1\u8D39\u3001\u63D0\u9AD8\u989D\u5EA6\u6761\u4EF6\u3001\u670D\u52A1SLA\u4E0E\u65E5\u5FD7\u7559\u5B58\u672A\u77E5\u3002",
    "\u672A\u8C03\u7528\u98DF\u54C1API\u3001\u5206\u6790\u7528\u6237\u996E\u98DF\u6216\u8FD0\u884C\u533B\u5B66\u80FD\u529B\u6D4B\u8BD5\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T18:18:38.2206891\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://fdc.nal.usda.gov/api-guide/"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-a3e445b08d876f8a44901dcd",
  "version": 2,
  "source_url": "https://fdc.nal.usda.gov/api-guide/",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://fdc.nal.usda.gov/api-guide/",
    "final_url": "https://fdc.nal.usda.gov/api-guide/",
    "status_code": 200,
    "title": "API Guide | USDA FoodData Central",
    "description": "The USDA FoodData Central API provides assistance to application developers wishing to incorporate nutrient data into their applications or websites.",
    "checked_at": "2026-10-24T18:18:38.2206891\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T18:18:41.2684465\u002B00:00",
  "updated_at": "2026-10-24T18:19:26.4628649\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-a3e445b08d876f8a44901dcd?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-a3e445b08d876f8a44901dcd?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u98DF\u54C1\u8425\u517B\u516C\u5F00\u6570\u636E\uFF5C\u9700data.gov\u5BC6\u94A5\u7684\u641C\u7D22\u4E0E\u8BE6\u60C5API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-356cfcde5598eda140fd99cae6e34296",
        "source_url": "https://fdc.nal.usda.gov/api-guide/",
        "content_sha256": "938aa9d6a04fa6071a1e82bef110fc51d7730a094d7d26bfbbb9f6c62040322b",
        "decoded_bytes": 125098,
        "content_type": "text/html",
        "captured_at": "2026-10-24T18:18:38.2206891\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "938aa9d6a04fa6071a1e82bef110fc51d7730a094d7d26bfbbb9f6c62040322b",
        "text_utf8_bytes": 125098,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-a3e445b08d876f8a44901dcd/materials/material-356cfcde5598eda140fd99cae6e34296?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-3da78924b87a48818c0905f68fa5f7b3",
    "reason": "\u636E\u672C\u6279USDA FDC\u5B98\u65B9API\u6307\u5357\u6574\u7406\u641C\u7D22/\u8BE6\u60C5\u3001key/DEMO\u9650\u989D\u53CACC0\uFF1B\u4E0D\u67E5\u8BE2\u996E\u98DF\u8BB0\u5F55\u6216\u8C03\u7528\u793A\u4F8B\u3002",
    "source_urls": [
      "https://fdc.nal.usda.gov/api-guide/"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-a3e445b08d876f8a44901dcd",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-a3e445b08d876f8a44901dcd?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-a3e445b08d876f8a44901dcd?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure