Rankings

Retrieve and search all-time and current-season club leaderboards.

EA’s Pro Clubs API is public but undocumented and can change without notice. It does not require authentication. Keep requests low volume, never send credentials or cookies, and do not include sensitive data in club names or other request inputs.

rankings.allTime

Get the all-time club leaderboard.

import { ProClubsClient } from 'proclubs-sdk'

const proclubs = new ProClubsClient()
const entries = await proclubs.rankings.allTime()

platform · Platform

Optional per-request platform override.

result · Promise<RankingEntry[]>

All-time leaderboard entries in EA response order. Known fields include rank, clubId, clubName, platform, skillRating, reputationtier, reputationlevel, bestDivision, bestFinishGroup, wins, ties, losses, gamesPlayed, goals, goalsAgainst, cleanSheets, goalsPerGame, goalsAgainstPerGame, and nested clubInfo (with customKit). Ranking-only fields can be absent on a valid row.

rankings.searchAllTime

Search the all-time leaderboard by club name.

import { ProClubsClient } from 'proclubs-sdk'

const proclubs = new ProClubsClient()
const entries = await proclubs.rankings.searchAllTime({
  name: 'HEMLE FC',
  platform: 'common-gen5',
})

name · string · required

Club name, trimmed by the SDK. Must contain from 1 through 32 characters.

platform · Platform

Optional per-request platform override.

result · Promise<RankingEntry[]>

Matching all-time entries. An empty search returns [].

rankings.currentSeason

Get the current-season club leaderboard.

import { ProClubsClient } from 'proclubs-sdk'

const proclubs = new ProClubsClient()
const entries = await proclubs.rankings.currentSeason({
  platform: 'common-gen5',
})

platform · Platform

Optional per-request platform override.

result · Promise<RankingEntry[]>

Current-season leaderboard entries in EA response order. Known fields match the all-time board, with currentDivision as the season standing. Goal averages can be absent on a valid row.

rankings.searchCurrentSeason

Search the current-season leaderboard by club name.

import { ProClubsClient } from 'proclubs-sdk'

const proclubs = new ProClubsClient()
const entries = await proclubs.rankings.searchCurrentSeason({
  name: 'HEMLE FC',
})

name · string · required

Club name, trimmed by the SDK. Must contain from 1 through 32 characters.

platform · Platform

Optional per-request platform override.

result · Promise<RankingEntry[]>

Matching current-season entries. An empty search returns [].

Result shape

RankingEntry includes the ClubSummary fields without changing ClubSummary. Ranking entries may also include rank, skillRating, reputationlevel, bestFinishGroup, goalsPerGame, and goalsAgainstPerGame. Search results can omit the ranking-only fields. Nested clubInfo includes regionLabel when EA returns a known regionId.

Full leaderboard methods preserve EA response order. The routes do not provide server pagination, and the SDK does not sort or paginate the response. Numeric statistics can arrive as strings, numbers, or null. The SDK preserves numeric strings as strings.

clubs.search remains the 0.x club search helper. It returns Promise<ClubSummary[]> and keeps its existing endpoint identity.