Superclub

External API Integrations

Documentation for third-party services used by the platform.

⚠️This application uses a hybrid of the Open API (v4) and internal Web APIs. Internal APIs are used when v4 lacks specific data (e.g. detailed rosters, specific league standings).
Base URLs: open.faceit.com/data/v4 vs www.faceit.com/api

Core & Search

GET
Global Search
/api/searcher/v1/all
Internal

Global search for players, teams, and championships.

Player Data

GET
Player Profile
/data/v4/players/{playerId}
v4 Public

Core player profile data (ELO, avatar, country).

GET
Nickname Lookup
/data/v4/players
v4 Public

Look up player by nickname query param.

GET
Game Stats
/data/v4/players/{playerId}/stats/{game}
v4 Public

Lifetime stats and segment history (maps, recent matches) for a game.

Team Data

GET
Team Profile
/data/v4/teams/{teamId}
v4 Public

Standard team profile.

GET
Team Roster
/data/v4/teams/{teamId}/members
v4 Public

List of team members.

GET
Team Details (Internal)
/api/teams/v1/teams/{teamId}
Internal

Internal team details (used for lightweight lookups).

Leagues & Championships (ESEA/Hubs)

GET
League History (Crucial)
/api/team-leagues/v1/teams/{teamId}/profile/leagues/summary
Crucial

Full history of team's league participation (ESEA seasons). Determining placement and history.

GET
Active League (Crucial)
/api/team-leagues/v1/teams/{teamId}/profile/leagues/current
Crucial

Current active league registration for a team. Used to verify active status.

GET
Championship Matches
/api/championships/v1/matches
Internal

Fetch matches for a specific team inside a championship context.

GET
Event Details
/data/v4/championships/{eventSlug}
v4 Public

Public championship details.

GET
Hub Seasons
/api/leaderboard/v1/leaderboard/source/hub/{hubId}/all
Internal

Get all seasons for a hub (used to find current ongoing season).

GET
Season Rankings
/api/leaderboard/v2/ranking/{seasonId}
Internal

Specific leaderboard rankings for a season.

Matches & Statistics

GET
Full Match Details
/api/match/v2/match/{matchId}
Detailed

Full match details including voting, map entities, and detailed rosters.

GET
Advanced Stats
/api/stats/v3/matches/{matchId}
Internal v3

Detailed match statistics (kills, deaths, adr). Richer than public API.

GET
Public Stats Fallback
/data/v4/matches/{matchId}/stats
v4 Public

Fallback for stats if v3 fails.

Base URL:https://liquipedia.net/counterstrike/api.php

GET
Search
?action=query&list=search
Liquipedia

Search for wiki pages (players, teams, tournaments).

Params:srsearch={query}|format=json
GET
Content Parse
?action=parse
Liquipedia

Fetch structured data (transcluded wikitext) from a page.

Params:page={title}|prop=wikitext