Global, Search & Schedule Endpoints

Base URL

https://api.sportsapipro.com/v2/football

Live Data

Live Scores

GET /api/live

Returns all currently live matches with simplified flat format — each event has string team names, integer scores, and a status string. Use this as the primary source for discovering live match IDs.

Example Response — /api/live

{
  "success": true,
  "count": 54,
  "events": [
    {
      "id": 15269945,
      "homeTeam": "Estudiantes de Río Cuarto",
      "awayTeam": "Barracas Central",
      "homeScore": 1,
      "awayScore": 2,
      "status": "2nd half",
      "tournament": "Liga Profesional de Fútbol, Apertura",
      "slug": "estudiantes-de-rio-cuarto-barracas-central",
      "startTimestamp": 1775954700
    }
  ],
  "timezone": { "name": "UTC", "source": "default", "utcOffset": "+00:00" }
}

Two response formats: /api/live returns a simplified flat format (string team names, integer scores, status as a string). /api/today and /api/schedule/{date} return the full detailed format with nested team objects, score objects (period1, period2, current, display, normaltime), and detailed match metadata. Use the simplified format for quick score displays; use the full format when you need team IDs, colors, or period breakdowns.

Example response

Recorded 24 September 2026 from GET /v2/football/live (lists trimmed to 2 items).

{
  "success": true,
  "count": 83,
  "events": [
    {
      "id": 17157248,
      "slug": "iran-uzbekistan",
      "tournament": "Int. Friendly Games",
      "homeTeam": "Uzbekistan",
      "awayTeam": "Iran",
      "homeScore": 1,
      "awayScore": 0,
      "status": "Halftime",
      "startTimestamp": 1790258400
    },
    {
      "id": 17157236,
      "slug": "romania-u19-hungary-u19",
      "tournament": "U19 Friendly Games",
      "homeTeam": "Romania U19",
      "awayTeam": "Hungary U19",
      "homeScore": 1,
      "awayScore": 1,
      "status": "Halftime",
      "startTimestamp": 1790258400
    }
  ]
}

All Live Events

GET /api/live/all

Returns all live events unfiltered with full raw data (same structure as /api/today).

Example response

Recorded 24 September 2026 from GET /v2/football/live/all (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "events": [
      {
        "eventState": {},
        "tournament": {
          "name": "Int. Friendly Games",
          "slug": "int-friendly-games",
          "category": {
            "name": "World",
            "slug": "world",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 20,
            "country": {},
            "id": 1468,
            "flag": "international",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "العالم",
                "bn": "বিশ্ব",
                "hi": "विश्व",
                "ru": "Мир"
              },
              "shortNameTranslation": {}
            }
          },
          "uniqueTournament": {
            "name": "International Friendly Games",
            "slug": "int-friendly-games",
            "primaryColorHex": "#25497d",
            "secondaryColorHex": "#d38f1d",
            "category": {
              "name": "World",
              "slug": "world",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 20,
              "country": {},
              "id": 1468,
              "flag": "international",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "العالم",
                  "bn": "বিশ্ব",
                  "hi": "विश्व",
                  "ru": "Мир"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 117611,
            "hasPerformanceGraphFeature": false,
            "liveActivityEnabled": true,
            "country": {},
            "id": 851,
            "hasEventPlayerStatistics": false,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "مباريات ودية دولية",
                "bn": "ইন্টারন্যাশনাল ফ্রেন্ডলি গেমস",
                "hi": "इंटरनेशनल फ्रेंडली गेम्स",
                "ru": "Международные товарищеские игры"
              },
              "shortNameTranslation": {}
            }
          },
          "priority": 89,
          "isGroup": false,
          "isLive": false,
          "id": 66,
          "fieldTranslations": {
            "nameTranslation": {
              "hi": "इंटरनेशनल फ्रेंडली गेम्स",
              "ar": "مباريات ودية دولية",
              "bn": "ইন্টারন্যাশনাল ফ্রেন্ডলি গেমস",
              "ru": "Международные товарищеские матчи"
            },
            "shortNameTranslation": {}
          }
        },
        "season": {
          "name": "Int. Friendly Games 2026",
          "year": "2026",
          "editor": false,
          "id": 87155
        },
        "customId": "yUbsqVb",
        "status": {
          "code": 31,
          "description": "Halftime",
          "type": "inprogress"
        },
        "homeTeam": {
          "name": "Uzbekistan",
          "slug": "uzbekistan",
          "shortName": "Uzbekistan",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 195368,
          "nameCode": "UZB",
          "ranking": 60,
          "disabled": false,
          "national": true,
          "type": 0,
          "country": {
            "alpha2": "UZ",
            "alpha3": "UZB",
            "name": "Uzbekistan",
            "slug": "uzbekistan"
          },
          "id": 4723,
          "subTeams": [],
          "teamColors": {
            "primary": "#0080ff",
            "secondary": "#ffffff",
            "text": "#ffffff"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "أوزبكستان",
              "bn": "উজবেকিস্তান",
              "hi": "उज़्बेकिस्तान",
              "ru": "Узбекистан"
            },
            "shortNameTranslation": {}
          }
        },
        "awayTeam": {
          "name": "Iran",
          "slug": "iran",
          "shortName": "Iran",
          "gender": "M",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "userCount": 129027,
          "nameCode": "IRI",
          "ranking": 22,
          "disabled": false,
          "national": true,
          "type": 0,
          "country": {
            "alpha2": "IR",
            "alpha3": "IRN",
            "name": "Iran",
            "slug": "iran"
          },
          "id": 4766,
          "subTeams": [],
          "teamColors": {
            "primary": "#ffffff",
            "secondary": "#cc0000",
            "text": "#cc0000"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "إيران",
              "bn": "ইরান",
              "hi": "ईरान",
              "ru": "Иран"
            },
            "shortNameTranslation": {}
          }
        },
        "homeScore": {
          "current": 1,
          "display": 1,
          "period1": 1,
          "normaltime": 1
        },
        "awayScore": {
          "current": 0,
          "display": 0,
          "period1": 0,
          "period2": 0,
          "normaltime": 0
        },
        "coverage": -1,
        "time": {
          "currentPeriodStartTimestamp": 1790258475,
          "lastPeriodEndTimestamp": 1790261295
        },
        "changes": {
          "changes": [
            "awayScore.period2"
          ],
          "changeTimestamp": 1790262286
        },
        "hasGlobalHighlights": false,
        "hasEventPlayerStatistics": false,
        "detailId": 4,
        "crowdsourcingDataDisplayEnabled": false,
        "id": 17157248,
        "varInProgress": {
          "homeTeam": false,
          "awayTeam": false
        },
        "slug": "iran-uzbekistan",
        "startTimestamp": 1790258400,
        "finalResultOnly": false,
        "feedLocked": true,
        "isEditor": false,
        "eventFilters": {
          "category": [
            "national"
          ],
          "level": [
            "pro"
          ],
          "gender": [
            "M"
          ]
        }
      }
    ]
  },
  "natsOverlaid": 29
}

