---
title: "SofaScore past winners of a competition"
method: GET
path: "/sofascore/tournament-winners"
tags: ["SofaScore"]
---

# SofaScore past winners of a competition

`GET /sofascore/tournament-winners`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/sofascore/tournament-winners`
- Auth: API key in header `x-api-key`

Returns one page (10 seasons, newest first) of a competition's past winners: the year, the season id and the winning team or player. Follow `has_next_page` and pass `page` (zero-based) for older seasons; a page past the last one and an unknown competition both answer 404. Get `id` from search; the returned `season_id` works with every season-scoped endpoint.

## Query parameters

- `id` string, required
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentWinnersResponseDoc
  - `code` integer
  - `data` SofascoreTournamentWinnersResponse
    - `count` integer
    - `fetched_at` string
    - `has_next_page` boolean
    - `page` integer
    - `source_url` string
    - `tournament_id` integer
    - `winners` SofascoreTournamentWinner[]
      - `season_id` integer: SeasonID is the season id to pass to tournament-seasons-based endpoints.
      - `winner` SofascoreTeamRef
        - `country` string: Country the team belongs to.
        - `id` integer: SofaScore team id. Use it with the team endpoints.
        - `name` string: Full team name.
        - `national` boolean: True for a national team.
        - `short_name` string: Shortened team name.
        - `slug` string: URL slug of the team on SofaScore.
      - `year` integer: Year is the upstream year label of the season (the year it ended).
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)