`topchampionships` Method — Top Championships

Purpose

The topchampionships method returns a list of the most popular championships — up to 12 — for Live or Prematch. For example, use it for a “Popular tournaments” block on the home page or for quick links in the menu.

Each championship comes with its ID, name, sport, country, and the number of available matches. The matches of the selected championship are then requested with the events method by tournament_id.

How the List Is Built

Line type	What is included
`line` (Prematch)	The bookmaker’s main championships: Champions League, top European leagues, NBA, NHL, and so on — in order of popularity. Only championships that currently have matches in the line are returned
`live`	Championships with matches in progress right now — the most popular first (top leagues); with equal popularity, championships with more matches come first

The Live list changes during the day: it contains only what is being played right now. At night it may therefore include less-known tournaments — the most popular of those in progress.

Esports are not included. If the API key opens only some sports, the list is built within them.

Request

GET https://YOUR_API_DOMAIN/v1/topchampionships/{type}/{lang}

Pass the API key in the HTTP header:

Package: YOUR_API_KEY

Path Parameters

Parameter	Type	Required	Description
`type`	string	yes	Line type: `live` or `line`. Any other value returns an empty list
`lang`	string	yes	Language of names. The language must be supported by the API and included in the client’s plan

Request Example

curl --request GET \
  --url 'https://YOUR_API_DOMAIN/v1/topchampionships/line/en' \
  --header 'Package: YOUR_API_KEY'

Response Example

A Prematch response for a key with basketball and baseball:

{
  "status": 1,
  "page": "/v1/topchampionships",
  "body": [
    {
      "position": 1,
      "tournament_id": 166775,
      "tournament_name": "USA. MLB",
      "sport_id": 5,
      "sport_name": "Baseball",
      "country_id": 153,
      "country_name": "United States",
      "counter": 4
    },
    {
      "position": 2,
      "tournament_id": 13589,
      "tournament_name": "NBA",
      "sport_id": 3,
      "sport_name": "Basketball",
      "country_id": 153,
      "country_name": "United States",
      "counter": 41
    }
  ]
}

Response Fields

Top Level

Field	Type	Description
`status`	number	`1` — a successful response
`page`	string	Technical method address: `/v1/topchampionships`
`body`	array	Championships in order of popularity. May be empty

Championship Object

Field	Type	Description
`position`	number	Place in the list: `1`, `2`, …
`tournament_id`	number	Championship ID. Used as `tournamentId` in `events`
`tournament_name`	string	Championship name in the `lang` language
`sport_id`	number	Sport ID
`sport_name`	string	Sport name in the `lang` language
`country_id`	number	Country or region ID
`country_name`	string	Country or region name in the `lang` language
`counter`	number	Number of matches of the championship: in Prematch — in the whole line, in Live — in progress now

What to Do with the Returned `tournament_id`

Get the championship’s matches with events for the same line type:

GET https://YOUR_API_DOMAIN/v1/events/{sport_id}/{tournament_id}/sub/50/{type}/{lang}

For example, all Prematch NBA matches from the example above:

GET https://YOUR_API_DOMAIN/v1/events/3/13589/sub/50/line/en

Icons

Championship, sport, and country icons are the standard SportAPI icons by ID from the response:

https://cdn.sportapi.net/tournaments/v1/color/{tournament_id}.webp
https://cdn.sportapi.net/sports/v1/color/{sport_id}.webp
https://cdn.sportapi.net/flags/v1/color/{country_id}.webp

See SportAPI Icons and Media Files for details.

Difference from `topmatches` and `toplist`

Method	Returns
`topchampionships`	Popular championships (without matches)
`topmatches`	Popular Live or Prematch matches of all sports
`toplist`	Popular Prematch matches of one sport

Update Frequency

The Prematch list changes rarely — requesting it once every 5–10 minutes is enough. The Live list follows the matches in progress — once every 1–2 minutes.

topchampionships Method — Top Championships