Today’s Matches

GET /api/today

Returns all matches scheduled for today across all competitions.

Example response

Recorded 24 September 2026 from GET /v2/football/today (lists trimmed to 2 items).

{
  "success": true,
  "events": [
    {
      "eventState": {},
      "tournament": {
        "name": "Int. Friendly Games",
        "slug": "int-friendly-games",
        "category": {
          "name": "World",
          "slug": "world",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 20,
          "country": {},
          "id": 1468,
          "flag": "international",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "العالم",
              "bn": "বিশ্ব",
              "hi": "विश्व",
              "ru": "Мир"
            },
            "shortNameTranslation": {}
          }
        },
        "uniqueTournament": {
          "name": "International Friendly Games",
          "slug": "int-friendly-games",
          "primaryColorHex": "#25497d",
          "secondaryColorHex": "#d38f1d",
          "category": {
            "name": "World",
            "slug": "world",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 20,
            "country": {},
            "id": 1468,
            "flag": "international",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "العالم",
                "bn": "বিশ্ব",
                "hi": "विश्व",
                "ru": "Мир"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 117611,
          "hasPerformanceGraphFeature": false,
          "liveActivityEnabled": true,
          "country": {},
          "id": 851,
          "hasEventPlayerStatistics": false,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "مباريات ودية دولية",
              "bn": "ইন্টারন্যাশনাল ফ্রেন্ডলি গেমস",
              "hi": "इंटरनेशनल फ्रेंडली गेम्स",
              "ru": "Международные товарищеские игры"
            },
            "shortNameTranslation": {}
          }
        },
        "priority": 89,
        "isGroup": false,
        "isLive": false,
        "id": 66,
        "fieldTranslations": {
          "nameTranslation": {
            "hi": "इंटरनेशनल फ्रेंडली गेम्स",
            "ar": "مباريات ودية دولية",
            "bn": "ইন্টারন্যাশনাল ফ্রেন্ডলি গেমস",
            "ru": "Международные товарищеские матчи"
          },
          "shortNameTranslation": {}
        }
      },
      "season": {
        "name": "Int. Friendly Games 2026",
        "year": "2026",
        "editor": false,
        "id": 87155
      },
      "customId": "yUbsqVb",
      "status": {
        "code": 31,
        "description": "Halftime",
        "type": "inprogress"
      },
      "homeTeam": {
        "name": "Uzbekistan",
        "slug": "uzbekistan",
        "shortName": "Uzbekistan",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 195368,
        "nameCode": "UZB",
        "ranking": 60,
        "disabled": false,
        "national": true,
        "type": 0,
        "country": {
          "alpha2": "UZ",
          "alpha3": "UZB",
          "name": "Uzbekistan",
          "slug": "uzbekistan"
        },
        "id": 4723,
        "subTeams": [],
        "teamColors": {
          "primary": "#0080ff",
          "secondary": "#ffffff",
          "text": "#ffffff"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "أوزبكستان",
            "bn": "উজবেকিস্তান",
            "hi": "उज़्बेकिस्तान",
            "ru": "Узбекистан"
          },
          "shortNameTranslation": {}
        }
      },
      "awayTeam": {
        "name": "Iran",
        "slug": "iran",
        "shortName": "Iran",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 129027,
        "nameCode": "IRI",
        "ranking": 22,
        "disabled": false,
        "national": true,
        "type": 0,
        "country": {
          "alpha2": "IR",
          "alpha3": "IRN",
          "name": "Iran",
          "slug": "iran"
        },
        "id": 4766,
        "subTeams": [],
        "teamColors": {
          "primary": "#ffffff",
          "secondary": "#cc0000",
          "text": "#cc0000"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "إيران",
            "bn": "ইরান",
            "hi": "ईरान",
            "ru": "Иран"
          },
          "shortNameTranslation": {}
        }
      },
      "homeScore": {
        "current": 1,
        "display": 1,
        "period1": 1,
        "normaltime": 1
      },
      "awayScore": {
        "current": 0,
        "display": 0,
        "period1": 0,
        "period2": 0,
        "normaltime": 0
      },
      "coverage": -1,
      "time": {
        "currentPeriodStartTimestamp": 1790258475,
        "lastPeriodEndTimestamp": 1790261295
      },
      "changes": {
        "changes": [
          "awayScore.period2"
        ],
        "changeTimestamp": 1790262286
      },
      "hasGlobalHighlights": false,
      "hasEventPlayerStatistics": false,
      "detailId": 4,
      "crowdsourcingDataDisplayEnabled": false,
      "id": 17157248,
      "varInProgress": {
        "homeTeam": false,
        "awayTeam": false
      },
      "slug": "iran-uzbekistan",
      "startTimestamp": 1790258400,
      "finalResultOnly": false,
      "feedLocked": true,
      "isEditor": false,
      "eventFilters": {
        "category": [
          "national"
        ],
        "level": [
          "pro"
        ],
        "gender": [
          "M"
        ]
      }
    }
  ]
}

