Chess.com PubAPI · 公开玩家与棋局资料

Chess.com PubAPI是公开只读REST接口，以JSON-LD提供玩家、棋局及俱乐部/赛事资料，示例无需登录；不能发棋步或读取私聊。并行访问可能限流，数据受缓存影响。仅文档整理，未查询或下棋；费用和具体再利用许可未核。

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-867d5314d5c34a5a32fc66bb
Card version: 2
Updated: 2026-10-24T18:02:43.9120977+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

Learn what the Chess.com PubAPI is, what data it provides, and how to access public player, game, and tournament data using API endpoints.

Inputs

按目标公开资源和username/ID构造路径；本页只给player例，棋局/赛事等完整参数本轮未展开。
可用If-None-Match、If-Modified-Since配合缓存；JSONP callback有字符和200字符长度限制。

Outputs

只读JSON-LD公开资料，可作普通JSON解析，Link header提供context。
可能返回200、301、304、404、410、429；缓存未变时304无新数据，不代表获取了最新完整资料。

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "none",
    "notes": "\u672C\u6587\u76F4\u63A5\u7528\u6D4F\u89C8\u5668/curl\u8BBF\u95EE\u516C\u5F00player\u7AEF\u70B9\uFF0C\u4E0D\u8981\u6C42\u767B\u5F55\u6216key\uFF1B\u8BA4\u8BC1\u7528\u6237/connected board\u53E6\u9700\u7533\u8BF7\uFF0C\u4E0D\u5C5E\u4E8E\u672C\u6587\u516C\u5F00\u63A5\u53E3\u3002\u672C\u8F6E\u672A\u67E5\u8BE2\u3002"
  },
  "command": null,
  "entry_url": "https://api.chess.com/pub/",
  "kind": "http_api",
  "method": "GET",
  "request_example": null,
  "requirements": [
    "\u6309\u5DF2\u6587\u6863\u5316\u7684\u516C\u5F00\u7AEF\u70B9\u6784\u9020URL\uFF1B\u672C\u9875\u793A\u4F8B\u4E3A/player/hikaru\uFF0C\u5176\u4ED6\u5B8C\u6574\u7AEF\u70B9\u6E05\u5355\u53E6\u9875\u3002",
    "\u5EFA\u8BAE\u5E26\u542B\u5E94\u7528\u540D/\u8054\u7CFB\u4FE1\u606F\u7684User-Agent\u4EE5\u4FBF\u95EE\u9898\u5B9A\u4F4D\uFF1B\u975E\u8BA4\u8BC1\u51ED\u636E\u3002",
    "\u9075\u5B88\u5E73\u53F0IP\u548C\u670D\u52A1\u4F7F\u7528\u89C4\u5219\uFF0C\u4E0D\u628A\u516C\u5F00API\u89C6\u4E3A\u4E0B\u68CB\u3001\u5F15\u64CE\u5EFA\u8BAE\u6216\u79C1\u5BC6\u6570\u636E\u6743\u9650\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": "\u672C\u9875\u516C\u5F00API\u4F8B\u65E0\u9700\u8BA4\u8BC1\uFF0C\u4F46\u672A\u660E\u5217\u8D39\u7528\u6216\u5B8C\u6574\u5546\u4E1A\u8BB8\u53EF\uFF1B\u4E32\u884C\u8BBF\u95EE\u4E0D\u9650\u662F\u9650\u6D41\u63CF\u8FF0\uFF0C\u4E0D\u662F\u4EFB\u610F\u7528\u9014\u514D\u8D39\u6388\u6743\u3002",
  "source_url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
}

{
  "location": "provider_server",
  "notes": "\u5B9E\u9645\u8BF7\u6C42\u4F1A\u53D1\u9001\u73A9\u5BB6\u6216\u8D44\u6E90\u6807\u8BC6\u3001IP\u53CA\u53EF\u9009\u8054\u7CFBUser-Agent\uFF1B\u65E5\u5FD7/\u4FDD\u7559\u672A\u77E5\u3002\u516C\u5F00\u73A9\u5BB6\u4FE1\u606F\u4ECD\u987B\u6309\u5E73\u53F0\u653F\u7B56\u4F7F\u7528\uFF0C\u4E0D\u590D\u5236UI/\u54C1\u724C\u3002\u672C\u8F6E\u672A\u8BFB\u4EFB\u4F55\u5B9E\u9645\u73A9\u5BB6\u6570\u636E\u6216\u6BD4\u8D5B\u3002"
}

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

