Skip to main content

Get Official Broadcasts

Retrieve the list of official ongoing and recent broadcast tournaments.

Endpoint

Query Parameters

integer
default:"20"
Maximum number of broadcasts to return (max: 100)

Response

Returns a stream of broadcast tournaments in NDJSON format. Each line contains a broadcast object.
object
The broadcast tournament information
object
The current or most recent round
object
Group information if the tournament belongs to a group

Get Top Broadcasts

Get paginated list of top broadcast tournaments.

Endpoint

Query Parameters

integer
default:"1"
Page number for pagination (max: 20)

Response

array
Array of currently active broadcasts, sorted by tier
object
Paginated list of past broadcasts

Search Broadcasts

Search for broadcast tournaments by query string.

Endpoint

Query Parameters

string
required
Search query (max 100 characters)
integer
default:"1"
Page number for pagination (max: 20)

Response

Returns a paginated object with matching broadcasts (same structure as /top endpoint’s past property).

Get Broadcast by User

Get broadcasts created by a specific user.

Endpoint

Path Parameters

string
required
Lichess username

Query Parameters

integer
default:"1"
Page number for pagination (max: 20)

Response

Returns a paginated object with broadcasts created by the specified user.

Get Broadcast Tournament

Get detailed information about a specific broadcast tournament, including all rounds.

Endpoint

Path Parameters

string
required
The broadcast tournament ID (8 characters)

Query Parameters

boolean
default:"false"
Return description as HTML instead of markdown

Response

object
Complete tournament information including description and settings
array
Array of all rounds in the tournament with full details
object
Group information if applicable
object
Player photos keyed by player name
string
ID of the default round to display

Authentication

  • Public broadcasts: No authentication required
  • Private broadcasts: Requires OAuth token with study:read scope
Private broadcasts will return a 401 error if accessed without proper authentication.

Export Tournament PGN

Download all games from a broadcast tournament as PGN.

Endpoint

Path Parameters

string
required
The broadcast tournament ID (8 characters)

Response

Returns PGN data for all games in the tournament as application/x-chess-pgn.
Rate limits apply. The download is streamed to handle large tournaments efficiently.