GET /api/trending

Returns the top 20 events sorted by attendance and popularity — great for featuring “hot” matches.

Example response

Recorded 24 September 2026 from GET /v2/football/trending (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "count": 20,
    "events": [
      {
        "id": 17157248,
        "slug": "iran-uzbekistan",
        "tournament": "Int. Friendly Games",
        "homeTeam": "Uzbekistan",
        "awayTeam": "Iran",
        "homeScore": 1,
        "awayScore": 0,
        "status": "Halftime"
      },
      {
        "id": 17157236,
        "slug": "romania-u19-hungary-u19",
        "tournament": "U19 Friendly Games",
        "homeTeam": "Romania U19",
        "awayTeam": "Hungary U19",
        "homeScore": 1,
        "awayScore": 1,
        "status": "Halftime"
      }
    ]
  },
  "natsOverlaid": 29
}

GET /api/trending-players

Returns currently trending players based on recent performance and media attention.

Example response

Recorded 24 September 2026 from GET /v2/football/trending-players (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "topPlayers": [
      {
        "event": {
          "eventState": {},
          "tournament": {
            "name": "UEFA Champions League, Women",
            "slug": "uefa-champions-league-women",
            "category": {
              "name": "Europe",
              "slug": "europe",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 19,
              "id": 1465,
              "flag": "europe",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "أوروبا",
                  "bn": "ইউরোপ",
                  "hi": "यूरोप",
                  "ru": "Европа"
                },
                "shortNameTranslation": {}
              }
            },
            "uniqueTournament": {
              "name": "UEFA Women's Champions League",
              "slug": "uefa-womens-champions-league",
              "primaryColorHex": "#807f84",
              "secondaryColorHex": "#8000a1",
              "category": {
                "name": "Europe",
                "slug": "europe",
                "sport": {
                  "name": "Football",
                  "slug": "football",
                  "id": 1
                },
                "priority": 19,
                "id": 1465,
                "flag": "europe",
                "fieldTranslations": {
                  "nameTranslation": "...",
                  "shortNameTranslation": "..."
                }
              },
              "userCount": 66889,
              "liveActivityEnabled": true,
              "id": 696,
              "displayInverseHomeAwayTeams": false,
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "دوري أبطال أوروبا للسيدات",
                  "bn": "উয়েফা উইমেনস চ্যাম্পিয়ন্স লীগ",
                  "hi": "यूईएफए वूमेंस चैंपियंस लीग",
                  "ru": "Лига чемпионов УЕФА среди женщин"
                },
                "shortNameTranslation": {}
              }
            },
            "priority": 585,
            "id": 198786
          },
          "roundInfo": {
            "round": 1
          },
          "customId": "OhGsoZfc",
          "status": {
            "code": 100,
            "description": "Ended",
            "type": "finished"
          },
          "winnerCode": 1,
          "homeTeam": {
            "name": "Fútbol Club Barcelona",
            "slug": "barcelona",
            "shortName": "FC Barcelona",
            "gender": "F",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "userCount": 385111,
            "nameCode": "FCB",
            "disabled": false,
            "national": false,
            "type": 0,
            "id": 77889,
            "teamColors": {
              "primary": "#154284",
              "secondary": "#9d1009",
              "text": "#9d1009"
            },
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "برشلونة",
                "ru": "ФК Барселона"
              },
              "shortNameTranslation": {
                "ar": "برشلونة"
              }
            }
          },
          "awayTeam": {
            "name": "Paris FC",
            "slug": "paris-fc",
            "shortName": "Paris",
            "gender": "F",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "userCount": 17327,
            "nameCode": "PAR",
            "disabled": false,
            "national": false,
            "type": 0,
            "id": 264964,
            "teamColors": {
              "primary": "#2e3552",
              "secondary": "#2e3552",
              "text": "#2e3552"
            },
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "باريس",
                "ru": "Париж ФК"
              },
              "shortNameTranslation": {
                "ru": "Париж"
              }
            }
          },
          "homeScore": {
            "current": 5,
            "display": 5,
            "period1": 4,
            "period2": 1,
            "normaltime": 5
          },
          "awayScore": {
            "current": 2,
            "display": 2,
            "period1": 1,
            "period2": 1,
            "normaltime": 2
          },
          "id": 17018515,
          "slug": "paris-fc-futbol-club-barcelona",
          "startTimestamp": 1790190000,
          "finalResultOnly": false
        },
        "totalPass": 33,
        "accuratePass": 27,
        "totalLongBalls": 2,
        "accurateLongBalls": 1,
        "goalAssist": 2,
        "accurateOwnHalfPasses": 13,
        "totalOwnHalfPasses": 15,
        "accurateOppositionHalfPasses": 14,
        "totalOppositionHalfPasses": 18,
        "totalCross": 10,
        "accurateCross": 6,
        "aerialWon": 1,
        "duelLost": 4,
        "duelWon": 4,
        "totalContest": 5,
        "wonContest": 1,
        "bigChanceCreated": 2,
        "onTargetScoringAttempt": 2,
        "goals": 1,
        "ballRecovery": 5,
        "totalTackle": 1,
        "wonTackle": 1,
        "unsuccessfulTouch": 2,
        "wasFouled": 1,
        "...": "20 more fields"
      }
    ]
  }
}

