IGDB API v4
CloseIGDB API v4
IGDB 官方游戏资料 API 使用 Twitch OAuth2 和 Client-ID/Bearer headers,通过 POST 查询体选字段及筛选;非商业使用免费,文档限每秒4请求、最多8并发,未调用。
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-ca412753e9c357bfe4572beb
- Card version
- 2
- Updated
- 2026-10-24T18:20:46.3751740+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.igdb.com/v4 基础地址,代表游戏查询为 POST https://api.igdb.com/v4/games。查询体使用字段选择、where、sort、search、limit 等 APICalypse 语法,非普通 JSON 请求体。使用前需 Twitch 账户、2FA 和 Confidential 类型开发者应用,通过 client_credentials 获得 access token。本文只整理已有公开文档,未创建账户/应用、取得 secret/token 或执行任何 API 请求。
Inputs
- Client-ID 与OAuth Bearer <caller_supplied_token> headers。
- POST查询体使用fields选择返回字段,where过滤、sort排序、search文本搜索、limit限制结果数。
- 不同资源使用对应v4路径;本文代表games,未将其他端点参数混用。
Outputs
- 按所选字段返回游戏数据;官方示例可请求游戏name、release_dates.human、involved_companies等。
- 示例通过application/json解析;完整games响应schema、关联展开和可空字段未在本次整理中确认。
Invocation and authentication
{
"authentication": {
"kind": "oauth",
"notes": "\u6587\u6863\u4F7F\u7528 Twitch OAuth2 client_credentials\uFF1AClient ID/Secret \u6362\u53D6access_token\uFF0C\u518D\u53D1\u9001 Client-ID \u548C Authorization: Bearer \u003Caccess_token\u003E\u3002token\u6709\u6548\u671F\u7531expires_in\u8FD4\u56DE\uFF0C\u4E0D\u80FD\u4EE5\u6837\u4F8B\u56FA\u5B9A\u5929\u6570\u4FDD\u8BC1\u3002"
},
"command": null,
"entry_url": "https://api.igdb.com/v4/games",
"kind": "http_api",
"method": "POST",
"request_example": {
"body": "fields name; limit 10;",
"documentation_text": "\u6587\u6863\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1APOST https://api.igdb.com/v4/games\uFF1BClient-ID: \u003Cclient_id\u003E\uFF1BAuthorization: Bearer \u003Caccess_token\u003E\uFF1Bbody \u4E3A fields name; limit 10;\u3002",
"method": "POST",
"url": "https://api.igdb.com/v4/games"
},
"requirements": [
"Twitch\u8D26\u6237\u542F\u75282FA\uFF0C\u5728Developer Portal\u6CE8\u518CConfidential\u5E94\u7528\u5E76\u53D6\u5F97Client ID/Secret\u3002",
"\u6309\u5B98\u65B9\u6D41\u7A0B\u83B7\u5F97OAuth access token\uFF1B\u672C\u6B21\u672A\u8BF7\u6C42\u8BA4\u8BC1\u7AEF\u70B9\u3002",
"API\u8C03\u7528\u540C\u65F6\u53D1\u9001Client-ID\u548CBearer token headers\uFF0C\u5E76\u4EE5\u67E5\u8BE2\u8BED\u6CD5\u6307\u5B9A\u5B57\u6BB5/\u7B5B\u9009\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": "free_noncommercial",
"notes": "\u6B63\u6587\u660E\u786EIGDB API\u975E\u5546\u4E1A\u4F7F\u7528\u5728Twitch Developer Service Agreement\u6761\u6B3E\u4E0B\u514D\u8D39\uFF1B\u5546\u4E1A\u7528\u9014\u9700\u5546\u4E1A\u5408\u4F5C\uFF0C\u8D39\u7528\u548C\u6761\u4EF6\u672A\u7ED9\u3002\u672C\u6B21\u4E0D\u5C06\u5176\u6269\u4E3A\u65E0\u9650\u989D\u6216\u5546\u4E1A\u514D\u8D39\u3002",
"source_url": "https://api-docs.igdb.com/"
}{
"location": "provider_server",
"notes": "Client-ID\u3001token\u548C\u67E5\u8BE2\u53D1\u9001\u5230IGDB/Twitch\u76F8\u5173\u6258\u7BA1\u670D\u52A1\uFF1B\u5B8C\u6574\u65E5\u5FD7\u4FDD\u7559\u3001\u9A7B\u7559\u53CA\u8D44\u6599\u518D\u5206\u53D1\u6761\u4EF6\u672A\u7531\u672C\u6B21\u8BFB\u53D6\u6BB5\u843D\u786E\u8BA4\u3002"
}Unknown is not a claim that a service is free, anonymous, private or unavailable.
Limitations
- 文档限每秒4请求,超过可返回429;最多8个同时未完成请求。
- 不允许直接浏览器请求,会遇CORS;本次未配置代理或绕过限制。
- OAuth token会到期,应以实际expires_in处理;具体账户或token能否访问未验证。
- 文档中旧字段/枚举有弃用迁移提示,具体使用应核对应当前字段定义。
- 未调用games、其他资源或认证端点。
Unknowns
- 实际Twitch账户、应用/secret、token及访问权限未知。
- 商业合作价格、具体合同/资料再分发条件及其他配额未知。
- 完整games字段schema、分页最大值和实际数据覆盖未整理验证。
- 数据保留和驻留条件未知。
- 未注册应用、认证、运行示例或请求游戏数据。
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:09:40.3985399\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://api-docs.igdb.com/"
],
"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": "games",
"data_handling": {
"location": "provider_server",
"notes": "Client-ID\u3001token\u548C\u67E5\u8BE2\u53D1\u9001\u5230IGDB/Twitch\u76F8\u5173\u6258\u7BA1\u670D\u52A1\uFF1B\u5B8C\u6574\u65E5\u5FD7\u4FDD\u7559\u3001\u9A7B\u7559\u53CA\u8D44\u6599\u518D\u5206\u53D1\u6761\u4EF6\u672A\u7531\u672C\u6B21\u8BFB\u53D6\u6BB5\u843D\u786E\u8BA4\u3002"
},
"description": "\u672C\u6B21\u5B98\u65B9\u6587\u6863\u7ED9\u51FA https://api.igdb.com/v4 \u57FA\u7840\u5730\u5740\uFF0C\u4EE3\u8868\u6E38\u620F\u67E5\u8BE2\u4E3A POST https://api.igdb.com/v4/games\u3002\u67E5\u8BE2\u4F53\u4F7F\u7528\u5B57\u6BB5\u9009\u62E9\u3001where\u3001sort\u3001search\u3001limit \u7B49 APICalypse \u8BED\u6CD5\uFF0C\u975E\u666E\u901A JSON \u8BF7\u6C42\u4F53\u3002\u4F7F\u7528\u524D\u9700 Twitch \u8D26\u6237\u30012FA \u548C Confidential \u7C7B\u578B\u5F00\u53D1\u8005\u5E94\u7528\uFF0C\u901A\u8FC7 client_credentials \u83B7\u5F97 access token\u3002\u672C\u6587\u53EA\u6574\u7406\u5DF2\u6709\u516C\u5F00\u6587\u6863\uFF0C\u672A\u521B\u5EFA\u8D26\u6237/\u5E94\u7528\u3001\u53D6\u5F97 secret/token \u6216\u6267\u884C\u4EFB\u4F55 API \u8BF7\u6C42\u3002",
"inputs": [
"Client-ID \u4E0EOAuth Bearer \u003Ccaller_supplied_token\u003E headers\u3002",
"POST\u67E5\u8BE2\u4F53\u4F7F\u7528fields\u9009\u62E9\u8FD4\u56DE\u5B57\u6BB5\uFF0Cwhere\u8FC7\u6EE4\u3001sort\u6392\u5E8F\u3001search\u6587\u672C\u641C\u7D22\u3001limit\u9650\u5236\u7ED3\u679C\u6570\u3002",
"\u4E0D\u540C\u8D44\u6E90\u4F7F\u7528\u5BF9\u5E94v4\u8DEF\u5F84\uFF1B\u672C\u6587\u4EE3\u8868games\uFF0C\u672A\u5C06\u5176\u4ED6\u7AEF\u70B9\u53C2\u6570\u6DF7\u7528\u3002"
],
"invocation": {
"authentication": {
"kind": "oauth",
"notes": "\u6587\u6863\u4F7F\u7528 Twitch OAuth2 client_credentials\uFF1AClient ID/Secret \u6362\u53D6access_token\uFF0C\u518D\u53D1\u9001 Client-ID \u548C Authorization: Bearer \u003Caccess_token\u003E\u3002token\u6709\u6548\u671F\u7531expires_in\u8FD4\u56DE\uFF0C\u4E0D\u80FD\u4EE5\u6837\u4F8B\u56FA\u5B9A\u5929\u6570\u4FDD\u8BC1\u3002"
},
"command": null,
"entry_url": "https://api.igdb.com/v4/games",
"kind": "http_api",
"method": "POST",
"request_example": {
"body": "fields name; limit 10;",
"documentation_text": "\u6587\u6863\u8BF7\u6C42\u5F62\u72B6\uFF08\u672A\u6267\u884C\uFF09\uFF1APOST https://api.igdb.com/v4/games\uFF1BClient-ID: \u003Cclient_id\u003E\uFF1BAuthorization: Bearer \u003Caccess_token\u003E\uFF1Bbody \u4E3A fields name; limit 10;\u3002",
"method": "POST",
"url": "https://api.igdb.com/v4/games"
},
"requirements": [
"Twitch\u8D26\u6237\u542F\u75282FA\uFF0C\u5728Developer Portal\u6CE8\u518CConfidential\u5E94\u7528\u5E76\u53D6\u5F97Client ID/Secret\u3002",
"\u6309\u5B98\u65B9\u6D41\u7A0B\u83B7\u5F97OAuth access token\uFF1B\u672C\u6B21\u672A\u8BF7\u6C42\u8BA4\u8BC1\u7AEF\u70B9\u3002",
"API\u8C03\u7528\u540C\u65F6\u53D1\u9001Client-ID\u548CBearer token headers\uFF0C\u5E76\u4EE5\u67E5\u8BE2\u8BED\u6CD5\u6307\u5B9A\u5B57\u6BB5/\u7B5B\u9009\u3002"
]
},
"limitations": [
"\u6587\u6863\u9650\u6BCF\u79D24\u8BF7\u6C42\uFF0C\u8D85\u8FC7\u53EF\u8FD4\u56DE429\uFF1B\u6700\u591A8\u4E2A\u540C\u65F6\u672A\u5B8C\u6210\u8BF7\u6C42\u3002",
"\u4E0D\u5141\u8BB8\u76F4\u63A5\u6D4F\u89C8\u5668\u8BF7\u6C42\uFF0C\u4F1A\u9047CORS\uFF1B\u672C\u6B21\u672A\u914D\u7F6E\u4EE3\u7406\u6216\u7ED5\u8FC7\u9650\u5236\u3002",
"OAuth token\u4F1A\u5230\u671F\uFF0C\u5E94\u4EE5\u5B9E\u9645expires_in\u5904\u7406\uFF1B\u5177\u4F53\u8D26\u6237\u6216token\u80FD\u5426\u8BBF\u95EE\u672A\u9A8C\u8BC1\u3002",
"\u6587\u6863\u4E2D\u65E7\u5B57\u6BB5/\u679A\u4E3E\u6709\u5F03\u7528\u8FC1\u79FB\u63D0\u793A\uFF0C\u5177\u4F53\u4F7F\u7528\u5E94\u6838\u5BF9\u5E94\u5F53\u524D\u5B57\u6BB5\u5B9A\u4E49\u3002",
"\u672A\u8C03\u7528games\u3001\u5176\u4ED6\u8D44\u6E90\u6216\u8BA4\u8BC1\u7AEF\u70B9\u3002"
],
"outputs": [
"\u6309\u6240\u9009\u5B57\u6BB5\u8FD4\u56DE\u6E38\u620F\u6570\u636E\uFF1B\u5B98\u65B9\u793A\u4F8B\u53EF\u8BF7\u6C42\u6E38\u620Fname\u3001release_dates.human\u3001involved_companies\u7B49\u3002",
"\u793A\u4F8B\u901A\u8FC7application/json\u89E3\u6790\uFF1B\u5B8C\u6574games\u54CD\u5E94schema\u3001\u5173\u8054\u5C55\u5F00\u548C\u53EF\u7A7A\u5B57\u6BB5\u672A\u5728\u672C\u6B21\u6574\u7406\u4E2D\u786E\u8BA4\u3002"
],
"pricing": {
"model": "free_noncommercial",
"notes": "\u6B63\u6587\u660E\u786EIGDB API\u975E\u5546\u4E1A\u4F7F\u7528\u5728Twitch Developer Service Agreement\u6761\u6B3E\u4E0B\u514D\u8D39\uFF1B\u5546\u4E1A\u7528\u9014\u9700\u5546\u4E1A\u5408\u4F5C\uFF0C\u8D39\u7528\u548C\u6761\u4EF6\u672A\u7ED9\u3002\u672C\u6B21\u4E0D\u5C06\u5176\u6269\u4E3A\u65E0\u9650\u989D\u6216\u5546\u4E1A\u514D\u8D39\u3002",
"source_url": "https://api-docs.igdb.com/"
},
"provider_claimed": false,
"record_kind": "public_source",
"representative_queries": [
"IGDB \u5B98\u65B9\u6E38\u620F\u8D44\u6599\u67E5\u8BE2 API",
"\u7528 IGDB fields search \u67E5\u8BE2\u6E38\u620F",
"IGDB \u975E\u5546\u4E1A\u514D\u8D39 OAuth \u4E0E\u6BCF\u79D2\u901F\u7387\u9650\u5236"
],
"sources": [
{
"basis": "official_documentation",
"checked_at": "2026-10-24T18:09:40.3985399\u002B00:00",
"title": "IGDB API docs",
"url": "https://api-docs.igdb.com/"
}
],
"summary": "IGDB \u5B98\u65B9\u6E38\u620F\u8D44\u6599 API \u4F7F\u7528 Twitch OAuth2 \u548C Client-ID/Bearer headers\uFF0C\u901A\u8FC7 POST \u67E5\u8BE2\u4F53\u9009\u5B57\u6BB5\u53CA\u7B5B\u9009\uFF1B\u975E\u5546\u4E1A\u4F7F\u7528\u514D\u8D39\uFF0C\u6587\u6863\u9650\u6BCF\u79D24\u8BF7\u6C42\u3001\u6700\u591A8\u5E76\u53D1\uFF0C\u672A\u8C03\u7528\u3002",
"tags": [
"IGDB",
"video games",
"metadata",
"HTTP API",
"Twitch OAuth",
"documentation"
],
"terms_url": null,
"title": "IGDB API v4",
"unknowns": [
"\u5B9E\u9645Twitch\u8D26\u6237\u3001\u5E94\u7528/secret\u3001token\u53CA\u8BBF\u95EE\u6743\u9650\u672A\u77E5\u3002",
"\u5546\u4E1A\u5408\u4F5C\u4EF7\u683C\u3001\u5177\u4F53\u5408\u540C/\u8D44\u6599\u518D\u5206\u53D1\u6761\u4EF6\u53CA\u5176\u4ED6\u914D\u989D\u672A\u77E5\u3002",
"\u5B8C\u6574games\u5B57\u6BB5schema\u3001\u5206\u9875\u6700\u5927\u503C\u548C\u5B9E\u9645\u6570\u636E\u8986\u76D6\u672A\u6574\u7406\u9A8C\u8BC1\u3002",
"\u6570\u636E\u4FDD\u7559\u548C\u9A7B\u7559\u6761\u4EF6\u672A\u77E5\u3002",
"\u672A\u6CE8\u518C\u5E94\u7528\u3001\u8BA4\u8BC1\u3001\u8FD0\u884C\u793A\u4F8B\u6216\u8BF7\u6C42\u6E38\u620F\u6570\u636E\u3002"
],
"verification": {
"checked_at": "2026-10-24T18:09:40.3985399\u002B00:00",
"checks_performed": [
"\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
],
"evidence_urls": [
"https://api-docs.igdb.com/"
],
"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-ca412753e9c357bfe4572beb",
"version": 2,
"source_url": "https://api-docs.igdb.com/",
"ownership_state": "unclaimed",
"submitted_by": {
"kind": "importer",
"name": "NAVONAVO public material importer"
},
"submitter_identity_verified": false,
"source_check": {
"url": "https://api-docs.igdb.com/",
"final_url": "https://api-docs.igdb.com/",
"status_code": 200,
"title": "IGDB API docs",
"description": null,
"checked_at": "2026-10-24T18:09:40.3985399\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:09:45.1263441\u002B00:00",
"updated_at": "2026-10-24T18:20:46.3751740\u002B00:00",
"read_url": "https://navonavo.com/api/v1/capabilities/cap-ca412753e9c357bfe4572beb?version=2",
"page_url": "https://navonavo.com/capabilities/cap-ca412753e9c357bfe4572beb?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": "\u7535\u5B50\u6E38\u620F\u76EE\u5F55\u4E0E\u53D1\u884C\u5143\u6570\u636E\u67E5\u8BE2",
"evidence_grade": "documentation_only",
"attachments": [
{
"material_id": "material-48d8303e5239d9fafee7010792d5a5f1",
"source_url": "https://api-docs.igdb.com/",
"content_sha256": "28e8a751b11c38acbb6954a8a29fc2730edc0e356b90844b362210c8a69e2ae3",
"decoded_bytes": 1289877,
"content_type": "text/html",
"captured_at": "2026-10-24T18:09:40.3985399\u002B00:00",
"text_representation": "decoded_text_utf8",
"text_utf8_sha256": "28e8a751b11c38acbb6954a8a29fc2730edc0e356b90844b362210c8a69e2ae3",
"text_utf8_bytes": 1289877,
"capture_body_reconstructed": true,
"read_path": "/api/v1/capabilities/cap-ca412753e9c357bfe4572beb/materials/material-48d8303e5239d9fafee7010792d5a5f1?version=1"
}
]
},
"last_correction": {
"contribution_id": "contribution-602f8d6c2fd742398c8624e8e009ef78",
"reason": "\u4F9D\u636E\u672C\u6B21\u5B98\u65B9IGDB\u6587\u6863\u6574\u7406\u771F\u5B9Ev4 games POST\u3001\u67E5\u8BE2\u8BED\u6CD5\u3001Twitch OAuth/\u53CCheaders\u4E0E\u660E\u786E\u975E\u5546\u4E1A\u514D\u8D39\u53CA\u9650\u6D41\uFF0C\u672A\u6267\u884C\u8D26\u6237\u3001\u8BA4\u8BC1\u6216\u6570\u636E\u8C03\u7528\u3002",
"source_urls": [
"https://api-docs.igdb.com/"
],
"reported_by": "contributor"
},
"version_read_basis": "archived_revision",
"deep_read": {
"schema_version": "navonavo.capability-read.v1",
"card_id": "cap-ca412753e9c357bfe4572beb",
"card_version": 2,
"selected_profile_id": null,
"state": "not_checked",
"review_state": null,
"read_url": "https://navonavo.com/api/v1/capabilities/cap-ca412753e9c357bfe4572beb?version=2",
"page_url": "https://navonavo.com/capabilities/cap-ca412753e9c357bfe4572beb?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"
]
}
}