Get Official Broadcasts
Retrieve the list of official ongoing and recent broadcast tournaments.Endpoint
Query Parameters
Maximum number of broadcasts to return (max: 100)
Response
Returns a stream of broadcast tournaments in NDJSON format. Each line contains a broadcast object.The broadcast tournament information
The current or most recent round
Group information if the tournament belongs to a group
Get Top Broadcasts
Get paginated list of top broadcast tournaments.Endpoint
Query Parameters
Page number for pagination (max: 20)
Response
Array of currently active broadcasts, sorted by tier
Paginated list of past broadcasts
Search Broadcasts
Search for broadcast tournaments by query string.Endpoint
Query Parameters
Search query (max 100 characters)
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
Lichess username
Query Parameters
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
The broadcast tournament ID (8 characters)
Query Parameters
Return description as HTML instead of markdown
Response
Complete tournament information including description and settings
Array of all rounds in the tournament with full details
Group information if applicable
Player photos keyed by player name
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
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.