Limitations

不能发送棋步或命令，不提供game chat/conditional moves等登录用户私有内容。
官方称串行访问不限，但并行可能429，异常活动可暂封；不当成无限并发或SLA。
页内说端点刷新频率最多每12小时一次，且CDN按Cache-Control缓存；非实时棋局接口保证。
API使用需尊重Chess.com IP；浏览器扩展另有非商业、公平竞赛和禁止未文档后端访问政策，不把该条款泛化为全部独立API应用许可。

Unknowns

完整端点schema、当前数据可用性和实时性未验证。
商业再利用、IP授权、费用和日志保留未知。
未调用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:57:20.3297839\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
  ],
  "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\u73A9\u5BB6\u6216\u8D44\u6E90\u6807\u8BC6\u3001IP\u53CA\u53EF\u9009\u8054\u7CFBUser-Agent\uFF1B\u65E5\u5FD7/\u4FDD\u7559\u672A\u77E5\u3002\u516C\u5F00\u73A9\u5BB6\u4FE1\u606F\u4ECD\u987B\u6309\u5E73\u53F0\u653F\u7B56\u4F7F\u7528\uFF0C\u4E0D\u590D\u5236UI/\u54C1\u724C\u3002\u672C\u8F6E\u672A\u8BFB\u4EFB\u4F55\u5B9E\u9645\u73A9\u5BB6\u6570\u636E\u6216\u6BD4\u8D5B\u3002"
  },
  "description": "Learn what the Chess.com PubAPI is, what data it provides, and how to access public player, game, and tournament data using API endpoints.",
  "inputs": [
    "\u6309\u76EE\u6807\u516C\u5F00\u8D44\u6E90\u548Cusername/ID\u6784\u9020\u8DEF\u5F84\uFF1B\u672C\u9875\u53EA\u7ED9player\u4F8B\uFF0C\u68CB\u5C40/\u8D5B\u4E8B\u7B49\u5B8C\u6574\u53C2\u6570\u672C\u8F6E\u672A\u5C55\u5F00\u3002",
    "\u53EF\u7528If-None-Match\u3001If-Modified-Since\u914D\u5408\u7F13\u5B58\uFF1BJSONP callback\u6709\u5B57\u7B26\u548C200\u5B57\u7B26\u957F\u5EA6\u9650\u5236\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "none",
      "notes": "\u672C\u6587\u76F4\u63A5\u7528\u6D4F\u89C8\u5668/curl\u8BBF\u95EE\u516C\u5F00player\u7AEF\u70B9\uFF0C\u4E0D\u8981\u6C42\u767B\u5F55\u6216key\uFF1B\u8BA4\u8BC1\u7528\u6237/connected board\u53E6\u9700\u7533\u8BF7\uFF0C\u4E0D\u5C5E\u4E8E\u672C\u6587\u516C\u5F00\u63A5\u53E3\u3002\u672C\u8F6E\u672A\u67E5\u8BE2\u3002"
    },
    "command": null,
    "entry_url": "https://api.chess.com/pub/",
    "kind": "http_api",
    "method": "GET",
    "request_example": null,
    "requirements": [
      "\u6309\u5DF2\u6587\u6863\u5316\u7684\u516C\u5F00\u7AEF\u70B9\u6784\u9020URL\uFF1B\u672C\u9875\u793A\u4F8B\u4E3A/player/hikaru\uFF0C\u5176\u4ED6\u5B8C\u6574\u7AEF\u70B9\u6E05\u5355\u53E6\u9875\u3002",
      "\u5EFA\u8BAE\u5E26\u542B\u5E94\u7528\u540D/\u8054\u7CFB\u4FE1\u606F\u7684User-Agent\u4EE5\u4FBF\u95EE\u9898\u5B9A\u4F4D\uFF1B\u975E\u8BA4\u8BC1\u51ED\u636E\u3002",
      "\u9075\u5B88\u5E73\u53F0IP\u548C\u670D\u52A1\u4F7F\u7528\u89C4\u5219\uFF0C\u4E0D\u628A\u516C\u5F00API\u89C6\u4E3A\u4E0B\u68CB\u3001\u5F15\u64CE\u5EFA\u8BAE\u6216\u79C1\u5BC6\u6570\u636E\u6743\u9650\u3002"
    ]
  },
  "limitations": [
    "\u4E0D\u80FD\u53D1\u9001\u68CB\u6B65\u6216\u547D\u4EE4\uFF0C\u4E0D\u63D0\u4F9Bgame chat/conditional moves\u7B49\u767B\u5F55\u7528\u6237\u79C1\u6709\u5185\u5BB9\u3002",
    "\u5B98\u65B9\u79F0\u4E32\u884C\u8BBF\u95EE\u4E0D\u9650\uFF0C\u4F46\u5E76\u884C\u53EF\u80FD429\uFF0C\u5F02\u5E38\u6D3B\u52A8\u53EF\u6682\u5C01\uFF1B\u4E0D\u5F53\u6210\u65E0\u9650\u5E76\u53D1\u6216SLA\u3002",
    "\u9875\u5185\u8BF4\u7AEF\u70B9\u5237\u65B0\u9891\u7387\u6700\u591A\u6BCF12\u5C0F\u65F6\u4E00\u6B21\uFF0C\u4E14CDN\u6309Cache-Control\u7F13\u5B58\uFF1B\u975E\u5B9E\u65F6\u68CB\u5C40\u63A5\u53E3\u4FDD\u8BC1\u3002",
    "API\u4F7F\u7528\u9700\u5C0A\u91CDChess.com IP\uFF1B\u6D4F\u89C8\u5668\u6269\u5C55\u53E6\u6709\u975E\u5546\u4E1A\u3001\u516C\u5E73\u7ADE\u8D5B\u548C\u7981\u6B62\u672A\u6587\u6863\u540E\u7AEF\u8BBF\u95EE\u653F\u7B56\uFF0C\u4E0D\u628A\u8BE5\u6761\u6B3E\u6CDB\u5316\u4E3A\u5168\u90E8\u72EC\u7ACBAPI\u5E94\u7528\u8BB8\u53EF\u3002"
  ],
  "outputs": [
    "\u53EA\u8BFBJSON-LD\u516C\u5F00\u8D44\u6599\uFF0C\u53EF\u4F5C\u666E\u901AJSON\u89E3\u6790\uFF0CLink header\u63D0\u4F9Bcontext\u3002",
    "\u53EF\u80FD\u8FD4\u56DE200\u3001301\u3001304\u3001404\u3001410\u3001429\uFF1B\u7F13\u5B58\u672A\u53D8\u65F6304\u65E0\u65B0\u6570\u636E\uFF0C\u4E0D\u4EE3\u8868\u83B7\u53D6\u4E86\u6700\u65B0\u5B8C\u6574\u8D44\u6599\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u672C\u9875\u516C\u5F00API\u4F8B\u65E0\u9700\u8BA4\u8BC1\uFF0C\u4F46\u672A\u660E\u5217\u8D39\u7528\u6216\u5B8C\u6574\u5546\u4E1A\u8BB8\u53EF\uFF1B\u4E32\u884C\u8BBF\u95EE\u4E0D\u9650\u662F\u9650\u6D41\u63CF\u8FF0\uFF0C\u4E0D\u662F\u4EFB\u610F\u7528\u9014\u514D\u8D39\u6388\u6743\u3002",
    "source_url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:57:20.3297839\u002B00:00",
      "title": "What is the PubAPI and how do I use it? | Chess.com Help Center",
      "url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
    }
  ],
  "summary": "Chess.com PubAPI\u662F\u516C\u5F00\u53EA\u8BFBREST\u63A5\u53E3\uFF0C\u4EE5JSON-LD\u63D0\u4F9B\u73A9\u5BB6\u3001\u68CB\u5C40\u53CA\u4FF1\u4E50\u90E8/\u8D5B\u4E8B\u8D44\u6599\uFF0C\u793A\u4F8B\u65E0\u9700\u767B\u5F55\uFF1B\u4E0D\u80FD\u53D1\u68CB\u6B65\u6216\u8BFB\u53D6\u79C1\u804A\u3002\u5E76\u884C\u8BBF\u95EE\u53EF\u80FD\u9650\u6D41\uFF0C\u6570\u636E\u53D7\u7F13\u5B58\u5F71\u54CD\u3002\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u67E5\u8BE2\u6216\u4E0B\u68CB\uFF1B\u8D39\u7528\u548C\u5177\u4F53\u518D\u5229\u7528\u8BB8\u53EF\u672A\u6838\u3002",
  "tags": [
    "Chess.com",
    "PubAPI",
    "\u56FD\u9645\u8C61\u68CB",
    "\u516C\u5F00\u6570\u636E",
    "\u53EA\u8BFB",
    "JSON-LD",
    "\u65E0\u9700\u767B\u5F55\u793A\u4F8B"
  ],
  "terms_url": null,
  "title": "Chess.com PubAPI \u00B7 \u516C\u5F00\u73A9\u5BB6\u4E0E\u68CB\u5C40\u8D44\u6599",
  "unknowns": [
    "\u5B8C\u6574\u7AEF\u70B9schema\u3001\u5F53\u524D\u6570\u636E\u53EF\u7528\u6027\u548C\u5B9E\u65F6\u6027\u672A\u9A8C\u8BC1\u3002",
    "\u5546\u4E1A\u518D\u5229\u7528\u3001IP\u6388\u6743\u3001\u8D39\u7528\u548C\u65E5\u5FD7\u4FDD\u7559\u672A\u77E5\u3002",
    "\u672A\u8C03\u7528API\u3001\u63D0\u4EA4\u68CB\u6B65\u3001\u8FD0\u884C\u5F15\u64CE\u6216\u5B89\u88C5\u6269\u5C55\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:57:20.3297839\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
    ],
    "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-867d5314d5c34a5a32fc66bb",
  "version": 2,
  "source_url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it",
    "final_url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it",
    "status_code": 200,
    "title": "What is the PubAPI and how do I use it? | Chess.com Help Center",
    "description": "Learn what the Chess.com PubAPI is, what data it provides, and how to access public player, game, and tournament data using API endpoints.",
    "checked_at": "2026-10-24T17:57:20.3297839\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:57:23.4888292\u002B00:00",
  "updated_at": "2026-10-24T18:02:43.9120977\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-867d5314d5c34a5a32fc66bb?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-867d5314d5c34a5a32fc66bb?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": "\u6E38\u620F\u516C\u5F00\u6570\u636E\uFF5C\u53EA\u8BFB\u73A9\u5BB6\u4E0E\u68CB\u5C40\u8D44\u6599API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-3479651c83a21d437de6329aaa94ee4b",
        "source_url": "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it",
        "content_sha256": "c1e11e6effe186a99feebaab7e12050eff2b4c19ea6f0a8f4d4a9fa69c542fdb",
        "decoded_bytes": 128647,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:57:20.3297839\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "c1e11e6effe186a99feebaab7e12050eff2b4c19ea6f0a8f4d4a9fa69c542fdb",
        "text_utf8_bytes": 128647,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-867d5314d5c34a5a32fc66bb/materials/material-3479651c83a21d437de6329aaa94ee4b?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-b137f6ac7e5e4232b3b202b0509615bc",
    "reason": "\u4F9D\u636E\u672C\u6279Chess.com\u5B98\u65B9PubAPI\u5E2E\u52A9\u9875\u6574\u7406\u53EA\u8BFB\u516C\u5F00\u6570\u636E\u3001\u9650\u6D41\u7F13\u5B58\u53CAIP/\u6269\u5C55\u653F\u7B56\u5DEE\u522B\uFF1B\u672A\u67E5\u8BE2\u73A9\u5BB6\u3001\u4E0B\u68CB\u6216\u6267\u884C\u5F15\u64CE\u3002",
    "source_urls": [
      "https://support.chess.com/en/articles/9650547-what-is-the-pubapi-and-how-do-i-use-it"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-867d5314d5c34a5a32fc66bb",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-867d5314d5c34a5a32fc66bb?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-867d5314d5c34a5a32fc66bb?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