面向开发者的公开 API

免费的只读 JSON API，提供 CS2 物品价格、Steam 库存估值、职业战队与选手数据。无需密钥或注册即可使用，CORS 开放，价格以美元计，大约每小时更新一次。在个人资料页免费创建的密钥可提高限额。

接口

此表由 OpenAPI 文档生成，接口说明为英文。带 * 的参数为必填。

接口	返回内容	参数
GET `/api/v1/inventory`	Appraise a public CS2 Steam inventory	`steam*lang`
GET `/api/v1/inventories`	Stored appraisals of up to 50 Steam inventories in one call (200 with an API key)	`steam*lang`
GET `/api/v1/price`	Find CS2 items by name and get their current prices	`q*lang`
GET `/api/v1/price/history`	Daily price history of one CS2 item	`q*dayslang`
GET `/api/v1/teams`	Top CS2 teams by the official Valve ranking	`region`
GET `/api/v1/teams/{slug}`	Team profile: roster, trophies, current events, recent matches, map stats and rank history	`slug*`
GET `/api/v1/players`	Players of the ranked teams, optionally only those with a public Steam profile	`steamlimit`
GET `/api/v1/players/{slug}`	Player of a ranked team	`slug*`

限制

无密钥时按 IP 地址计算限额；下一节将其与个人密钥的限额对比。通过 User-Agent 识别的已知 AI 助手另有一档限额：

已知 AI 助手在 /api/v1 上每分钟请求数: 600
AI 助手每小时库存估值次数: 600
从未估值过的资料每分钟查询数，由所有 AI 助手共享: 8

超出限制时 API 返回 429，正在计算新估值时返回 503；两者都带有以秒为单位的 Retry-After。请等待相应时间后重试一次。

使用 API 密钥提高限额

所有接口无需密钥即可使用。使用免费的个人密钥后，限额按密钥而非 IP 地址计算，并且更高；/api/v1/inventory 也会最多等待 25 秒获取新估值，而不是直接返回 503。

限额	无密钥	有密钥
每分钟请求数	120	600
每小时库存估值次数	60	300
每分钟查询从未估值的资料数	计入每小时限额	30
每次调用 /api/v1/inventories 的资料数	50	200

如何获取密钥

通过 Steam 登录，在个人资料页打开“API 密钥”栏目。前往个人资料
注册满一天的账号即可创建密钥。最多可同时保留 3 个有效密钥，每个都要写上用途名称。
密钥只在创建时显示一次，我们只保存其哈希值。丢失或泄露的密钥可一键吊销，并换成新密钥。

如何发送密钥

在 Authorization 请求头中以 Bearer 方案发送密钥，或放在 X-Api-Key 请求头中。密钥只在 /api/v1 上读取；不要把它写进在浏览器中运行的代码或公开仓库。

curl -H "Authorization: Bearer $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"

curl -H "X-Api-Key: $SKINORY_API_KEY" \
  "https://skinory.io/api/v1/inventory?steam=76561197960287930"

响应头与错误

输错、未知或已吊销的密钥绝不会被忽略：请求会收到带 WWW-Authenticate 的 401，而不会退回匿名限额。被封禁账号的密钥会收到 403。超出限额时返回带 Retry-After 的 429。

规范与机器可读文件

/api/openapi.json OpenAPI 3.1 规范：参数、响应结构与错误
/.well-known/openapi.json 同一份规范的 well-known 地址
/llms.txt 面向 AI 助手的网站概览，含 URL 规则与 API 用法
/llms-full.txt 所有英文文字指南合并为一个 Markdown 文件
/llms-catalog.txt 按在售市值排名前 500 的皮肤，JSON Lines 格式，每小时更新
/.well-known/ai-catalog.json 面向 AI 代理的能力清单
方法说明价格来源与计算方法

许可

指南、编辑文章以及本站自有的衍生数据（掉落池估算、武器箱 RTP、指数、每日中位数、图案表、llms-catalog.txt 汇编）采用 CC BY 4.0 许可：请注明 Skinory 并附上来源页面链接。

战队与选手数据（/api/v1/teams、/api/v1/players）来自 Liquipedia，采用 CC BY-SA 4.0 许可：请注明 Skinory 并附链接，改编作品须以相同许可共享。

物品目录（通过 CSGO-API 数据集取自游戏文件的名称、图片、稀有度与收藏品）和市场价格属于第三方数据。本站不对其声明许可，适用原始来源的条款。

CC BY 4.0 ↗ · CC BY-SA 4.0 ↗

如何引用

请按“Skinory — 页面标题，URL，更新日期”的格式引用页面，使用规范 URL 和页面显示的日期，没有则写阅读日期。引用价格时请注明币种和时间：价格会变动。

Skinory — AK-47 | Redline, https://skinory.io/zh/items/ak-47-redline, 2026-09-27