LoL team API

Team profiles, logos, rosters, matches, and stats for LoL apps.

Fetch the team page data developers need: name, logo, region, leagues, roster, recent matches, objective rates, achievements, and earnings where tracked.

Team metadata
Org logos
League membership
Team stats
Most Likely Picks
Role14-Game TrendPick Chance
AzirAzir
MID
78%
KalistaKalista
BOT
71%
NautilusNautilus
SUP
64%
RellRell
SUP
57%
Lee SinLee Sin
JNG
50%

Primary endpoint: /api/v1/lol/teams/{slug}

Fetch the team page data developers need: name, logo, region, leagues, roster, recent matches, objective rates, achievements, and earnings where tracked.

Team metadataOrg logosLeague membershipTeam stats

Live webhooks

Push LoL gold swings, objectives, kills, towers, and match state into your product.

Riot workflows are strongest after official data is published. Cito is built for product teams that need near-live monitoring during active coverage, then clean post-game reconciliation when final data lands.

Seconds to tens of seconds during active coverage
Unique event IDs for dedupe
Signed delivery headers
Retry attempts with delivery metadata

Example payload

Gold swing webhook

signed
POST /your-webhook
X-Cito-Event: lol.live.gold_swing
X-Cito-Event-Id: 1c11131a-2d74-4b06-b4be-ec873861854b
X-Cito-Delivery-Attempt: 1
X-Cito-Signature: sha256...

{
  "event": "lol.live.gold_swing",
  "id": "1c11131a-2d74-4b06-b4be-ec873861854b",
  "data": {
    "league": "LCS",
    "gameTime": 1716,
    "source": "vision",
    "previousGoldDiff": -1900,
    "goldDiff": -3300,
    "swing": -1400,
    "leadingSide": "red"
  }
}
lol.live.state

Periodic live state snapshot with game time, gold, kills, towers, dragons, Barons, and team IDs.

lol.live.gold_swing

Emitted when the gold lead changes materially or flips side.

lol.live.objective

Objective updates for Dragons, Baron, inhibitors, and tracked objective totals.

lol.live.kill_update

Kill total deltas so bots and dashboards can react without parsing the full state.

lol.live.tower_destroyed

Tower count deltas for match centers, alerts, and momentum panels.

lol.match.completed

Final match state so your app can reconcile live screens with post-game data.

1

Choose LoL on One Game Starter

Use One Game Starter when the product is League of Legends-only. It includes commercial use and LoL webhook access without paying for every game.

2

Create the webhook

Add your endpoint in the dashboard and subscribe to the exact LoL events your product needs.

3

Filter the stream

Use filters such as league, matchId, gameId, or side so your backend receives the updates it actually cares about.

4

Verify and dedupe

Use X-Cito-Signature to verify payloads and X-Cito-Event-Id as your idempotency key. Failed deliveries retry up to 3 times.

Endpoint chain

Start with /api/v1/lol/teams/{slug}, then add the supporting rows your screen needs.

The first request should answer the user's main question. Add live state, roster rows, match stats, transfer history, or earnings only when the UI needs that detail.

GET
/api/v1/lol/teams/{slug}

Team profile data for org pages and match centers.

Team profile

/api/v1/lol/teams/{slug}

Use this first when the page needs team profile data for org pages and match centers.

Team match history

/api/v1/lol/teams/{slug}/matches

Team match history fills in the detail around the primary response.

Objective rates

/api/v1/lol/teams/{slug}/objectives

Objective rates fills in the detail around the primary response.

Returned data

Fetch the team page data developers need: name, logo, region, leagues, roster, recent matches, objective rates, achievements, and earnings where tracked.

Best first request

Call /api/v1/lol/teams/{slug} from your backend and cache the response based on how often that screen changes.

Common fallback

If live data is empty, show today's schedule, upcoming matches, recent results, or the last known team/player rows.

API key handling

Keep the API key on your server. Send your frontend only the fields it needs to render the page.

Data fit

Use this API for pro matches, teams, players, rosters, stats, and esports history.

