開発者向け公開API
CS2アイテムの価格、Steamインベントリの査定、プロチームと選手の情報を返す無料の読み取り専用JSON APIです。キーも登録もなしで使え、CORSは開放、価格は米ドルでおよそ1時間ごとに更新されます。プロフィールで作成できる無料キーを使うと制限が上がります。
エンドポイント
この表は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を含むので、その時間だけ待って1回だけ再試行してください。
APIキーで制限を引き上げる
すべてのエンドポイントはキーなしで使えます。無料の個人用キーがあれば、制限はIPアドレスではなくキーごとに数えられて上限も上がり、/api/v1/inventoryは503を返す代わりに新しい査定を最大25秒待ちます。
| 制限 | キーなし | キーあり |
|---|---|---|
| 毎分リクエスト数 | 120 | 600 |
| 毎時インベントリ査定数 | 60 | 300 |
| 未査定プロフィールの毎分照会数 | 毎時の制限に含む | 30 |
| /api/ | 50 | 200 |
キーの入手方法
- Steamでログインし、プロフィールの「APIキー」欄を開きます。 プロフィールへ
- キーは作成から1日以上経ったアカウントで利用できます。有効なキーは最大3個まで持てて、それぞれに用途を示す名前を付けます。
- キーが表示されるのは作成時の1回だけで、保存するのはハッシュのみです。紛失・漏洩したキーはワンクリックで無効化し、新しいキーに置き換えられます。
キーの送り方
キーはAuthorizationヘッダー(Bearerスキーム)またはX-Api-Keyヘッダーで送ります。キーが読まれるのは/api/v1だけです。ブラウザで動くコードや公開リポジトリには入れないでください。
curl -H "Authorization: Bearer $CS2C_KEY" \
"https://skinory.io/api/v1/price?q=AK-47%20%7C%20Redline"
curl -H "X-Api-Key: $CS2C_KEY" \
"https://skinory.io/api/v1/inventory?steam=76561197960287930" レスポンスヘッダーとエラー
- X-RateLimit-Limit
- このキーに許可された毎分リクエスト数
- X-RateLimit-Remaining
- 現在のウィンドウで残っているリクエスト数
- X-RateLimit-Reset
- ウィンドウがリセットされるまでの秒数
打ち間違えたキー、不明なキー、無効化されたキーは無視されません。匿名の制限に切り替わるのではなく、WWW-Authenticate付きの401が返ります。BANされたアカウントのキーには403が返ります。制限を超えるとRetry-After付きの429が返ります。
仕様と機械可読ファイル
/api/openapi.jsonOpenAPI 3.1仕様:パラメータ、レスポンススキーマ、エラー/.well-known/openapi.json同じ仕様をwell-knownアドレスで提供/llms.txtAIアシスタント向けのサイト概要(URLパターンとAPIレシピ)/llms-full.txt英語のテキストガイドをすべて1つのMarkdownファイルに収録/llms-catalog.txt出品時価総額の上位500スキンをJSON Linesで提供、1時間ごとに更新/.well-known/ai-catalog.jsonAIエージェント向けの機能マニフェスト- 方法論 価格の出どころと計算方法
ライセンス
ガイド、編集記事、サイト独自の派生データ(ドロッププールの推定、ケースの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/ja/items/ak-47-redline, 2026-09-27