Esports Match
Search API

25,727件超のプロマッチデータを、チーム・プレイヤー・エージェント・マップ・ラウンドなど あらゆる条件で高速に検索できるAPIです。

25,727
総マッチ数
25,727
詳細データ付き
< 50ms
典型レスポンス
REST / JSON
フォーマット

認証

すべてのリクエストに X-API-Key ヘッダーを付与してください。 できます。 

# すべてのリクエストにヘッダーを付与 curl https://valo.town/api/open-api/v1/matches \ -H "X-API-Key: YOUR_API_KEY"
ベースURL
https://valo.town/api/open-api
レート制限
60 リクエスト/分
フォーマット
JSON / UTF-8

エンドポイント

GET /v1/matches

様々な条件でマッチを検索します。複数パラメータはAND条件で絞り込まれます。

パラメータ 型 説明
team string 部分一致。team1 / team2 両方を同時に検索
player string プレイヤー名（完全一致）
agent string エージェント名（例: ジェット）
map string マップ名（例: アセント）
event string イベント名（部分一致）
series string シリーズ名（部分一致）
status string 試合状態（試合終了 / 今後の試合 / 対戦中）
winner string 勝利チーム名（部分一致）
patch string パッチバージョン（例: Patch 11.0）
date_from int 開始日時 — Unixタイムスタンプ
date_to int 終了日時 — Unixタイムスタンプ
limit int 取得件数（デフォルト 20、最大 100）
offset int ページオフセット（デフォルト 0）
sort string date_desc（新しい順）/ date_asc
GET /v1/matches/{match_id}
GET /v1/stats
GET /v1/health

レスポンス形式

200成功
{ "success": true, "data": [ /* マッチ配列 */ ], "pagination": { "total": 342, "limit": 20, "offset": 0 }, "took_ms": 12 }
4xxエラー
{ "success": false, "error": "Invalid or inactive API key.", "code": 401 } — 主なコード — 200 OK 401 Unauthorized 429 Rate Limit 500 Internal Error

コード例

# チーム名で検索 curl "https://valo.town/api/open-api/v1/matches?team=ZETA&limit=10" \ -H "X-API-Key: YOUR_API_KEY" # エージェント + マップの複合検索 curl "https://valo.town/api/open-api/v1/matches?agent=ジェット&map=アセント" \ -H "X-API-Key: YOUR_API_KEY" # マッチ詳細 curl "https://valo.town/api/open-api/v1/matches/226950" \ -H "X-API-Key: YOUR_API_KEY"

matchData 構造

{ "teams": { "team1": { "name": "ZETA DIVISION", "overall_score": 2 } }, "event_datas": { "event_name": "VCT 2025: Pacific Stage 1", "patch_version": "Patch 10.0", "map_actions": [{ "action": "ban"/"pick", "map": "…" }] }, "maps": [{ "map_name": "アセント", "duration": "38:20", "winner": "ZETA DIVISION", "team1": { "score": 13, "score_t": 5, "score_ct": 8 }, "players": [{ "name": "Laz", "agents": [{ "name": "ジェット" }], "stats": [{ "all": { "ACS": "285", "K": "22", "D": "12", "KAST": "78%" } }] }], "rounds": [{ "round_number": "1", "win_condition": "elim", "winner": "…" }] }] }