Endpoint Playground

Try the SofaScore rankings API

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.

What a live request returned

14 Oct 2026: 40 rankings; 8 fields had a value in every checked item.

Observed request: GET /sofascore/rankings?limit=40&type=5
Fields with a value in every checked item: rank, previous_rank, best_rank, points, previous_points, tournaments_played, label, entity

Sample value profiles: rank: 1 to 40, median 20; label: “Jannik Sinner” and 39 other values; previous_rank: 1 to 40, median 20.

Request: GET /sofascore/rankings
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.93 s
Monitored request: GET /sofascore/rankings?limit=3&type=5

SofaScore rankings API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/rankings?type=5' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
type	integer	Yes	5	Ranking id from sofascore-ranking-types
limit	integer	No		Return only the first N rows, 1 to 500. Omit to return every row

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": 5,
    "name": "ATP men's singles ranking",
    "sport": "tennis",
    "entity_type": "player",
    "updated_timestamp": 1791327637,
    "updated_at": "2026-10-06T23:00:37Z",
    "total_rows": 500,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/rankings/type/5",
    "fetched_at": "2026-10-07T14:00:00Z",
    "rankings": [
      {
        "rank": 1,
        "previous_rank": 1,
        "best_rank": 1,
        "points": 11000,
        "previous_points": 11000,
        "tournaments_played": 19,
        "label": "Jannik Sinner",
        "entity": {
          "id": 206570,
          "type": "player",
          "name": "Jannik Sinner",
          "short_name": "J. Sinner",
          "slug": "sinner-jannik",
          "sport": "tennis",
          "gender": "M",
          "country": "Italy",
          "country_code": "IT"
        }
      }
    ]
  }
}

More SofaScore endpoints

SofaScore categories for a sport SofaScore competitions in a category SofaScore league draft SofaScore league draft picks SofaScore esports game detail SofaScore event detail SofaScore event at-bat pitches SofaScore event at-bats SofaScore event average positions SofaScore event baseball top performers SofaScore event best players SofaScore event commentary All 109 SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestsofascore.rankingsResponseDocSofaScore

GET /sofascore/rankings

SofaScore rankings

Response behavior

- `rank` is SofaScore's rank. In the MMA division rankings (ids `11` to `22` and `40` to `46`) rank `0` is the reigning champion and ranks 1 to 15 (1 to 10 for Fight Nation Championship) are the ranked contenders. `previous_rank`, `best_rank`, `points`, `previous_points`, `next_win_points`, `max_points` and `tournaments_played` appear only on rankings that publish them; a present `0` is meaningful. - `entity.type` is `team`, `player` or `unique_tournament`. League coefficients (id `1`) rank competitions: `entity` is the league, `label` is the association's country and `year` is the coefficient season. Padel partners share the same rank. MMA rows add the competitor's win/draw/loss `record`. - `points` mean different things per ranking: FIFA/UEFA/rugby points, ATP/WTA points, UTR rating (id `34`, `35`) or padel points. The live tennis rankings (ids `7`, `8`) add `next_win_points` and `max_points`. - `total_rows` is the size of the whole list and `count` the number of rows returned after `limit`. - A list that comes back empty or malformed is treated as an upstream error, not as an empty result. Ranking 4 was last updated in 2016 and ranking 22 holds a single entry (last updated 2024); check `updated_at`. Example response (shortened): ```json { "code": 200, "msg": "OK", "data": { "type": 5, "name": "ATP men's singles ranking", "sport": "tennis", "entity_type": "player", "updated_timestamp": 1791327637, "updated_at": "2026-10-06T23:00:37Z", "total_rows": 500, "count": 1, "source_url": "https://api.sofascore.com/api/v1/rankings/type/5", "fetched_at": "2026-10-07T14:00:00Z", "rankings": [ { "rank": 1, "previous_rank": 1, "best_rank": 1, "points": 11000, "previous_points": 11000, "tournaments_played": 19, "label": "Jannik Sinner", "entity": { "id": 206570, "type": "player", "name": "Jannik Sinner", "short_name": "J. Sinner", "slug": "sinner-jannik", "sport": "tennis", "gender": "M", "country": "Italy", "country_code": "IT" } } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

