面向開發者的公開 API
免費的唯讀 JSON API，提供 CS2 物品價格、Steam 物品庫估值、職業隊伍與選手資料。無需金鑰或註冊即可使用，CORS 開放，價格以美元計，大約每小時更新一次。在個人檔案頁免費建立的金鑰可提高限額。
你的物品，你的價格追蹤。
儲存 CS2 物品、追蹤價格變化，直接在 Steam 比較各市場報價。
端點
此表由 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/offers | Buy-now offers for one CS2 item on every market feed | name*lang |
GET /api/v1/float | Exact float, seed, StatTrak™ count, stickers and charm of a CS2 item by inspect link | url*lang |
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 地址共用限額，AI 助手也適用相同規則。個人 API 金鑰可提高限額。
- 已知 AI 助手在 /api/v1 上每分鐘請求數
- 120
- AI 助手每小時物品庫估值次數
- 60
- 從未估值過的資料每分鐘查詢數，由所有 AI 助手共享
- 8
超出限制時 API 返回 429，正在計算新估值時返回 503；兩者都帶有以秒為單位的 Retry-After。請等待相應時間後重試一次。
使用 API 金鑰提高限額
所有端點均可在無金鑰的情況下使用。使用免費個人金鑰後，會依金鑰而非 IP 位址計算，並提供較高額度；/api/v1/inventory 也會最多等待 25 秒取得新估值，無須立即回傳 503。
| 限額 | 無金鑰 | 有金鑰 |
|---|---|---|
| 每分鐘請求數 | 120 | 600 |
| 每小時物品庫估值次數 | 60 | 300 |
| 每分鐘查詢從未估值的資料數 | 計入每小時限額 | 30 |
| 每次呼叫 /api/ | 50 | 200 |
| /api/ | 10 | 30 |
如何取得金鑰
- 透過 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"回應標頭與錯誤
- X-RateLimit-Limit
- 該金鑰每分鐘允許的請求數
- X-RateLimit-Remaining
- 目前時段的剩餘請求數
- X-RateLimit-Reset
- 距離額度重設的秒數
輸錯、未知或已吊銷的金鑰絕不會被忽略：請求會收到帶 WWW-Authenticate 的 401，而不會退回匿名限額。被封鎖帳號的金鑰會收到 403。超出限額時返回帶 Retry-After 的 429。
規範與機器可讀檔案
/api/openapi.jsonOpenAPI 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 資料集取自遊戲檔案的名稱、圖片、稀有度與收藏系列）和市場價格屬於第三方資料。本站不對其宣告授權，適用原始來源的條款。
如何引用
請按「Skinory — 頁面標題，URL，更新日期」的格式引用頁面，使用規範 URL 和頁面顯示的日期，沒有則寫閱讀日期。引用價格時請註明幣種和時間：價格會變動。
Skinory — AK-47 | Redline, https://skinory.io/zh-Hant/items/ak-47-redline, 2026-10-10