Live Tournaments

GET /api/live-tournaments

Returns tournaments that currently have live matches in progress. Useful for building a sidebar of active competitions.

Example response

Recorded 24 September 2026 from GET /v2/football/live-tournaments (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "liveTournaments": {
      "66": 1,
      "1238": 1,
      "3069": 1,
      "5799": 3,
      "6238": 1,
      "11138": 3,
      "55720": 1,
      "62018": 5,
      "62405": 6,
      "87823": 1,
      "90471": 1,
      "92090": 1,
      "94721": 1,
      "96516": 3,
      "102660": 1,
      "105633": 2,
      "106974": 1,
      "121534": 1,
      "137433": 3,
      "137434": 2,
      "137448": 5,
      "139562": 1,
      "140658": 1,
      "141080": 1,
      "141764": 1,
      "142764": 1,
      "146952": 1,
      "148530": 1,
      "149650": 1,
      "152557": 1,
      "152736": 1,
      "152737": 1,
      "160380": 1,
      "166900": 3,
      "170125": 4,
      "179111": 2,
      "179203": 1,
      "179276": 1,
      "181706": 1,
      "188358": 1,
      "190861": 1,
      "190862": 1,
      "195182": 1,
      "196439": 1,
      "198922": 2,
      "199062": 1,
      "199071": 1,
      "199089": 1,
      "199500": 1,
      "200011": 1,
      "200171": 1,
      "200401": 1,
      "200759": 1
    }
  }
}

Newly Added Events

GET /api/newly-added-events

Returns recently added fixtures that weren’t previously in the schedule (e.g., rescheduled matches, cup draws).

Example response

Recorded 24 September 2026 from GET /v2/football/newly-added-events (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "events": [
      {
        "eventId": 17174284,
        "homeTeamId": 480747,
        "awayTeamId": 480739,
        "uniqueTournamentId": 15005
      },
      {
        "eventId": 17174285,
        "homeTeamId": 481639,
        "awayTeamId": 481931,
        "uniqueTournamentId": 15005
      }
    ]
  }
}

Search

Search All

GET /api/search?q={query}

Search across teams, players, and tournaments simultaneously. Returns entity IDs that can be used with other endpoints.

string

required

Search query (e.g., arsenal, messi, premier league). Minimum 2 characters.

This is the primary way to discover entity IDs for teams, players, and tournaments when you don’t have them from another API call.

Example Response — /api/search?q=arsenal

{
  "success": true,
  "data": {
    "results": [
      {
        "type": "team",
        "score": 4923659,
        "entity": {
          "id": 42,
          "name": "Arsenal",
          "slug": "arsenal",
          "shortName": "Arsenal",
          "nameCode": "ARS",
          "national": false,
          "gender": "M",
          "country": { "alpha2": "EN", "name": "England", "slug": "england" },
          "sport": { "id": 1, "name": "Football", "slug": "football" },
          "teamColors": { "primary": "#cc0000", "secondary": "#ffffff", "text": "#ffffff" },
          "type": 0,
          "userCount": 3303460
        }
      }
    ]
  }
}

Search result structure: Each result has type ("team", "player", or "tournament"), a relevance score, and an entity object with the full details including the numeric id you need for other API calls.

Example response

Recorded 24 September 2026 from GET /v2/football/search?q=bayern (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "results": [
      {
        "entity": {
          "id": 2672,
          "name": "FC Bayern München",
          "nameCode": "FCB",
          "slug": "fc-bayern-munchen",
          "national": false,
          "sport": {
            "id": 1,
            "slug": "football",
            "name": "Football"
          },
          "userCount": 3231070,
          "teamColors": {
            "primary": "#cf142f",
            "secondary": "#ffffff",
            "text": "#ffffff"
          },
          "type": 0,
          "gender": "M",
          "country": {
            "alpha2": "DE",
            "name": "Germany",
            "slug": "germany"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "بايرن",
              "bn": "বায়ার্ন",
              "hi": "बायर्न",
              "ru": "Бавария Мюнхен"
            },
            "shortNameTranslation": {}
          }
        },
        "score": 250107.05,
        "type": "team"
      },
      {
        "entity": {
          "id": 2681,
          "name": "Bayer 04 Leverkusen",
          "nameCode": "B04",
          "slug": "bayer-04-leverkusen",
          "national": false,
          "sport": {
            "id": 1,
            "slug": "football",
            "name": "Football"
          },
          "userCount": 1018114,
          "teamColors": {
            "primary": "#000000",
            "secondary": "#ff2222",
            "text": "#ff2222"
          },
          "type": 0,
          "gender": "M",
          "country": {
            "alpha2": "DE",
            "name": "Germany",
            "slug": "germany"
          },
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "ليفركوزن",
              "bn": "লেভারকুসেন",
              "hi": "लेवरकुसेन",
              "ru": "Байер Леверкузен"
            },
            "shortNameTranslation": {}
          }
        },
        "score": 102105.33,
        "type": "team"
      }
    ]
  }
}

Schedule

Events by Date

GET /api/schedule/{date}

Returns all matches for a specific date, grouped by tournament.

string

required

Date in YYYY-MM-DD format (e.g., 2025-03-15).

Example response

Recorded 24 September 2026 from GET /v2/football/schedule/2026-09-20 (lists trimmed to 2 items).

