Credits 与 API 计费
SteamData Connect 采用 credit 计量配额体系。你的月度套餐附带固定数量的 credits，每次 API 调用或 MCP 工具调用都会根据操作的实际计算成本消耗相应数量的 credits。
为什么要用 Credits？
不同操作的计算量差异很大：
- 查询单条游戏记录非常轻量。
- 批量获取大量游戏、执行复杂搜索，或调用 AI 洞察接口，计算成本要高得多。
Credits 让我们能够对每种操作进行合理计费，而不是把所有调用一视同仁。
Credit 档位
| 消耗 | 对应操作 |
|---|---|
| 1 credit | 单条记录查询（游戏、开发商、发行商、标签、Demo、分类、类型、排名、评测） |
| 2 credits | 批量获取、搜索、时序数据、本地化名称列表 |
| 10 credits | AI 驱动的洞察接口（steam_app_insights_get） |
VPP（玩家画像）工具的 credit 成本由 VPP 服务通过 well-known 接口动态声明，见下文。
REST API 端点
| 方法 | 端点 | Credits |
|---|---|---|
| GET | /api/v1/apps/{appid} | 1 |
| GET | /api/v1/apps/{appid}/localized | 1 |
| POST | /api/v1/apps/batch | 2 |
| GET | /api/v1/apps/search | 2 |
| GET | /api/v1/apps/list | 2 |
| GET | /api/v1/apps/{appid}/timeseries | 2 |
| GET | /api/v1/apps/{appid}/insights | 10 |
| GET | /api/v1/apps/localized-names | 2 |
| GET | /api/v1/demos/{demoid} | 1 |
| GET | /api/v1/demos/{demoid}/localized | 1 |
| POST | /api/v1/demos/batch | 2 |
| GET | /api/v1/demos/search | 2 |
| GET | /api/v1/demos/list | 2 |
| GET | /api/v1/demos/localized-names | 2 |
| GET | /api/v1/developers/{name} | 1 |
| GET | /api/v1/developers/{name}/apps | 2 |
| GET | /api/v1/developers/{name}/timeseries | 2 |
| GET | /api/v1/developers/search | 2 |
| GET | /api/v1/publishers/{name} | 1 |
| GET | /api/v1/publishers/{name}/apps | 2 |
| GET | /api/v1/publishers/{name}/timeseries | 2 |
| GET | /api/v1/publishers/search | 2 |
| GET | /api/v1/tags/{tagid} | 1 |
| GET | /api/v1/categories/{catid} | 1 |
| GET | /api/v1/genres/{genreid} | 1 |
| GET | /api/v1/ranks | 2 |
| GET | /api/v1/reviews/{appid} | 1 |
| GET | /api/v1/reviews | 2 |
MCP 工具
SteamData Connect 通过 MCP 接口 暴露相同的数据能力。每次 MCP tools/call 调用消耗等价的 credits。
| MCP 工具 | Credits |
|---|---|
steam_app_get | 1 |
steam_app_get_localized | 1 |
steam_app_batch | 2 |
steam_app_search | 2 |
steam_app_list | 2 |
steam_app_get_timeseries | 2 |
steam_app_insights_get | 10 |
steam_app_localized_names | 2 |
steam_demo_get | 1 |
steam_demo_get_localized | 1 |
steam_demo_batch | 2 |
steam_demo_search | 2 |
steam_demo_list | 2 |
steam_demo_localized_names | 2 |
steam_developer_get | 1 |
steam_developer_get_apps | 2 |
steam_developer_get_timeseries | 2 |
steam_developer_search | 2 |
steam_publisher_get | 1 |
steam_publisher_get_apps | 2 |
steam_publisher_get_timeseries | 2 |
steam_publisher_search | 2 |
steam_tag_get | 1 |
steam_category_get | 1 |
steam_genre_get | 1 |
steam_rank_get | 2 |
steam_review_get | 1 |
steam_review_list | 2 |
steam_creator_get | 1 |
steam_creator_get_apps | 2 |
steam_creator_get_timeseries | 2 |
steam_creator_search | 2 |
VPP 工具（玩家画像）
VPP（Verified Player Persona，真实玩家画像）工具基于真实玩家的评测和社区帖子，提供 AI 生成的玩家画像与偏好洞察。其 credit 成本由 VPP 服务动态声明。
| MCP 工具 | 说明 | Credits |
|---|---|---|
vpp_search_profiles | 根据游戏偏好和行为维度搜索玩家画像 | 2 |
vpp_get_profile | 获取指定玩家的完整画像 | 1 |
vpp_ask | 用自然语言提问，由检索增强生成（RAG）从玩家画像中作答 | 10 |
vpp_stats | 获取玩家画像池的聚合统计信息 | 1 |
VPP 工具成本在服务启动时从 VPP 服务拉取，每 10 分钟刷新一次。上表为当前默认值，实际成本可能因服务更新而有所不同。
查看用量
- Dashboard → 团队 → Connect API — 查看团队当月 credit 用量及剩余额度。
- Dashboard → 账户 → API 密钥 — 查看个人 API 密钥的 credit 用量。
配额重置
Credits 在每个自然月的第一天重置，未使用的 credits 不会滚入下月。
减少 Credit 消耗的技巧
- 在客户端缓存响应。游戏数据变动不频繁——短暂的 TTL 缓存可以大幅减少调用量。
- 使用批量接口（
/apps/batch、steam_app_batch）一次获取多条游戏数据。批量获取 50 条只消耗 2 credits，而逐条查询则需要 50 × 1 = 50 credits。 - 优先使用精确查询，在已知
appid时避免搜索接口。 - 避免轮询
insights接口——它消耗 10 credits。建议一次获取后缓存结果。