---
title: "SofaScore season top teams"
method: GET
path: "/sofascore/tournament-top-teams"
tags: ["SofaScore"]
---

# SofaScore season top teams

`GET /sofascore/tournament-top-teams`

## Request

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

Returns a competition season's top teams for every team statistic category SofaScore ranks (for football about 30 categories such as average rating, goals scored, possession, shots and clean sheets; for basketball points, pace, ratings and more), each with the ranked teams and the value. The category set depends on the sport and competition, so the response lists every category it holds. The `type` enum accepts `overall`, `regular_season` and `playoffs`: football competitions publish `overall`, the NBA publishes `regular_season`, and a type the competition does not publish answers 404. Optional `limit` caps the rows per category (up to 50). Get `id` from search and `season` from tournament-seasons.

## Query parameters

- `id` string, required
- `season` string, required
- `type` 'overall' | 'regular_season' | 'playoffs'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTournamentTopTeamsResponseDoc
  - `code` integer
  - `data` SofascoreTournamentTopTeamsResponse
    - `categories` SofascoreTopTeamCategory[]
      - `count` integer
      - `key` string
      - `teams` SofascoreTopTeamEntry[]
        - `details` object
        - `matches` integer
        - `rank` integer
        - `team` 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.
        - `value` number
    - `category_count` integer
    - `fetched_at` string
    - `season_id` integer
    - `source_url` string
    - `sport` string
    - `tournament_id` integer
    - `type` string
  - `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)