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:readscope
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 asapplication/x-chess-pgn.
Rate limits apply. The download is streamed to handle large tournaments efficiently.

