API Docs
JSON API and MCP server for Counter-Strike 2 esports data: Valve rankings, tournaments, teams, matches, players and news.
Authentication
Create a personal key on your account page and send it as a bearer token. Keys are free, limited to 120 requests per minute, and can be revoked at any time. Responses are JSON and every entity carries a url back to its page here.
curl https://viewyourteam.com/api/v1/rankings?region=europe \
-H "Authorization: Bearer vyt_your_key_here"Endpoints
/api/v1/rankings?region=Latest Valve world ranking. region defaults to global; pass europe, americas, asia, oceania for a regional table.
/api/v1/tournaments?status=&tier=Tournament list, filterable by status (upcoming, ongoing, completed, cancelled) and tier (S, A, B).
/api/v1/tournaments/{slug}One tournament with teams, every match and score, prize distribution, venues and linked qualifiers.
/api/v1/teams/{slug}Team profile: ranking, active roster, upcoming matches, recent results, ranking history and placements.
/api/v1/matches?status=&date=&team=&tournament=Matches. No filters returns live and upcoming. date is a UTC day (YYYY-MM-DD); team and tournament take slugs.
/api/v1/matches/{slug}Match detail with per-map rounds and halves, and the veto.
/api/v1/players/{slug}Player profile with career stats and team history.
/api/v1/news?category=Latest published articles without body text.
/api/v1/news/{slug}One article including its Markdown body.
/api/v1/search?q=Find teams, tournaments, players and organizations by name. Use it to turn a name into a slug.
List endpoints accept limit. Errors come back as { "error": "..." } with 400, 401, 404 or 429.
MCP server
The same data is available to AI agents as tools over the Model Context Protocol at https://viewyourteam.com/mcp (Streamable HTTP). Use the same key. Tools: get_rankings, list_tournaments, get_tournament, get_team, list_matches, get_match, get_player, list_news, get_article and search.
{
"mcpServers": {
"viewyourteam": {
"url": "https://viewyourteam.com/mcp",
"headers": { "Authorization": "Bearer vyt_your_key_here" }
}
}
}Machine-readable
The full OpenAPI 3.1 description is at /openapi.json, and an RFC 9727 API catalog is served at /.well-known/api-catalog. Any page on the site also returns Markdown when requested with Accept: text/markdown.
Terms
Data may be shown to users and used as input for real-time answers with attribution to ViewYourTeam. It may not be used to train AI models. This matches the site's published content signal (ai-train=no, search=yes, ai-input=yes). The three older unauthenticated endpoints listed in the spec under Legacy remain available for existing integrations.