GDELT DOC 2.0 · 新闻检索与覆盖统计

2017 年官方发布说明介绍 DOC 2.0 的新闻/图像检索、文章列表与时间线等输出，提供 HTTPS 查询示例。仅整理历史技术文档，未调用或确认当前时间窗口。

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-1a712c71e13be8cb30219a63
Card version: 2
Updated: 2026-10-24T17:56:13.8048479+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

示例入口为 https://api.gdeltproject.org/api/v2/doc/doc，以 query、mode、format 及时间参数指定查询。ArticleList 可给匹配文章 URL/标题，JSON/CSV 等字段依 mode 不同；全文检索一词不意味着响应包含可再发布的新闻全文。公告当时描述滚动三个月覆盖和若干跨语言/图像功能，当前窗口、语言与运营政策未独立确认。MAXRECORDS 只适用部分列表/拼图模式，历史说明默认 75、最多 250，不能当所有模式统一限额。

Inputs

query 中的关键词、短语及该模式支持的运算符
mode 与适用 format
TIMESPAN 或 STARTDATETIME/ENDDATETIME 等时间条件
部分列表模式可用的 MAXRECORDS

Outputs

按 mode 提供的文章 URL/标题列表
适用模式下的 JSON、CSV、RSS 或可视化数据
时间线、语调或图像相关结果需按各自模式解释

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "unknown",
    "notes": "\u5386\u53F2\u516C\u544A\u63D0\u4F9B\u672A\u5E26 key \u7684\u516C\u5171\u67E5\u8BE2 URL\uFF0C\u4F46\u672C\u6B21\u672A\u786E\u8BA4\u5F53\u524D\u5B8C\u6574\u8BA4\u8BC1\u548C\u8BBF\u95EE\u653F\u7B56\uFF0C\u4E0D\u4FDD\u8BC1\u65E0\u9650\u533F\u540D\u8C03\u7528\u3002"
  },
  "command": null,
  "entry_url": "https://api.gdeltproject.org/api/v2/doc/doc",
  "kind": "http_api",
  "method": "GET",
  "requirements": [
    "\u6838\u5BF9\u5F53\u524D\u5B98\u65B9 API \u8FD0\u8425\u653F\u7B56\u3001\u7A97\u53E3\u4E0E\u53C2\u6570\u652F\u6301",
    "\u6309\u5177\u4F53 mode \u89E3\u91CA\u7ED3\u679C\u548C\u5206\u9875/\u8BB0\u5F55\u9650\u5236",
    "\u5BF9\u5173\u952E\u65B0\u95FB\u4E8B\u5B9E\u56DE\u5230\u539F\u59CB\u6765\u6E90\u6838\u5BF9\u5E76\u9075\u5B88\u5185\u5BB9\u8BB8\u53EF"
  ]
}

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": "\u672C\u6B21\u5386\u53F2\u53D1\u5E03\u8BF4\u660E\u672A\u786E\u8BA4\u5F53\u524D\u8D39\u7528\u3001\u6570\u5B57\u901F\u7387\u9650\u5236\u6216\u5546\u4E1A\u4F7F\u7528\u6761\u6B3E\uFF0C\u4E0D\u80FD\u7531\u516C\u5F00\u793A\u4F8B\u63A8\u5B9A\u65E0\u9650\u514D\u8D39\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u67E5\u8BE2\u8BCD\u4E0E\u7B5B\u9009\u6761\u4EF6\u53D1\u9001\u81F3 GDELT\uFF1B\u7ED3\u679C\u53EF\u80FD\u94FE\u63A5\u7B2C\u4E09\u65B9\u65B0\u95FB\u548C\u56FE\u50CF\u3002\u67E5\u8BE2\u65E5\u5FD7\u3001\u539F\u6587\u53CA\u56FE\u7247\u8BB8\u53EF\u9700\u5206\u522B\u6838\u5BF9\u3002"
}

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

Limitations