type

requiredinteger

Ranking id from sofascore-ranking-types · allowed: 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

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": 5,
    "name": "ATP men's singles ranking",
    "sport": "tennis",
    "entity_type": "player",
    "updated_timestamp": 1791327637,
    "updated_at": "2026-10-06T23:00:37Z",
    "total_rows": 500,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/rankings/type/5",
    "fetched_at": "2026-10-07T14:00:00Z",
    "rankings": [
      {
        "rank": 1,
        "previous_rank": 1,
        "best_rank": 1,
        "points": 11000,
        "previous_points": 11000,
        "tournaments_played": 19,
        "label": "Jannik Sinner",
        "entity": {
          "id": 206570,
          "type": "player",
          "name": "Jannik Sinner",
          "short_name": "J. Sinner",
          "slug": "sinner-jannik",
          "sport": "tennis",
          "gender": "M",
          "country": "Italy",
          "country_code": "IT"
        }
      }
    ]
  }
}

Endpoint Playground

Try the SofaScore rankings API

What a live request returned

14 Oct 2026: 40 rankings; 8 fields had a value in every checked item.

Observed request: GET /sofascore/rankings?limit=40&type=5
Fields with a value in every checked item: rank, previous_rank, best_rank, points, previous_points, tournaments_played, label, entity

Sample value profiles: rank: 1 to 40, median 20; label: “Jannik Sinner” and 39 other values; previous_rank: 1 to 40, median 20.

Request: GET /sofascore/rankings
Cost: 1 credit/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.93 s
Monitored request: GET /sofascore/rankings?limit=3&type=5

SofaScore rankings API documentation SofaScore platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/sofascore/rankings?type=5' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
type	integer	Yes	5	Ranking id from sofascore-ranking-types
limit	integer	No		Return only the first N rows, 1 to 500. Omit to return every row

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": 5,
    "name": "ATP men's singles ranking",
    "sport": "tennis",
    "entity_type": "player",
    "updated_timestamp": 1791327637,
    "updated_at": "2026-10-06T23:00:37Z",
    "total_rows": 500,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/rankings/type/5",
    "fetched_at": "2026-10-07T14:00:00Z",
    "rankings": [
      {
        "rank": 1,
        "previous_rank": 1,
        "best_rank": 1,
        "points": 11000,
        "previous_points": 11000,
        "tournaments_played": 19,
        "label": "Jannik Sinner",
        "entity": {
          "id": 206570,
          "type": "player",
          "name": "Jannik Sinner",
          "short_name": "J. Sinner",
          "slug": "sinner-jannik",
          "sport": "tennis",
          "gender": "M",
          "country": "Italy",
          "country_code": "IT"
        }
      }
    ]
  }
}

More SofaScore endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestsofascore.rankingsResponseDocSofaScore

GET /sofascore/rankings

SofaScore rankings

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

type

requiredinteger

Ranking id from sofascore-ranking-types · allowed: 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

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "type": 5,
    "name": "ATP men's singles ranking",
    "sport": "tennis",
    "entity_type": "player",
    "updated_timestamp": 1791327637,
    "updated_at": "2026-10-06T23:00:37Z",
    "total_rows": 500,
    "count": 1,
    "source_url": "https://api.sofascore.com/api/v1/rankings/type/5",
    "fetched_at": "2026-10-07T14:00:00Z",
    "rankings": [
      {
        "rank": 1,
        "previous_rank": 1,
        "best_rank": 1,
        "points": 11000,
        "previous_points": 11000,
        "tournaments_played": 19,
        "label": "Jannik Sinner",
        "entity": {
          "id": 206570,
          "type": "player",
          "name": "Jannik Sinner",
          "short_name": "J. Sinner",
          "slug": "sinner-jannik",
          "sport": "tennis",
          "gender": "M",
          "country": "Italy",
          "country_code": "IT"
        }
      }
    ]
  }
}