{
  "success": true,
  "events": [
    {
      "eventState": {},
      "tournament": {
        "name": "LaLiga",
        "slug": "laliga",
        "category": {
          "name": "Spain",
          "slug": "spain",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 9,
          "country": {
            "alpha2": "ES",
            "alpha3": "ESP",
            "name": "Spain",
            "slug": "spain"
          },
          "id": 32,
          "flag": "spain",
          "alpha2": "ES",
          "fieldTranslations": {
            "nameTranslation": {
              "hi": "स्पेन",
              "ar": "إسبانيا",
              "bn": "স্পেন",
              "ru": "Испания"
            },
            "shortNameTranslation": {}
          }
        },
        "uniqueTournament": {
          "name": "LaLiga",
          "slug": "laliga",
          "primaryColorHex": "#2f4a89",
          "secondaryColorHex": "#f4a32e",
          "category": {
            "name": "Spain",
            "slug": "spain",
            "sport": {
              "name": "Football",
              "slug": "football",
              "id": 1
            },
            "priority": 9,
            "country": {
              "alpha2": "ES",
              "alpha3": "ESP",
              "name": "Spain",
              "slug": "spain"
            },
            "id": 32,
            "flag": "spain",
            "alpha2": "ES",
            "fieldTranslations": {
              "nameTranslation": {
                "hi": "स्पेन",
                "ar": "إسبانيا",
                "bn": "স্পেন",
                "ru": "Испания"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 937918,
          "hasPerformanceGraphFeature": true,
          "liveActivityEnabled": true,
          "country": {},
          "id": 8,
          "hasEventPlayerStatistics": true,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الإسباني",
              "hi": "ला लिगा",
              "bn": "লা লীগা",
              "ru": "Ла Лига"
            },
            "shortNameTranslation": {}
          }
        },
        "priority": 702,
        "isGroup": false,
        "isLive": false,
        "id": 36,
        "fieldTranslations": {
          "nameTranslation": {
            "hi": "ला लीगा",
            "ar": "الدوري الإسباني",
            "bn": "লা লীগা",
            "ru": "Ла Лига"
          },
          "shortNameTranslation": {}
        }
      },
      "season": {
        "name": "LaLiga 26/27",
        "year": "26/27",
        "editor": false,
        "id": 97268
      },
      "roundInfo": {
        "round": 7
      },
      "customId": "tgbsvgb",
      "status": {
        "code": 100,
        "description": "Ended",
        "type": "finished"
      },
      "winnerCode": 3,
      "venue": {
        "city": {
          "name": "Pamplona",
          "country": {
            "alpha2": "ES",
            "alpha3": "ESP",
            "name": "Spain",
            "slug": "spain"
          },
          "id": 19166
        },
        "venueCoordinates": {
          "latitude": 42.796662,
          "longitude": -1.637131
        },
        "hidden": false,
        "slug": "estadio-el-sadar",
        "name": "Estadio El Sadar",
        "capacity": 23576,
        "country": {
          "alpha2": "ES",
          "alpha3": "ESP",
          "name": "Spain",
          "slug": "spain"
        },
        "id": 739,
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "ملعب ال سادار",
            "hi": "एस्टेडियो एल सदर",
            "bn": "এস্তাদিও এল সদর",
            "ru": "Спортивный комплекс El Sadar"
          },
          "shortNameTranslation": {}
        },
        "stadium": {
          "name": "Estadio El Sadar",
          "capacity": 23576
        }
      },
      "homeTeam": {
        "name": "Osasuna",
        "slug": "osasuna",
        "shortName": "Osasuna",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 200153,
        "nameCode": "OSA",
        "disabled": false,
        "national": false,
        "type": 0,
        "country": {
          "alpha2": "ES",
          "alpha3": "ESP",
          "name": "Spain",
          "slug": "spain"
        },
        "id": 2820,
        "subTeams": [],
        "teamColors": {
          "primary": "#cc0000",
          "secondary": "#14213d",
          "text": "#14213d"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "أوساسونا",
            "bn": "ওসাসুনা",
            "hi": "ओसासुना",
            "ru": "Осасуна"
          },
          "shortNameTranslation": {}
        }
      },
      "awayTeam": {
        "name": "Rayo Vallecano",
        "slug": "rayo-vallecano",
        "shortName": "Rayo Vallecano",
        "gender": "M",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "userCount": 238373,
        "nameCode": "RAY",
        "disabled": false,
        "national": false,
        "type": 0,
        "country": {
          "alpha2": "ES",
          "alpha3": "ESP",
          "name": "Spain",
          "slug": "spain"
        },
        "id": 2818,
        "subTeams": [],
        "teamColors": {
          "primary": "#ffffff",
          "secondary": "#ffffff",
          "text": "#ffffff"
        },
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "رايو فاليكانو",
            "bn": "রায়ো ভ্যালেকানো",
            "hi": "रेयो वैलेकैनो",
            "ru": "Райо Вальекано"
          },
          "shortNameTranslation": {}
        }
      },
      "homeScore": {
        "current": 1,
        "display": 1,
        "period1": 1,
        "period2": 0,
        "normaltime": 1
      },
      "awayScore": {
        "current": 1,
        "display": 1,
        "period1": 0,
        "period2": 1,
        "normaltime": 1
      },
      "time": {
        "injuryTime1": 1,
        "injuryTime2": 6,
        "currentPeriodStartTimestamp": 1789823050,
        "lastPeriodEndTimestamp": 1789822029
      },
      "changes": {
        "changes": [
          "status.code"
        ],
        "changeTimestamp": 1789826129
      },
      "hasGlobalHighlights": true,
      "hasXg": true,
      "hasEventPlayerStatistics": true,
      "hasEventPlayerHeatMap": true,
      "detailId": 1,
      "crowdsourcingDataDisplayEnabled": false,
      "correctAiInsight": false,
      "correctHalftimeAiInsight": true,
      "id": 16416305,
      "slug": "osasuna-rayo-vallecano",
      "startTimestamp": 1789819200,
      "...": "4 more fields"
    }
  ],
  "tournaments": 50,
  "totalTournamentsOnDate": 1610
}

