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

GET/api/v1/rankings?region=

Latest Valve world ranking. region defaults to global; pass europe, americas, asia, oceania for a regional table.

GET/api/v1/tournaments?status=&tier=

Tournament list, filterable by status (upcoming, ongoing, completed, cancelled) and tier (S, A, B).

GET/api/v1/tournaments/{slug}

One tournament with teams, every match and score, prize distribution, venues and linked qualifiers.

GET/api/v1/teams/{slug}

Team profile: ranking, active roster, upcoming matches, recent results, ranking history and placements.

GET/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.

GET/api/v1/matches/{slug}

Match detail with per-map rounds and halves, and the veto.

GET/api/v1/players/{slug}

Player profile with career stats and team history.

GET/api/v1/news?category=

Latest published articles without body text.

GET/api/v1/news/{slug}

One article including its Markdown body.

GET/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.