目录收录
Board Game Geek API
Board games, RPG and videogames. BoardGameGeek 官方 XML API2，通过 thing、search、collection 等端点获取桌游评分、机制与扩展信息。
免费 API
目录收录
无需认证
CORS: No
- 来源类型
- 目录收录
- 可用方式
- 免费可用
- 认证方式
- 无需认证
- 协议格式
- REST
- 计费摘要
- 免费为主
- 稳定性说明
- 以来源方说明为准
面向 Agent
如何调用 Board Game Geek API
供 Hermes、OpenClaw、浏览器自动化 Agent 等读取。优先解析 <head> 内 #boyapi-agent-spec JSON。
Hermes
OpenClaw
Coding Agent
Browser Agent
-
1. 确认调用目标
业务请求发往
https://boardgamegeek.com，不要向boyapi.com发送 Board Game Geek 业务 API。 -
2. 构造 HTTP 请求
- 方法：
GET - 路径：
/xmlapi2/thing - 必填：
id - 鉴权：无需 API Key
- 方法：
-
3. 最小可执行示例
复制以下 cURL 试调：
curl -sS 'https://boardgamegeek.com/xmlapi2/thing?id=174430&stats=1' -
4. 解析响应
HTTP 200 时解析 JSON 主体；失败时对照错误码表与 HTTP 状态。
-
5. 环境与限制
CORS：
No。浏览器联调以实际结果为准。
机器可读规范（JSON）
application/json · #boyapi-agent-spec
{
"spec_version": "1.0",
"page_type": "boyapi_api_detail",
"api": {
"slug": "board-game-geek",
"name": "Board Game Geek"
},
"invocation": {
"method": "GET",
"base_url": "https://boardgamegeek.com",
"path": "/xmlapi2/thing",
"full_url_example": "https://boardgamegeek.com/xmlapi2/thing?id=174430"
}
}完整字段以 <head> 中 #boyapi-agent-spec 为准。
Agent 注意：boyapi.com 仅提供目录与文档，不提供第三方 API 代理网关。
接入信息
可用方式
- 目录定位
- 免费目录收录（public-apis）
- 认证要求
- 无需认证（auth=No）
- HTTPS
- 支持（https=Yes）
- CORS
- No — 建议通过服务端代理调用
- 接口名称
- Board Game Geek
- 典型端点
- GET /xmlapi2/thing
- 功能描述
- Board games, RPG and videogames
平台支持
- CORS: No，必须服务端调用
- 遵守 BGG 使用政策与节流
- 也可用 /xmlapi2/search?query=...