未调用 GDELT API、抓取新闻全文、下载图片或验证检索。
来源是 2017 年 DOC 2.0 发布说明，不是当前实际服务范围的现场证明。
时间线百分比与原始计数是不同模式，不能混用成同一指标。
检索和机器翻译覆盖不等于新闻事实真实性、全网覆盖或完整语言理解。
新闻与图像的原始版权不因可检索而自动转为免费再发布。

Unknowns

当前认证、收费、速率和历史查询窗口仍待确认。
实际检索覆盖、输出 schema、服务可用性和语调模型质量未测试。
各新闻及图片来源的再使用许可不由该 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-24T17:55:08.8505819\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/"
  ],
  "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": "\u67E5\u8BE2\u8BCD\u4E0E\u7B5B\u9009\u6761\u4EF6\u53D1\u9001\u81F3 GDELT\uFF1B\u7ED3\u679C\u53EF\u80FD\u94FE\u63A5\u7B2C\u4E09\u65B9\u65B0\u95FB\u548C\u56FE\u50CF\u3002\u67E5\u8BE2\u65E5\u5FD7\u3001\u539F\u6587\u53CA\u56FE\u7247\u8BB8\u53EF\u9700\u5206\u522B\u6838\u5BF9\u3002"
  },
  "description": "\u793A\u4F8B\u5165\u53E3\u4E3A https://api.gdeltproject.org/api/v2/doc/doc\uFF0C\u4EE5 query\u3001mode\u3001format \u53CA\u65F6\u95F4\u53C2\u6570\u6307\u5B9A\u67E5\u8BE2\u3002ArticleList \u53EF\u7ED9\u5339\u914D\u6587\u7AE0 URL/\u6807\u9898\uFF0CJSON/CSV \u7B49\u5B57\u6BB5\u4F9D mode \u4E0D\u540C\uFF1B\u5168\u6587\u68C0\u7D22\u4E00\u8BCD\u4E0D\u610F\u5473\u7740\u54CD\u5E94\u5305\u542B\u53EF\u518D\u53D1\u5E03\u7684\u65B0\u95FB\u5168\u6587\u3002\u516C\u544A\u5F53\u65F6\u63CF\u8FF0\u6EDA\u52A8\u4E09\u4E2A\u6708\u8986\u76D6\u548C\u82E5\u5E72\u8DE8\u8BED\u8A00/\u56FE\u50CF\u529F\u80FD\uFF0C\u5F53\u524D\u7A97\u53E3\u3001\u8BED\u8A00\u4E0E\u8FD0\u8425\u653F\u7B56\u672A\u72EC\u7ACB\u786E\u8BA4\u3002MAXRECORDS \u53EA\u9002\u7528\u90E8\u5206\u5217\u8868/\u62FC\u56FE\u6A21\u5F0F\uFF0C\u5386\u53F2\u8BF4\u660E\u9ED8\u8BA4 75\u3001\u6700\u591A 250\uFF0C\u4E0D\u80FD\u5F53\u6240\u6709\u6A21\u5F0F\u7EDF\u4E00\u9650\u989D\u3002",
  "inputs": [
    "query \u4E2D\u7684\u5173\u952E\u8BCD\u3001\u77ED\u8BED\u53CA\u8BE5\u6A21\u5F0F\u652F\u6301\u7684\u8FD0\u7B97\u7B26",
    "mode \u4E0E\u9002\u7528 format",
    "TIMESPAN \u6216 STARTDATETIME/ENDDATETIME \u7B49\u65F6\u95F4\u6761\u4EF6",
    "\u90E8\u5206\u5217\u8868\u6A21\u5F0F\u53EF\u7528\u7684 MAXRECORDS"
  ],
  "invocation": {
    "authentication": {
      "kind": "unknown",
      "notes": "\u5386\u53F2\u516C\u544A\u63D0\u4F9B\u672A\u5E26 key \u7684\u516C\u5171\u67E5\u8BE2 URL\uFF0C\u4F46\u672C\u6B21\u672A\u786E\u8BA4\u5F53\u524D\u5B8C\u6574\u8BA4\u8BC1\u548C\u8BBF\u95EE\u653F\u7B56\uFF0C\u4E0D\u4FDD\u8BC1\u65E0\u9650\u533F\u540D\u8C03\u7528\u3002"
    },
    "command": null,
    "entry_url": "https://api.gdeltproject.org/api/v2/doc/doc",
    "kind": "http_api",
    "method": "GET",
    "requirements": [
      "\u6838\u5BF9\u5F53\u524D\u5B98\u65B9 API \u8FD0\u8425\u653F\u7B56\u3001\u7A97\u53E3\u4E0E\u53C2\u6570\u652F\u6301",
      "\u6309\u5177\u4F53 mode \u89E3\u91CA\u7ED3\u679C\u548C\u5206\u9875/\u8BB0\u5F55\u9650\u5236",
      "\u5BF9\u5173\u952E\u65B0\u95FB\u4E8B\u5B9E\u56DE\u5230\u539F\u59CB\u6765\u6E90\u6838\u5BF9\u5E76\u9075\u5B88\u5185\u5BB9\u8BB8\u53EF"
    ]
  },
  "limitations": [
    "\u672A\u8C03\u7528 GDELT API\u3001\u6293\u53D6\u65B0\u95FB\u5168\u6587\u3001\u4E0B\u8F7D\u56FE\u7247\u6216\u9A8C\u8BC1\u68C0\u7D22\u3002",
    "\u6765\u6E90\u662F 2017 \u5E74 DOC 2.0 \u53D1\u5E03\u8BF4\u660E\uFF0C\u4E0D\u662F\u5F53\u524D\u5B9E\u9645\u670D\u52A1\u8303\u56F4\u7684\u73B0\u573A\u8BC1\u660E\u3002",
    "\u65F6\u95F4\u7EBF\u767E\u5206\u6BD4\u4E0E\u539F\u59CB\u8BA1\u6570\u662F\u4E0D\u540C\u6A21\u5F0F\uFF0C\u4E0D\u80FD\u6DF7\u7528\u6210\u540C\u4E00\u6307\u6807\u3002",
    "\u68C0\u7D22\u548C\u673A\u5668\u7FFB\u8BD1\u8986\u76D6\u4E0D\u7B49\u4E8E\u65B0\u95FB\u4E8B\u5B9E\u771F\u5B9E\u6027\u3001\u5168\u7F51\u8986\u76D6\u6216\u5B8C\u6574\u8BED\u8A00\u7406\u89E3\u3002",
    "\u65B0\u95FB\u4E0E\u56FE\u50CF\u7684\u539F\u59CB\u7248\u6743\u4E0D\u56E0\u53EF\u68C0\u7D22\u800C\u81EA\u52A8\u8F6C\u4E3A\u514D\u8D39\u518D\u53D1\u5E03\u3002"
  ],
  "outputs": [
    "\u6309 mode \u63D0\u4F9B\u7684\u6587\u7AE0 URL/\u6807\u9898\u5217\u8868",
    "\u9002\u7528\u6A21\u5F0F\u4E0B\u7684 JSON\u3001CSV\u3001RSS \u6216\u53EF\u89C6\u5316\u6570\u636E",
    "\u65F6\u95F4\u7EBF\u3001\u8BED\u8C03\u6216\u56FE\u50CF\u76F8\u5173\u7ED3\u679C\u9700\u6309\u5404\u81EA\u6A21\u5F0F\u89E3\u91CA"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u6B21\u5386\u53F2\u53D1\u5E03\u8BF4\u660E\u672A\u786E\u8BA4\u5F53\u524D\u8D39\u7528\u3001\u6570\u5B57\u901F\u7387\u9650\u5236\u6216\u5546\u4E1A\u4F7F\u7528\u6761\u6B3E\uFF0C\u4E0D\u80FD\u7531\u516C\u5F00\u793A\u4F8B\u63A8\u5B9A\u65E0\u9650\u514D\u8D39\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:55:08.8505819\u002B00:00",
      "title": "GDELT DOC 2.0 API Debuts! \u2013 The GDELT Project",
      "url": "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/"
    }
  ],
  "summary": "2017 \u5E74\u5B98\u65B9\u53D1\u5E03\u8BF4\u660E\u4ECB\u7ECD DOC 2.0 \u7684\u65B0\u95FB/\u56FE\u50CF\u68C0\u7D22\u3001\u6587\u7AE0\u5217\u8868\u4E0E\u65F6\u95F4\u7EBF\u7B49\u8F93\u51FA\uFF0C\u63D0\u4F9B HTTPS \u67E5\u8BE2\u793A\u4F8B\u3002\u4EC5\u6574\u7406\u5386\u53F2\u6280\u672F\u6587\u6863\uFF0C\u672A\u8C03\u7528\u6216\u786E\u8BA4\u5F53\u524D\u65F6\u95F4\u7A97\u53E3\u3002",
  "tags": [
    "GDELT",
    "\u65B0\u95FB\u68C0\u7D22",
    "DOC 2.0",
    "HTTP API",
    "\u6587\u6863\u5386\u53F2"
  ],
  "terms_url": null,
  "title": "GDELT DOC 2.0 \u00B7 \u65B0\u95FB\u68C0\u7D22\u4E0E\u8986\u76D6\u7EDF\u8BA1",
  "unknowns": [
    "\u5F53\u524D\u8BA4\u8BC1\u3001\u6536\u8D39\u3001\u901F\u7387\u548C\u5386\u53F2\u67E5\u8BE2\u7A97\u53E3\u4ECD\u5F85\u786E\u8BA4\u3002",
    "\u5B9E\u9645\u68C0\u7D22\u8986\u76D6\u3001\u8F93\u51FA schema\u3001\u670D\u52A1\u53EF\u7528\u6027\u548C\u8BED\u8C03\u6A21\u578B\u8D28\u91CF\u672A\u6D4B\u8BD5\u3002",
    "\u5404\u65B0\u95FB\u53CA\u56FE\u7247\u6765\u6E90\u7684\u518D\u4F7F\u7528\u8BB8\u53EF\u4E0D\u7531\u8BE5 API \u516C\u544A\u7EDF\u4E00\u4FDD\u8BC1\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:55:08.8505819\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/"
    ],
    "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-1a712c71e13be8cb30219a63",
  "version": 2,
  "source_url": "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/",
    "final_url": "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/",
    "status_code": 200,
    "title": "GDELT DOC 2.0 API Debuts! \u2013 The GDELT Project",
    "description": null,
    "checked_at": "2026-10-24T17:55:08.8505819\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-24T17:55:11.7112207\u002B00:00",
  "updated_at": "2026-10-24T17:56:13.8048479\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-1a712c71e13be8cb30219a63?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-1a712c71e13be8cb30219a63?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": "\u5A92\u4F53\u4E0E\u4FE1\u606F\u7814\u7A76\uFF0FGDELT \u65B0\u95FB\u68C0\u7D22\u548C\u8986\u76D6\u7EDF\u8BA1",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-93b92d09f14db090f2a1991455b4e886",
        "source_url": "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/",
        "content_sha256": "cedae5b225981d03f73657a1bbb380462578579870b05bed2be43d29ef83db08",
        "decoded_bytes": 80455,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:55:08.8505819\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "cedae5b225981d03f73657a1bbb380462578579870b05bed2be43d29ef83db08",
        "text_utf8_bytes": 80455,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-1a712c71e13be8cb30219a63/materials/material-93b92d09f14db090f2a1991455b4e886?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-2067f77283944435a226ec491f32caf7",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-1a712c71e13be8cb30219a63",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-1a712c71e13be8cb30219a63?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-1a712c71e13be8cb30219a63?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