If you need Riot ID, PUUID, ranked ladder, champion mastery, or account-linked match history, use Riot's APIs. If you need a pro esports app, use Cito's LoL endpoints.

Pro Esports API

Built for match centers, fantasy products, scouting tools, wikis, dashboards, team pages, player pages, and live bots.

Live matches and schedules
Pick/ban and game stats where published
Tournament brackets and standings
Player earnings and org history
Transfer tracking
Roster history

Ranked and Ladder Workflows

Use Riot APIs for direct Riot ID, PUUID, summoner, match history, ranked ladder, champion mastery, and account-linked workflows. Cito only references public pro-player account context where source data allows it.

Resources

Docs, examples, and machine-readable endpoint files.

Open the docs when you want examples. Import Postman when you want to test. Use the endpoint manifest when an AI coding tool needs exact paths.

FeatureCito APIRiot APIPandaScore
PriceFree testing, Starter $25/mo, Builder $50/moFree, rate limited; production approval variesUsually sales/custom pricing
Ranked account dataNot the primary product; use Riot for direct account workflowsYesNot the core LoL ranked source
Pro esports liveYesFragmented across official surfacesYes
Player earningsYesNoProvider-dependent
Org/transfer historyYesCurrent GCD affiliation/contract data, not full historyProvider-dependent
Unified REST APIYesMultiple products and routing modelsYes
Instant signupYesDeveloper key yes; production can require approvalOften sales-led

Riot's API is free but fragmented. PandaScore is enterprise-only. Cito is the only self-serve option with earnings and org history.

Endpoints

Endpoint paths for this workflow.

Start with /api/v1/lol/teams/{slug}. Add supporting endpoints only when your page needs more context.

GET
/api/v1/lol/players/{playerId}/earnings

Career prize pool earnings with tournament-by-tournament rows.

GET
/api/v1/lol/players/{playerId}/earnings/summary

Player earnings totals, event counts, placements, and tracked history.

GET
/api/v1/lol/players/{playerId}/teams

Team history for org changes, roles, and date ranges.

GET
/api/v1/lol/teams/{slug}/roster/history

Historical rosters with roster membership periods.

GET
/api/v1/lol/transfers

Recent transfer activity across tracked LoL teams and players.

GET
/api/v1/lol/teams/{slug}/earnings

Organization-level earnings and tournament results where tracked.

GET
/api/v1/lol/live

Active League of Legends esports matches and live state.

GET
/api/v1/lol/schedule/today

Today's LoL esports schedule for match-day apps.

GET
/api/v1/lol/games/{gameId}/stats

Game-level player stats after source publication.

GET
/api/v1/lol/analytics/drafts/{matchId}

Champion picks, bans, player roles, and side context.

GET
/api/v1/lol/live/{gameId}/visual-state

Live gold, score, objective, and game-time reads where available.

GET
/api/v1/lol/games/{gameId}/timeline

Timeline events, objective timings, and gold snapshots where available.

GET
/api/v1/lol/players/{playerId}/form

Sliding-window player performance over recent matches.

GET
/api/v1/lol/players/{playerId}/champion-pool

Champion picks and win rates over the requested match window.

GET
/api/v1/lol/matches/{matchId}/media

Live stream and replay links where available.

GET
/api/v1/lol/webhooks/events

Supported LoL webhook events for paid plans.

Use cases

Built for League of Legends apps developers actually launch.

Team profile pages

Show logo, region, leagues, roster, recent matches, objective rates, and achievements.

Org directories

Build searchable directories with team names, short names, logos, regions, and active status.

Fantasy team pages

Show recent form, upcoming schedule, roster context, and objective rates for each team.

Scouting dashboards

Compare teams by match history, objective control, champion pool, and roster movement.

Wiki pages

Populate team, player, roster, match, tournament, and earnings pages from structured endpoints.

Match center team cards

Show each side's logo, roster, league, recent matches, and current series context.

One team slug, one profile

Use the team slug to load logo, region, short name, current roster, league context, recent matches, objective rates, earnings, and achievements.

Aliases resolve cleanly

Common org aliases resolve to the current team record, so old slugs do not create duplicate team pages in your app.