Docs menu
SofaScore API endpoint
SofaScore team rankings API
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.
GETapiKey1 credit/requestSofaScoresofascore.teamRankingsResponseDoc
SofaScore/sofascore/team-rankingsEndpoint facts
- Method
- GET
- API path
- /sofascore/team-rankings
- Auth
- apiKey
- Credits
- 1 credit/request
- Charged on
- Successful 2xx responses only
- Platform
- SofaScore
- Response schema
- #/definitions/sofascore.teamRankingsResponseDoc
How this endpoint behaves
Query parameters:
id: required. Numeric SofaScore team id, e.g.112783(a tennis player) or17(Manchester City).
Notable response behavior:
- Each ranking has a
type_id(the same ids the rankings endpoint takes, for example5for ATP,7for ATP live,34for UTR men,9for UEFA clubs), its name, sport, category, gender and last update, androwswith theposition,pointsand, where SofaScore reports them,previous_position,best_position,previous_points,tournaments_played, and for live rankingsnext_win_pointsandmax_points. - A tennis player typically appears in an official ranking, its live version and a UTR rating. A football club appears once per year in the UEFA club ranking (
yearis set on those rows). - Returns
404when the id appears in no ranking (a football player id was404when checked).
Live monitoring
- Monitored request
- GET /sofascore/team-rankings?id=112783
- Checks passed, 7 days to 14 Oct 2026
- 100%
- Median response time
- 0.95 s
Sampled response
- Request, 14 Oct 2026
- GET /sofascore/team-rankings?id=112783
- Items in rankings
- 3
- Fields filled in every checked item
- 9
| Field | Filled in, of 3 checked | Values in the sample |
|---|---|---|
| type_id | 3 | |
| name | 3 | “ATP Rankings” and 2 other values |
| slug | 3 | |
| gender | 3 | |
| sport | 3 | “tennis” |
| category | 3 | “ATP” and 1 other value |
| last_updated_timestamp | 3 | 2026-10-13 |
| last_updated | 3 | 2026-10-13 |
| rows | 3 | median 1 entry |
Request parameters
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id | string | Yes | Numeric SofaScore team id (a tennis player id for tennis) | 112783 | |
| x-api-key (header) | string | Yes | API key required |
cURL example
curl -X GET "https://api.crawlora.net/api/v1/sofascore/team-rankings?id=112783" \ -H "x-api-key: $CRAWLORA_API_KEY"
Example JSON response
{
"code": 200,
"msg": "OK",
"data": {
"team_id": 112783,
"source_url": "https://api.sofascore.com/api/v1/rankings/team/112783",
"fetched_at": "2026-07-08T00:00:00Z",
"count": 3,
"rankings": [
{
"type_id": 5,
"name": "ATP Rankings",
"slug": "atp-rankings",
"gender": "M",
"sport": "tennis",
"category": "ATP",
"last_updated_timestamp": 1791327637,
"last_updated": "2026-10-06T23:00:37Z",
"rows": [
{
"position": 46,
"points": 1168,
"previous_position": 47,
"best_position": 6,
"previous_points": 1128,
"tournaments_played": 16,
"updated_timestamp": 1791176441,
"updated_at": "2026-10-05T05:00:41Z",
"team": {
"id": 112783,
"name": "Matteo Berrettini",
"short_name": "M. Berrettini",
"slug": "berrettini-matteo"
}
}
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/sofascore.teamRankingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | sofascore.TeamRankingsResponse | No | ||||
| data.count | integer | No | ||||
| data.fetched_at | string | No | ||||
| data.rankings | array | No | ||||
| data.rankings[].category | string | No | ATP | |||
| data.rankings[].gender | string | No | M | |||
| data.rankings[].last_updated | string | No | ||||
| data.rankings[].last_updated_timestamp | integer | No | ||||
| data.rankings[].name | string | No | ATP Rankings | |||
| data.rankings[].rows | array | No | ||||
| data.rankings[].rows[].best_position | integer | No | ||||
| data.rankings[].rows[].max_points | number | No | ||||
| data.rankings[].rows[].next_win_points | number | No | ||||
| data.rankings[].rows[].points | number | No | 1168 | |||
| data.rankings[].rows[].position | integer | No | 46 | |||
| data.rankings[].rows[].previous_points | number | No | ||||
| data.rankings[].rows[].previous_position | integer | No | ||||
| data.rankings[].rows[].team | sofascore.TeamRef | No | TeamRef record, 6 fields: country, id, name, national, short_name, slug. Described under SofaScore venue API. | |||
| data.rankings[].rows[].tournaments_played | integer | No | ||||
| data.rankings[].rows[].updated_at | string | No | ||||
| data.rankings[].rows[].updated_timestamp | integer | No | ||||
| data.rankings[].rows[].year | integer | No | 2026 | |||
| data.rankings[].slug | string | No | atp-rankings | |||
| data.rankings[].sport | string | No | tennis | |||
| data.rankings[].type_id | integer | No | 5 | |||
| data.source_url | string | No | ||||
| data.team_id | integer | No | 112783 | |||
| msg | string | No | OK |
Failure responses
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Code examples
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/sofascore/team-rankings?id=112783" \
-H "x-api-key: $CRAWLORA_API_KEY"Shared guides
Related
More SofaScore endpoint docsSofaScore APISofaScore categories for a sport API documentationSofaScore competitions in a category API documentationSofaScore league draft picks API documentationSofaScore league draft API documentationSofaScore esports game detail API documentationSofaScore event at-bat pitches API documentation