Base URL
https://api.sportsapipro.com/v2/football
Endpoints
Recommended: explicit ranking aliases
GET /api/rankings/leagues # UEFA league coefficients (55 leagues)
GET /api/rankings/fifa # FIFA world ranking (211 national teams)
/api/rankings/type/1 and /api/rankings/type/2, with names that cannot be misread.
Verified 25 September 2026:
/api/rankings/leagues returns 55 entries, /api/rankings/fifa returns 211.Default Ranking (UEFA league coefficients)
GET /api/rankings
/api/rankings/type/2.
Verified 25 September 2026: returns 55 entries with
uniqueTournament, ranking and points (e.g. 1. Premier League 103.796, 2. Serie A 88.589).Rankings by ID
GET /api/rankings/{rankingId}
number
required
Numeric ranking ID.
Example response
Example response
Recorded 24 September 2026 from
GET /v2/football/rankings/1 (lists trimmed to 2 items).{
"success": true,
"data": {
"rankingType": {
"sport": {
"id": 1,
"slug": "football",
"name": "Football"
},
"name": "UEFA Countries",
"slug": "uefa-countries",
"gender": "M",
"id": 1,
"lastUpdatedTimestamp": 1790256626
},
"rankingRows": [
{
"year": 2027,
"uniqueTournament": {
"name": "Premier League",
"slug": "premier-league",
"primaryColorHex": "#3c1c5a",
"secondaryColorHex": "#f80158",
"category": {
"name": "England",
"slug": "england",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"priority": 10,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England",
"slug": "england"
},
"id": 1,
"flag": "england",
"alpha2": "EN",
"fieldTranslations": {
"nameTranslation": {
"ar": "إنجلترا",
"bn": "ইংল্যান্ড",
"hi": "इंग्लैंड",
"ru": "Англия"
},
"shortNameTranslation": {}
}
},
"userCount": 1307192,
"liveActivityEnabled": true,
"country": {},
"id": 17,
"displayInverseHomeAwayTeams": false,
"fieldTranslations": {
"nameTranslation": {
"ar": "الدوري الإنجليزي الممتاز",
"bn": "প্রিমিয়ার লীগ",
"hi": "प्रिमियर लीग",
"ru": "Премьер-лига"
},
"shortNameTranslation": {}
}
},
"name": "England",
"position": 1,
"points": 103.796,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England",
"slug": "england"
},
"id": 268217,
"playingTeams": 9,
"totalTeams": 9,
"updatedAtTimestamp": 1789680643
},
{
"year": 2027,
"uniqueTournament": {
"name": "Serie A",
"slug": "serie-a",
"primaryColorHex": "#09519e",
"secondaryColorHex": "#008fd7",
"category": {
"name": "Italy",
"slug": "italy",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"priority": 7,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy",
"slug": "italy"
},
"id": 31,
"flag": "italy",
"alpha2": "IT",
"fieldTranslations": {
"nameTranslation": {
"ar": "إيطاليا",
"bn": "ইতালি",
"hi": "इटली",
"ru": "Италия"
},
"shortNameTranslation": {}
}
},
"userCount": 694859,
"liveActivityEnabled": true,
"country": {},
"id": 23,
"displayInverseHomeAwayTeams": false,
"fieldTranslations": {
"nameTranslation": {
"ar": "الدوري الإيطالي",
"bn": "সিরি আ",
"hi": "सीरी ए",
"ru": "Серия А"
},
"shortNameTranslation": {}
}
},
"name": "Italy",
"position": 2,
"points": 88.589,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy",
"slug": "italy"
},
"id": 268218,
"playingTeams": 7,
"totalTeams": 7,
"updatedAtTimestamp": 1789680643
}
]
}
}
Rankings by Type
GET /api/rankings/type/{typeId}
number
required
Ranking type ID.
| Type ID | Description |
|---|---|
1 | UEFA league coefficients (55 leagues) |
2 | FIFA World Rankings (211 national teams) |
3 | AFC Rankings |
Example response
Example response
Recorded 24 September 2026 from
GET /v2/football/rankings/type/2 (lists trimmed to 2 items).{
"success": true,
"data": {
"rankings": [
{
"team": {
"name": "Spain",
"slug": "spain",
"shortName": "Spain",
"gender": "M",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"userCount": 2539366,
"nameCode": "ESP",
"ranking": 1,
"disabled": false,
"national": true,
"type": 0,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain",
"slug": "spain"
},
"id": 4698,
"teamColors": {
"primary": "#cc0000",
"secondary": "#ffffff",
"text": "#ffffff"
},
"fieldTranslations": {
"nameTranslation": {
"ar": "إسبانيا",
"bn": "স্পেন",
"hi": "स्पेन",
"ru": "Испания"
},
"shortNameTranslation": {}
}
},
"type": 2,
"rowName": "Spain",
"ranking": 1,
"points": 1995.881879,
"previousRanking": 2,
"previousPoints": 1874.710778,
"id": 233899,
"country": {},
"rankingClass": "team"
},
{
"team": {
"name": "Argentina",
"slug": "argentina",
"shortName": "Argentina",
"gender": "M",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"userCount": 2873642,
"nameCode": "ARG",
"ranking": 2,
"disabled": false,
"national": true,
"type": 0,
"country": {
"alpha2": "AR",
"alpha3": "ARG",
"name": "Argentina",
"slug": "argentina"
},
"id": 4819,
"teamColors": {
"primary": "#66ccff",
"secondary": "#ffffff",
"text": "#ffffff"
},
"fieldTranslations": {
"nameTranslation": {
"ar": "الأرجنتين",
"bn": "আর্জেন্টিনা",
"hi": "अर्जेंटीना",
"ru": "Аргентина"
},
"shortNameTranslation": {}
}
},
"type": 2,
"rowName": "Argentina",
"ranking": 2,
"points": 1970.36539,
"previousRanking": 1,
"previousPoints": 1877.266571,
"id": 233900,
"country": {},
"rankingClass": "team"
}
],
"updatedAtTimestamp": 1790262028
}
}
Rankings Featured Events
GET /api/rankings/type/{typeId}/featured-events
Example response
Example response
Recorded 24 September 2026 from
GET /v2/football/rankings/type/1/featured-events (lists trimmed to 2 items).{
"success": true,
"data": {
"featuredEvents": [
{
"eventState": {},
"tournament": {
"name": "UEFA Champions League",
"slug": "uefa-champions-league",
"category": {
"name": "Europe",
"slug": "europe",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"priority": 19,
"id": 1465,
"flag": "europe",
"fieldTranslations": {
"nameTranslation": {
"ar": "أوروبا",
"hi": "यूरोप",
"bn": "ইউরোপ",
"ru": "Европа"
},
"shortNameTranslation": {}
}
},
"uniqueTournament": {
"name": "UEFA Champions League",
"slug": "uefa-champions-league",
"primaryColorHex": "#062b5c",
"secondaryColorHex": "#086aab",
"category": {
"name": "Europe",
"slug": "europe",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"priority": 19,
"id": 1465,
"flag": "europe",
"fieldTranslations": {
"nameTranslation": {
"ar": "أوروبا",
"hi": "यूरोप",
"bn": "ইউরোপ",
"ru": "Европа"
},
"shortNameTranslation": {}
}
},
"userCount": 1219487,
"liveActivityEnabled": true,
"id": 7,
"displayInverseHomeAwayTeams": false,
"fieldTranslations": {
"nameTranslation": {
"ro": "UEFA Champions League",
"bn": "উয়েফা চ্যাম্পিয়ন্স লীগ",
"ar": "دوري أبطال أوروبا",
"hi": "यूईएफए चैंपियंस लीग",
"hr": "UEFA Liga prvaka",
"ru": "Лига чемпионов УЕФА"
},
"shortNameTranslation": {}
}
},
"priority": 719,
"id": 138314,
"fieldTranslations": {
"nameTranslation": {
"ar": "دوري أبطال أوروبا",
"ru": "Лига чемпионов УЕФА"
},
"shortNameTranslation": {}
}
},
"roundInfo": {
"round": 2
},
"customId": "cebsEgb",
"status": {
"code": 0,
"description": "Not started",
"type": "notstarted"
},
"homeTeam": {
"name": "AS Roma",
"slug": "roma",
"shortName": "Roma",
"gender": "M",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"userCount": 814849,
"nameCode": "ASR",
"disabled": false,
"national": false,
"type": 0,
"id": 2702,
"teamColors": {
"primary": "#990000",
"secondary": "#eaca15",
"text": "#eaca15"
},
"fieldTranslations": {
"nameTranslation": {
"ar": "روما",
"bn": "রোমা",
"hi": "रोमा",
"ru": "Рома"
},
"shortNameTranslation": {}
}
},
"awayTeam": {
"name": "Real Madrid",
"slug": "real-madrid",
"shortName": "Real Madrid",
"gender": "M",
"sport": {
"name": "Football",
"slug": "football",
"id": 1
},
"userCount": 8469005,
"nameCode": "RMA",
"disabled": false,
"national": false,
"type": 0,
"id": 2829,
"teamColors": {
"primary": "#ffffff",
"secondary": "#004996",
"text": "#004996"
},
"fieldTranslations": {
"nameTranslation": {
"ar": "ريال مدريد",
"bn": "রিয়াল মাদ্রিদ",
"hi": "रियल मैड्रिड",
"ru": "Реал Мадрид"
},
"shortNameTranslation": {}
}
},
"homeScore": {},
"awayScore": {},
"id": 16938872,
"slug": "real-madrid-as-roma",
"startTimestamp": 1792004400,
"finalResultOnly": false
}
]
}
}
Example Requests
curl -X GET "https://api.sportsapipro.com/v2/football/rankings/leagues" \
-H "x-api-key: YOUR_API_KEY"
const rankings = await fetch(
'https://api.sportsapipro.com/v2/football/rankings/leagues',
{ headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());
import requests
rankings = requests.get(
'https://api.sportsapipro.com/v2/football/rankings/leagues',
headers={'x-api-key': 'YOUR_API_KEY'}
).json()