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

# SofaScore rankings

`GET /sofascore/rankings`

## Request

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

Returns one SofaScore ranking list: the rank, previous rank, points and the ranked team, player or competition, plus when the list was last updated. Choose the `type` id from sofascore-ranking-types, for example 5 for the ATP men's singles ranking or 2 for the FIFA men's national team ranking. Optional `limit` returns only the first rows of long lists (tennis lists hold 500 rows). MMA division rankings use rank 0 for the reigning champion.

## Query parameters

- `type` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 34 | 35 | 36 | 37 | 40 | 41 | 42 | 43 | 44 | 45 | 46, required
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SofascoreRankingsResponseDoc
  - `code` integer
  - `data` SofascoreRankingsResponse
    - `count` integer
    - `entity_type` string
    - `fetched_at` string
    - `name` string
    - `rankings` SofascoreRankingRow[]
      - `best_rank` integer
      - `entity` SofascoreRankingEntity
        - `country` string
        - `country_code` string
        - `gender` string
        - `id` integer
        - `name` string
        - `national` boolean
        - `record` SofascoreWDLRecord
          - `draws` integer
          - `losses` integer
          - `wins` integer
        - `short_name` string
        - `slug` string
        - `sport` string
        - `type` string
      - `label` string
      - `max_points` number
      - `next_win_points` number
      - `playing_teams` integer
      - `points` number
      - `previous_points` number
      - `previous_rank` integer
      - `rank` integer
      - `total_teams` integer
      - `tournaments_played` integer
      - `year` string
    - `source_url` string
    - `sport` string
    - `total_rows` integer
    - `type` integer
    - `updated_at` string
    - `updated_timestamp` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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/0497899e2016?raw)