---
title: "Search broadcasts"
method: GET
path: "/api/broadcast/search"
tags: ["Broadcasts"]
---

# Search broadcasts

`GET /api/broadcast/search`

Search across recent official broadcasts.

## Query parameters

- `page` integer
- `q` string

## Response `200`

Paginated top broadcast previews.

- object
  - `currentPage` integer, required
  - `maxPerPage` integer, required
  - `currentPageResults` BroadcastWithLastRound[], required
    - `group` string
    - `tour` BroadcastTour
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `dates` integer[] — Start and end dates of the tournament, as Unix timestamps in milliseconds
      - `info` BroadcastTourInfo — Additional display information about the tournament
        - `format` string — Tournament format. Example: `"8-player round-robin" or "5-round Swiss"`
        - `tc` string — Time control. Example: `"Classical" or "Rapid" or "Rapid & Blitz"`
        - `fideTC` 'standard' | 'rapid' | 'blitz' — FIDE rating category
        - `timeZone` string — Timezone of the tournament. Example: `America/New_York`. See [list of possible timezone identifiers](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) for more.
        - `location` string — Tournament location
        - `players` string — Mentioning up to 4 of the best players participating.
        - `website` string, uri — Official website. External website URL
        - `standings` string, uri — Official standings website. External website URL, e.g. chess-results.com, info64.org
        - `regulations` string, uri — External URL to the official tournament regulations.
      - `tier` integer — Used to designate featured tournaments on Lichess
      - `image` string, uri
      - `description` string — Full tournament description in markdown format, or in HTML if the html=1 query parameter is set.
      - `teamTable` boolean
      - `showTeamScores` boolean
      - `url` string, uri, required
      - `communityOwner` LightUser
        - `id` string, required
        - `name` string, required
        - `flair` string — See [available flair list and images](https://github.com/lichess-org/lila/tree/master/public/flair)
        - `title` 'GM' | 'WGM' | 'IM' | 'WIM' | 'FM' | 'WFM' | 'NM' | 'CM' | 'WCM' | 'WNM' | 'LM' | 'BOT' — only appears if the user is a titled player or a bot user
        - `patron` boolean — Use patronColor value instead to determine if player is a patron.
        - `patronColor` integer — Players can choose a color for their Patron wings. See [here for the color mappings](https://github.com/lichess-org/lila/blob/master/ui/lib/css/abstract/_patron-colors.scss). The presence of this field indicates the player is an active Patron.
    - `round` BroadcastRoundInfo
      - `id` string, required
      - `name` string, required
      - `slug` string, required
      - `createdAt` integer, required
      - `rated` boolean, required — Whether the round is used for rating calculations
      - `ongoing` boolean
      - `startsAt` integer
      - `startsAfterPrevious` boolean — The start date/time is unknown and the round will start automatically when the previous round completes
      - `finishedAt` integer
      - `finished` boolean
      - `url` string, uri, required
      - `delay` integer
      - `customScoring` BroadcastCustomScoring — Scoring overrides for wins or draws.
        - `white` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
        - `black` BroadcastCustomPointsPerColor, required
          - `win` number, required
          - `draw` number, required
  - `previousPage` integer, nullable, required
  - `nextPage` integer, nullable, required

---

[API](https://skmtc.net/lichess/apis/lichess-org-api-reference.md) · [All operations](https://skmtc.net/lichess/apis/lichess-org-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lichess/lichess-org-api-reference/versions/1425db81eb3b/schema)