Scheduled Tournaments by Date

GET /api/scheduled-tournaments/{date}?page={page}

Returns tournaments that have matches on a specific date — useful for building a competition filter. Supports pagination.

string

required

Date in YYYY-MM-DD format.

number

default:"1"

Page number for paginated results.

Example response

Recorded 24 September 2026 from GET /v2/football/scheduled-tournaments/2026-09-20?page=0 (lists trimmed to 2 items).

{
  "success": true,
  "tournaments": [
    8,
    9
  ],
  "total": 1610,
  "date": "2026-09-20"
}

Event Count

GET /api/event-count

Returns a global count of events across all sports and competitions.

Example response

Recorded 24 September 2026 from GET /v2/football/event-count (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "badminton": {
      "live": 2,
      "total": 60
    },
    "futsal": {
      "live": 0,
      "total": 45
    },
    "ice-hockey": {
      "live": 6,
      "total": 59
    },
    "minifootball": {
      "live": 0,
      "total": 96
    },
    "darts": {
      "live": 0,
      "total": 25
    },
    "table-tennis": {
      "live": 26,
      "total": 1226
    },
    "american-football": {
      "live": 0,
      "total": 2
    },
    "aussie-rules": {
      "live": 0,
      "total": 1
    },
    "floorball": {
      "live": 0,
      "total": 2
    },
    "football": {
      "live": 83,
      "total": 862
    },
    "tennis": {
      "live": 48,
      "total": 426
    },
    "baseball": {
      "live": 0,
      "total": 29
    },
    "basketball": {
      "live": 2,
      "total": 83
    },
    "padel": {
      "live": 0,
      "total": 51
    },
    "handball": {
      "live": 2,
      "total": 38
    },
    "cricket": {
      "live": 12,
      "total": 25
    },
    "rugby": {
      "live": 0,
      "total": 2
    },
    "waterpolo": {
      "live": 0,
      "total": 7
    },
    "esports": {
      "live": 15,
      "total": 87
    },
    "volleyball": {
      "live": 1,
      "total": 46
    }
  }
}

Countries & Categories

All Countries

GET /api/countries

Returns all countries with basic info (name, code, flag URL).

Example response

Recorded 24 September 2026 from GET /v2/football/countries (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "categories": [
      {
        "name": "England",
        "slug": "england",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "priority": 10,
        "id": 1,
        "flag": "england",
        "alpha2": "EN",
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "إنجلترا",
            "bn": "ইংল্যান্ড",
            "hi": "इंग्लैंड",
            "ru": "Англия"
          },
          "shortNameTranslation": {}
        }
      },
      {
        "name": "Afghanistan",
        "slug": "afghanistan",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "priority": 0,
        "id": 1084,
        "flag": "afghanistan",
        "alpha2": "AF",
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "أفغانستان",
            "ru": "Афганистан"
          },
          "shortNameTranslation": {}
        }
      }
    ]
  }
}

All Countries (Extended)

GET /api/countries/all

Returns all countries with subcategories and additional metadata.

Example response

Recorded 24 September 2026 from GET /v2/football/countries/all (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "categories": [
      {
        "name": "Virtual Leagues",
        "slug": "virtual-leagues",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "priority": 0,
        "id": 1156,
        "flag": "virtual-leagues",
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "الدوريات الافتراضية",
            "ru": "Виртуальные лиги"
          },
          "shortNameTranslation": {}
        }
      },
      {
        "name": "Zanzibar",
        "slug": "zanzibar",
        "sport": {
          "name": "Football",
          "slug": "football",
          "id": 1
        },
        "priority": 0,
        "id": 1159,
        "flag": "zanzibar",
        "fieldTranslations": {
          "nameTranslation": {
            "ar": "زانزيبار",
            "ru": "Занзибар"
          },
          "shortNameTranslation": {}
        }
      }
    ]
  }
}

Category Tournaments

GET /api/categories/{categoryId}/tournaments

Returns all tournaments within a specific category (country or region).

number

required

Category ID from the countries endpoint.

Example response

Recorded 24 September 2026 from GET /v2/football/categories/30/tournaments (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "groups": [
      {
        "uniqueTournaments": [
          {
            "name": "Bundesliga",
            "slug": "bundesliga",
            "primaryColorHex": "#e2080e",
            "secondaryColorHex": "#8e0902",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 565701,
            "liveActivityEnabled": true,
            "id": 35,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني",
                "bn": "বুন্দেসলীগা",
                "hi": "बुंडेसलीगा",
                "ru": "Бундеслига"
              },
              "shortNameTranslation": {}
            }
          },
          {
            "name": "2. Bundesliga",
            "slug": "2-bundesliga",
            "primaryColorHex": "#919292",
            "secondaryColorHex": "#d20616",
            "category": {
              "name": "Germany",
              "slug": "germany",
              "sport": {
                "name": "Football",
                "slug": "football",
                "id": 1
              },
              "priority": 8,
              "id": 30,
              "flag": "germany",
              "alpha2": "DE",
              "fieldTranslations": {
                "nameTranslation": {
                  "ar": "ألمانيا",
                  "bn": "জার্মানি",
                  "hi": "जर्मनी",
                  "ru": "Германия"
                },
                "shortNameTranslation": {}
              }
            },
            "userCount": 57928,
            "liveActivityEnabled": true,
            "id": 44,
            "displayInverseHomeAwayTeams": false,
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "الدوري الألماني الدرجة الثانية",
                "bn": "2. বুন্দেসলিগা",
                "hi": "2. बुंडेसलीगा",
                "ru": "Бундеслига 2"
              },
              "shortNameTranslation": {}
            }
          }
        ]
      }
    ]
  }
}

