---
title: "SofaScore team rankings"
method: GET
path: "/sofascore/team-rankings"
tags: ["SofaScore"]
---

# SofaScore team rankings

`GET /sofascore/team-rankings`

## Request

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

Returns every ranking a team or tennis player appears in: for a tennis player the ATP or WTA ranking, its live version and the UTR rating, for a football club the UEFA club coefficient by year. Each ranking carries its `type_id` (the same ids the rankings endpoint takes), name, sport, category and last update, and `rows` with the `position`, `points`, previous and best position where SofaScore reports them. Returns 404 when the id appears in no ranking.

## Query parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreTeamRankingsResponseDoc
  - `code` integer
  - `data` SofascoreTeamRankingsResponse
    - `count` integer
    - `fetched_at` string
    - `rankings` SofascoreTeamRanking[]
      - `category` string
      - `gender` string
      - `last_updated` string
      - `last_updated_timestamp` integer
      - `name` string
      - `rows` SofascoreTeamRankingRow[]
        - `best_position` integer
        - `max_points` number
        - `next_win_points` number
        - `points` number
        - `position` integer
        - `previous_points` number
        - `previous_position` 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.
        - `tournaments_played` integer
        - `updated_at` string
        - `updated_timestamp` integer
        - `year` integer
      - `slug` string
      - `sport` string
      - `type_id` integer
    - `source_url` string
    - `team_id` integer
  - `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/028417aa35bb?raw)