Country Flag

GET /api/country/{code}/flag

Returns the flag image URL for a country code.

string

required

Two-letter country code in uppercase (e.g., GB, US, DE).

Leagues

All Leagues

GET /api/leagues?country={country}&refresh={refresh}

Returns all leagues grouped by country. Useful for building a competition browser.

string

Optional country slug to filter leagues (e.g., england, spain).

boolean

Set to true to bypass cache and get fresh data.

All Tournaments (Flat)

GET /api/tournaments?refresh={refresh}

Returns all tournaments as a flat list (not grouped by country).

Tournament Seasons

GET /api/tournaments/{id}/seasons

Returns all available seasons for a tournament. See Tournament Endpoints for season-specific data.

Country Detection

GET /api/country/detect

Returns the detected country based on the requester’s IP address. Useful for geolocation-based content.

Example response

Recorded 24 September 2026 from GET /v2/football/country/detect (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "alpha2": "GB",
    "continent_code": "EU",
    "country": "united kingdom",
    "city": "birmingham",
    "ip": "86.136.59.245",
    "f": "t13d1516h2_8daaf6152771_02713d6af862",
    "region_code": "GB-BIR"
  }
}

Fantasy

Fantasy Competitions

GET /api/fantasy/competitions

Returns a list of active fantasy competitions. Use the returned competition IDs for fantasy-specific endpoints.

Example response

Recorded 24 September 2026 from GET /v2/football/fantasy/competitions (lists trimmed to 2 items).

{
  "success": true,
  "data": {
    "competitions": [
      {
        "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,
            "id": 1,
            "flag": "england",
            "alpha2": "EN",
            "fieldTranslations": {
              "nameTranslation": {
                "ar": "إنجلترا",
                "bn": "ইংল্যান্ড",
                "hi": "इंग्लैंड",
                "ru": "Англия"
              },
              "shortNameTranslation": {}
            }
          },
          "userCount": 1307192,
          "liveActivityEnabled": true,
          "id": 17,
          "displayInverseHomeAwayTeams": false,
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "الدوري الإنجليزي الممتاز",
              "bn": "প্রিমিয়ার লীগ",
              "hi": "प्रिमियर लीग",
              "ru": "Премьер-лига"
            },
            "shortNameTranslation": {}
          }
        },
        "season": {
          "name": "Premier League 26/27",
          "year": "26/27",
          "editor": false,
          "id": 96668
        },
        "type": 1,
        "category": {
          "name": "England",
          "slug": "england",
          "sport": {
            "name": "Football",
            "slug": "football",
            "id": 1
          },
          "priority": 10,
          "id": 1,
          "flag": "england",
          "alpha2": "EN",
          "fieldTranslations": {
            "nameTranslation": {
              "ar": "إنجلترا",
              "bn": "ইংল্যান্ড",
              "hi": "इंग्लैंड",
              "ru": "Англия"
            },
            "shortNameTranslation": {}
          }
        },
        "name": "Premier League",
        "competitionColor": "#A64AF4",
        "rules": "https://www.provider.com",
        "prize": "https://www.provider.com",
        "sponsor": "https://www.provider.com",
        "totalPlayers": 204455,
        "active": true,
        "currentRound": {
          "name": "Round 6",
          "sequence": 6,
          "isPlaceholderRound": false,
          "isRevealed": true,
          "isFinalized": false,
          "onlyActiveTeams": false,
          "rebuildSquadActive": false,
          "freeTransfers": 1,
          "freeTransfersGain": 1,
          "freeTransfersLimit": 5,
          "freeTransfersMinimum": 2,
          "maxPlayersFromSameTeam": 3,
          "id": 1121,
          "startTimestamp": 1790004600,
          "endTimestamp": 1791918000,
          "deadlineTimestamp": 1791630000,
          "revealTimestamp": 1787639100,
          "averageScore": 0,
          "highScore": 0,
          "fantasyCompetitionId": 163,
          "changeable": true,
          "maxPointsUserAccountId": "63e74b1e75ee99b9130a7353"
        },
        "nextRound": {
          "name": "Round 7",
          "sequence": 7,
          "isPlaceholderRound": false,
          "isRevealed": true,
          "isFinalized": false,
          "onlyActiveTeams": false,
          "rebuildSquadActive": false,
          "freeTransfers": 1,
          "freeTransfersGain": 1,
          "freeTransfersLimit": 5,
          "freeTransfersMinimum": 2,
          "maxPlayersFromSameTeam": 3,
          "id": 1122,
          "startTimestamp": 1791918000,
          "endTimestamp": 1792522800,
          "deadlineTimestamp": 1792234800,
          "revealTimestamp": 1787639160,
          "averageScore": 0,
          "highScore": 0,
          "fantasyCompetitionId": 163,
          "changeable": true
        },
        "previousRound": {
          "name": "Round 5",
          "sequence": 5,
          "isPlaceholderRound": false,
          "isRevealed": true,
          "isFinalized": true,
          "onlyActiveTeams": false,
          "rebuildSquadActive": false,
          "freeTransfers": 1,
          "freeTransfersGain": 1,
          "freeTransfersLimit": 5,
          "freeTransfersMinimum": 2,
          "maxPlayersFromSameTeam": 3,
          "id": 1090,
          "startTimestamp": 1789498800,
          "endTimestamp": 1790004600,
          "deadlineTimestamp": 1789756200,
          "revealTimestamp": 1786344240,
          "averageScore": 52.6,
          "highScore": 129,
          "fantasyCompetitionId": 163,
          "changeable": true,
          "maxPointsUserAccountId": "66aad008409c37b651246766"
        },
        "averageScore": 235.52,
        "finished": false,
        "isAlpha": false,
        "roundCountOverride": 38,
        "countries": [
          "AF"
        ],
        "wildcardRenewalSequence": 20,
        "freeHitRenewalSequence": 20,
        "tripleCaptainAllowed": true,
        "wildcardAllowed": true,
        "freeHitAllowed": true,
        "comingSoon": false,
        "...": "11 more fields"
      }
    ]
  }
}

News

Sports News

GET /api/news?lang={lang}

Returns the latest sports news articles.

string

default:"en"

Language code (e.g., en, es, de, fr, pt, it).

Example response

Recorded 24 September 2026 from GET /v2/football/news?lang=en (lists trimmed to 2 items).

{
  "success": true,
  "data": [
    {
      "id": 148604,
      "slug": "antony-on-the-provider-podcast-betis-the-favela-and-life-after-manchester-united",
      "date": "2026-09-24T16:04:00",
      "title": "Antony on the provider Podcast: Betis, the Favela and Life After Manchester United",
      "excerpt": "Antony joins the provider Podcast to talk about his Real Betis revival, the favela that shaped him, Manchester United and his provider Player of the Season a...",
      "imageUrl": "https://files.provider.com/news/2026/09/Antony-podcast-featured-1024x576.jpg",
      "tags": [
        {
          "id": 11405,
          "slug": "antony-en",
          "name": "Antony"
        },
        {
          "id": 11326,
          "slug": "betis",
          "name": "betis"
        }
      ],
      "categories": [
        {
          "id": 18063,
          "slug": "business",
          "name": "Business",
          "level": 2
        },
        {
          "id": 17523,
          "slug": "football",
          "name": "Football",
          "level": 2
        }
      ]
    },
    {
      "id": 148602,
      "slug": "antony-full-interview-it-was-because-of-the-favela-that-i-became-the-antony-i-am-today",
      "date": "2026-09-24T16:02:00",
      "title": "Antony, full interview: “It was because of the favela that I became the Antony I am today”",
      "excerpt": "In the provider Podcast, Antony opens up about his Real Betis revival, growing up in a favela, life at Manchester United and his best night for Brazil.",
      "imageUrl": "https://files.provider.com/news/2026/09/Antony-podcast-featured-2-1024x576.jpg",
      "tags": [
        {
          "id": 11405,
          "slug": "antony-en",
          "name": "Antony"
        },
        {
          "id": 11326,
          "slug": "betis",
          "name": "betis"
        }
      ],
      "categories": [
        {
          "id": 17523,
          "slug": "football",
          "name": "Football",
          "level": 2
        },
        {
          "id": 17467,
          "slug": "sport",
          "name": "Sport",
          "level": 1
        }
      ]
    }
  ]
}

Example Requests

# Search for a team
curl -X GET "https://api.sportsapipro.com/v2/football/search?q=arsenal" \
  -H "x-api-key: YOUR_API_KEY"

# Get today's schedule
curl -X GET "https://api.sportsapipro.com/v2/football/schedule/2025-03-15" \
  -H "x-api-key: YOUR_API_KEY"

// Search for a team
const results = await fetch(
  'https://api.sportsapipro.com/v2/football/search?q=arsenal',
  { headers: { 'x-api-key': 'YOUR_API_KEY' } }
).then(r => r.json());

import requests

headers = {'x-api-key': 'YOUR_API_KEY'}

# Search for a team
results = requests.get(
    'https://api.sportsapipro.com/v2/football/search?q=arsenal',
    headers=headers
).json()

Country config

GET /api/config/default-tournaments/{countryCode}/{sport}
GET /api/config/top-tournaments/{countryCode}/{sport}

Default and top competitions for a country. Country codes are case-insensitive (GB or gb).

Verified 25 September 2026: GB/football returns 20 default and 15 top tournaments.

Seasons address

Both /api/tournaments/{id}/seasons and /api/tournament/{id}/seasons work on every V2 sport. The plural form is recommended.

​Base URL

​Live Data

​Live Scores

​All Live Events

​Today’s Matches

​Trending Events

​Trending Players

​Live Tournaments

​Newly Added Events

​Search

​Search All

​Schedule

​Events by Date

​Scheduled Tournaments by Date

​Event Count

​Countries & Categories

​All Countries

​All Countries (Extended)

​Category Tournaments

​Country Flag

​Leagues

​All Leagues

​All Tournaments (Flat)

​Tournament Seasons

​Country Detection

​Fantasy

​Fantasy Competitions

​News

​Sports News

​Example Requests

​Country config

​Seasons address

Base URL

Live Data

Live Scores

All Live Events

Today’s Matches

Trending Events

Trending Players

Live Tournaments

Newly Added Events

Search

Search All

Schedule

Events by Date

Scheduled Tournaments by Date

Event Count

Countries & Categories

All Countries

All Countries (Extended)

Category Tournaments

Country Flag

Leagues

All Leagues

All Tournaments (Flat)

Tournament Seasons

Country Detection

Fantasy

Fantasy Competitions

News

Sports News

Example Requests

Country config

Seasons address