Competition Details
Endpoint Description
This API endpoint retrieves detailed information about a specific football competition based on the provided tournament identifier (:tid).
HTTP Method
GET
Endpoint
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid
Request Parameters
:tid(Path Parameter): The unique identifier for the tournament you want to retrieve information for. This should be replaced with the actual tournament ID.
Response Fields
status: Indicates the success of the request.statusCode: A numerical code representing the status of the response.message: Additional information about the response.response: Contains detailed information about the competition, including:name: Name of the competition.category: Details about the category of the competition.titleHolder: Information about the current title holder.mostTitlesTeams: Teams with the most titles in the competition.seasons: List of seasons associated with the competition.featuredMatch: Details of featured matches within the competition.
This endpoint provides comprehensive details about a specific football competition, including its structure, title holders, historical data, and current season information.
7OK
GET /football/api/v1/competitions/{tid} HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": {
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"titleHolder": {
"name": "Paris Saint-Germain",
"shortName": "PSG",
"gender": "M",
"nameCode": "PSG",
"disabled": false,
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"name": "France"
}
},
"titleHolderTitles": 1,
"mostTitles": 15,
"mostTitlesTeams": [
{
"name": "Real Madrid",
"shortName": "Real Madrid",
"gender": "M",
"nameCode": "RMA",
"disabled": false,
"national": false,
"type": 0,
"id": 2829,
"country": {
"alpha2": "ES",
"name": "Spain"
}
}
],
"linkedUniqueTournaments": [],
"hasRounds": true,
"hasGroups": true,
"hasPlayoffSeries": false,
"upperDivisions": [],
"lowerDivisions": [],
"hasPerformanceGraphFeature": false,
"periodLength": {},
"gender": "M",
"id": 7,
"country": {},
"startDateTimestamp": 1751932800,
"endDateTimestamp": 1780185600,
"disabledHomeAwayStandings": false,
"displayInverseHomeAwayTeams": false,
"otherInfo": {
"firstSeasonWinnerName": "Real Madrid",
"largestStadium": {
"teamName": "Barcelona",
"capacity": 99354
},
"lastSeasonTopScorers": [
{
"name": "Kylian Mbappé",
"goals": 8
},
{
"name": "Harry Kane",
"goals": 8
}
],
"allTimeTopScorers": [
{
"name": "Cristiano Ronaldo",
"goals": 128
},
{
"name": "Lionel Messi",
"goals": 129
},
{
"name": "Robert Lewandowski",
"goals": 91
}
],
"gender": "M",
"firstSeasonYear": "1955",
"mostTitlesNames": [
"Real Madrid"
]
},
"seasons": [
{
"name": "UEFA Champions League 25/26",
"year": "25/26",
"id": 76953
},
{
"name": "UEFA Champions League 24/25",
"year": "24/25",
"seasonCoverageInfo": {},
"id": 61644
},
{
"name": "UEFA Champions League 23/24",
"year": "23/24",
"seasonCoverageInfo": {},
"id": 52162
},
{
"name": "UEFA Champions League 22/23",
"year": "22/23",
"seasonCoverageInfo": {},
"id": 41897
},
{
"name": "UEFA Champions League 21/22",
"year": "21/22",
"id": 36886
},
{
"name": "UEFA Champions League 20/21",
"year": "20/21",
"id": 29267
},
{
"name": "UEFA Champions League 19/20",
"year": "19/20",
"id": 23766
},
{
"name": "UEFA Champions League 18/19",
"year": "18/19",
"id": 17351
},
{
"name": "UEFA Champions League 17/18",
"year": "17/18",
"id": 13415
},
{
"name": "UEFA Champions League 16/17",
"year": "16/17",
"id": 11773
},
{
"name": "UEFA Champions League 15/16",
"year": "15/16",
"id": 10390
},
{
"name": "Champions League 14/15",
"year": "14/15",
"id": 8226
},
{
"name": "Champions League 13/14",
"year": "13/14",
"id": 6359
},
{
"name": "UEFA Champions League 12/13",
"year": "12/13",
"id": 4788
},
{
"name": "Champions League 11/12",
"year": "11/12",
"id": 3402
},
{
"name": "Champions League 10/11",
"year": "10/11",
"id": 2764
},
{
"name": "Champions League 09/10",
"year": "09/10",
"id": 1825
},
{
"name": "Champions League 08/09",
"year": "08/09",
"id": 1664
},
{
"name": "Champions League 07/08",
"year": "07/08",
"id": 603
},
{
"name": "Champions League 06/07",
"year": "06/07",
"id": 15
},
{
"name": "Champions League 05/06",
"year": "05/06",
"id": 14
},
{
"name": "Champions League 04/05",
"year": "04/05",
"id": 13
},
{
"name": "Champions League 03/04",
"year": "03/04",
"id": 12
}
],
"featuredMatch": [
{
"tournamentId": 1339,
"id": 14241443,
"startTimestamp": 1755014400,
"detailId": 4,
"season": {
"name": "UEFA Champions League 25/26",
"year": "25/26",
"id": 76953
},
"roundInfo": {
"round": 3,
"name": "Qualification Round 3"
},
"status": {
"code": 0,
"description": "Not started",
"type": "notstarted"
},
"homeTeam": {
"name": "Qarabağ",
"shortName": "Qarabağ",
"gender": "M",
"nameCode": "QAR",
"disabled": false,
"national": false,
"type": 0,
"id": 5962,
"country": {
"alpha2": "AZ",
"alpha3": "AZE",
"name": "Azerbaijan"
},
"subTeams": []
},
"homeScore": {
"aggregated": 1
},
"awayTeam": {
"name": "KF Shkëndija",
"shortName": "Shkëndija",
"gender": "M",
"nameCode": "SHK",
"national": false,
"type": 0,
"id": 5413,
"country": {
"alpha2": "MK",
"alpha3": "MKD",
"name": "North Macedonia"
},
"subTeams": []
},
"awayScore": {
"aggregated": 0
},
"time": {},
"tournament": {
"id": 1339,
"name": "UEFA Champions League, Qualification",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"details": {
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"hasPerformanceGraphFeature": false,
"id": 7,
"country": {},
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
}
}
]
}
}Endpoint Description
This endpoint retrieves featured matches for a specific tournament in the football API. It allows users to access detailed information about ongoing or upcoming matches within a specified tournament.
Request
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/featured
Path Parameters
:tid(required): The unique identifier for the tournament. This parameter specifies which tournament's featured matches are being requested.
Expected Response
The response will return a JSON object containing the following structure:
status: A boolean indicating the success of the request.
statusCode: An integer representing the status code of the response.
message: A string providing additional information about the request status (if any).
response: An array of featured match objects, each containing:
tournamentId: The ID of the tournament.
id: The unique ID of the match.
startTimestamp: The start time of the match in Unix timestamp format.
detailId: An identifier for detailed match information.
season: An object containing:
name: The name of the season.
year: The year of the season.
id: The ID of the season.
roundInfo: An object providing details about the round:
round: The round number.
name: The name of the round.
status: An object with match status details:
code: The status code.
description: A textual description of the status.
type: The type of status.
homeTeam: An object containing details about the home team, including:
name: The name of the team.
shortName: The abbreviated name of the team.
gender: The gender category of the team.
nameCode: The code used for the team's name.
disabled: A boolean indicating if the team is disabled.
national: A boolean indicating if the team is a national team.
type: The type of team (e.g., club, national).
id: The unique ID of the team.
country: An object containing country details.
subTeams: An array of sub-teams, if applicable.
homeScore: An object containing aggregated score information for the home team.
awayTeam: Similar structure as homeTeam, but for the away team.
awayScore: An object containing aggregated score information for the away team.
time: An object with timing information for the match.
tournament: An object containing tournament details, including:
id: The ID of the tournament.
name: The name of the tournament.
category: An object with category details.
details: An object with additional tournament details.
Additional Notes
Ensure that the
:tidparameter is correctly replaced with a valid tournament ID to receive the appropriate data.The response may include multiple featured matches, depending on the tournament and its scheduling.
7OK
GET /football/api/v1/competitions/{tid}/featured HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"tournamentId": 1339,
"id": 14241443,
"startTimestamp": 1755014400,
"detailId": 4,
"season": {
"name": "UEFA Champions League 25/26",
"year": "25/26",
"id": 76953
},
"roundInfo": {
"round": 3,
"name": "Qualification Round 3"
},
"status": {
"code": 0,
"description": "Not started",
"type": "notstarted"
},
"homeTeam": {
"name": "Qarabağ",
"shortName": "Qarabağ",
"gender": "M",
"nameCode": "QAR",
"disabled": false,
"national": false,
"type": 0,
"id": 5962,
"country": {
"alpha2": "AZ",
"alpha3": "AZE",
"name": "Azerbaijan"
},
"subTeams": []
},
"homeScore": {
"aggregated": 1
},
"awayTeam": {
"name": "KF Shkëndija",
"shortName": "Shkëndija",
"gender": "M",
"nameCode": "SHK",
"national": false,
"type": 0,
"id": 5413,
"country": {
"alpha2": "MK",
"alpha3": "MKD",
"name": "North Macedonia"
},
"subTeams": []
},
"awayScore": {
"aggregated": 0
},
"time": {},
"tournament": {
"id": 1339,
"name": "UEFA Champions League, Qualification",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"details": {
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"hasPerformanceGraphFeature": false,
"id": 7,
"country": {},
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
}
}
]
}Endpoint Description
This endpoint retrieves detailed information about a specific football competition for a given season. It allows users to access various statistics related to the competition, including team performance metrics.
Request
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/info
Path Parameters
:tid(string): The unique identifier for the tournament.:sid(string): The unique identifier for the season.
Response
The response will return a JSON object containing the following fields:
status (boolean): Indicates whether the request was successful.
statusCode (integer): The status code of the response.
message (string): A message related to the request status.
response (object): Contains detailed statistics for the competition:
goals (integer): Total number of goals scored.
homeTeamWins (integer): Total number of wins by home teams.
awayTeamWins (integer): Total number of wins by away teams.
draws (integer): Total number of drawn matches.
yellowCards (integer): Total number of yellow cards issued.
redCards (integer): Total number of red cards issued.
newcomersUpperDivision (array): List of newcomers in the upper division.
newcomersLowerDivision (array): List of newcomers in the lower division.
newcomersOther (array): List of newcomers in other divisions.
numberOfCompetitors (integer): Total number of competitors in the competition.
id (integer): Unique identifier for the competition.
hostCountries (array): List of countries hosting the competition.
This structure allows clients to easily interpret the competition's performance and statistics for the specified season.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/info HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": {
"goals": 885,
"homeTeamWins": 139,
"awayTeamWins": 95,
"draws": 45,
"yellowCards": 886,
"redCards": 41,
"newcomersUpperDivision": [],
"newcomersLowerDivision": [],
"newcomersOther": [],
"numberOfCompetitors": 36,
"id": 35830,
"hostCountries": []
}
}Endpoint Description
This endpoint retrieves a list of matches for a specific tournament and season in the football API. It provides detailed information about each match, including team details, scores, and tournament information.
Request
HTTP Method: GET
Endpoint: https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/matches
Path Parameters
:tid(Tournament ID): The unique identifier for the tournament.:sid(Season ID): The unique identifier for the season within the tournament.
Response
The response will return a JSON object containing the following structure:
status (boolean): Indicates the success of the request.
statusCode (integer): A code representing the status of the request.
message (string): A message providing additional information about the request.
response (array): An array of match objects, each containing:
tournamentId (integer): The ID of the tournament.
id (integer): The unique identifier for the match.
startTimestamp (integer): The start time of the match in timestamp format.
detailId (integer): An identifier for match details.
season (object): Contains season information including:
name (string): The name of the season.
year (string): The year of the season.
seasonCoverageInfo (object): Additional coverage information for the season.
id (integer): The unique identifier for the season.
roundInfo (object): Information about the round of the match including:
round (integer): The round number.
name (string): The name of the round.
status (object): Current status of the match including:
code (integer): Status code.
description (string): Description of the status.
type (string): Type of status.
homeTeam (object): Details of the home team including:
name, shortName, gender, nameCode, disabled, national, type, id, country (object), subTeams (array).
homeScore (object): Current score details for the home team including:
current, display, period1, period2, normaltime (all integers).
awayTeam (object): Details of the away team (same structure as homeTeam).
awayScore (object): Current score details for the away team (same structure as homeScore).
time (object): Information about the current period start timestamp.
tournament (object): Information about the tournament including:
id, name, category (object), details (object).
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/matches HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"tournamentId": 1339,
"id": 12438131,
"startTimestamp": 1720539000,
"detailId": 4,
"season": {
"name": "UEFA Champions League 24/25",
"year": "24/25",
"seasonCoverageInfo": {},
"id": 61644
},
"roundInfo": {
"round": 1,
"name": "Qualification Round 1"
},
"status": {
"code": 100,
"description": "Ended",
"type": "finished"
},
"homeTeam": {
"name": "FK Panevėžys",
"shortName": "Panevėžys",
"gender": "M",
"nameCode": "PAN",
"disabled": false,
"national": false,
"type": 0,
"id": 192763,
"country": {
"alpha2": "LT",
"alpha3": "LTU",
"name": "Lithuania"
},
"subTeams": []
},
"homeScore": {
"current": 3,
"display": 3,
"period1": 1,
"period2": 2,
"normaltime": 3
},
"awayTeam": {
"name": "HJK",
"shortName": "HJK",
"gender": "M",
"nameCode": "HJK",
"disabled": false,
"national": false,
"type": 0,
"id": 2242,
"country": {
"alpha2": "FI",
"alpha3": "FIN",
"name": "Finland"
},
"subTeams": []
},
"awayScore": {
"current": 0,
"display": 0,
"period1": 0,
"period2": 0,
"normaltime": 0
},
"time": {
"currentPeriodStartTimestamp": 1720542725
},
"tournament": {
"id": 1339,
"name": "UEFA Champions League, Qualification",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"details": {
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"hasPerformanceGraphFeature": false,
"id": 7,
"country": {},
"hasEventPlayerStatistics": true,
"displayInverseHomeAwayTeams": false
}
}
}
]
}Endpoint Description
This endpoint retrieves the standings for a specific tournament and season in football. It provides detailed information about the teams participating in the tournament, including their performance metrics.
Request
Method: GET
URL:
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/standings
Path Parameters
:tid(Tournament ID): The unique identifier for the tournament whose standings are being requested.:sid(Season ID): The unique identifier for the season of the tournament.
Response
The response is a JSON object containing the following structure:
status(boolean): Indicates whether the request was successful.statusCode(integer): The status code of the response.message(string): A message providing additional information about the request.response(array): An array containing the standings for the specified tournament and season, structured as follows:id(integer): The unique identifier for the standings entry.type(string): The type of standings.name(string): The name of the standings.standings(array): An array of team standings, with each entry containing:team(object): Information about the team, including:name(string): The full name of the team.shortName(string): The abbreviated name of the team.gender(string): The gender category of the team.nameCode(string): A code representing the team name.disabled(boolean): Indicates if the team is disabled.national(boolean): Indicates if the team is a national team.type(integer): The type of team.id(integer): The unique identifier for the team.country(object): Information about the team's country, including:alpha2(string): The 2-letter country code.alpha3(string): The 3-letter country code.name(string): The name of the country.
descriptions(array): Additional descriptions related to the team's standings.promotion(object): Information about promotion, including:text(string): Text related to promotion.id(integer): The identifier for the promotion.
position(integer): The position of the team in the standings.matches(integer): The number of matches played.wins(integer): The number of wins.scoresFor(integer): The total scores for the team.scoresAgainst(integer): The total scores against the team.id(integer): The unique identifier for the standings entry.losses(integer): The number of losses.draws(integer): The number of draws.points(integer): The total points accumulated.scoreDiffFormatted(string): A formatted string representing the score difference.
tournament(object): Information about the tournament, including:id(integer): The unique identifier for the tournament.name(string): The name of the tournament.category(object): Information about the category of the tournament, including:name(string): The name of the category.id(integer): The unique identifier for the category.country(object): Information about the country associated with the category.flag(string): The flag associated with the category.
details(object): Additional details about the tournament, including:name(string): The name of the tournament details.category(object): The category information.hasPerformanceGraphFeature(boolean): Indicates if the tournament has a performance graph feature.id(integer): The unique identifier for the tournament details.country(object): Information about the country associated with the tournament.displayInverseHomeAwayTeams(boolean): Indicates if home and away teams should be displayed inversely.
updatedAtTimestamp(integer): The timestamp of the last update for the standings.
This endpoint is essential for retrieving current standings and performance metrics for teams in a specified tournament and season.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/standings HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"id": 136527,
"type": "total",
"name": "UEFA Champions League",
"standings": [
{
"team": {
"name": "Liverpool",
"shortName": "Liverpool",
"gender": "M",
"nameCode": "LIV",
"disabled": false,
"national": false,
"type": 0,
"id": 44,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"descriptions": [],
"promotion": {
"text": "Playoffs",
"id": 6
},
"position": 1,
"matches": 8,
"wins": 7,
"scoresFor": 17,
"scoresAgainst": 5,
"id": 1255859,
"losses": 1,
"draws": 0,
"points": 21,
"scoreDiffFormatted": "+12"
}
],
"tournament": {
"id": 138314,
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"details": {
"name": "UEFA Champions League",
"category": {
"name": "Europe",
"id": 1465,
"country": {},
"flag": "europe"
},
"hasPerformanceGraphFeature": false,
"id": 7,
"country": {},
"displayInverseHomeAwayTeams": false
}
},
"updatedAtTimestamp": 1726612573
}
]
}Get Top Players by Competition and Season
This endpoint retrieves a list of top players for a specific football competition and season.
Request Method
GET
Endpoint
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/top-players
Path Parameters
:tid(string): The unique identifier for the football competition.:sid(string): The unique identifier for the season of the competition.
Expected Response Format
On a successful request, the API will return a JSON object containing the top players for the specified competition and season. The response will include details such as player names, positions, and performance statistics.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/top-players HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": {
"rating": [
{
"statistics": {
"rating": 8.2428571428571,
"id": 1595397,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Raphinha",
"shortName": "Raphinha",
"position": "M",
"id": 831005
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}
],
"goals": [
{
"statistics": {
"goals": 13,
"id": 1595397,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Raphinha",
"shortName": "Raphinha",
"position": "M",
"id": 831005
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}
],
"expectedGoals": [
{
"statistics": {
"goals": 13,
"expectedGoals": 12.2577,
"id": 1593949,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Serhou Guirassy",
"shortName": "S. Guirassy",
"position": "F",
"id": 328027
},
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673
}
}],
"assists": [
{
"statistics": {
"assists": 8,
"id": 1595397,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Raphinha",
"shortName": "Raphinha",
"position": "M",
"id": 831005
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}],
"expectedAssists": [
{
"statistics": {
"assists": 2,
"expectedAssists": 4.9563472,
"id": 1592324,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Michael Olise",
"shortName": "M. Olise",
"position": "M",
"id": 978838
},
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672
}
}],
"goalsAssistsSum": [
{
"statistics": {
"goalsAssistsSum": 21,
"id": 1595397,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Raphinha",
"shortName": "Raphinha",
"position": "M",
"id": 831005
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}],
"penaltyGoals": [
{
"statistics": {
"penaltiesTaken": 6,
"penaltyGoals": 5,
"id": 1593949,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Serhou Guirassy",
"shortName": "S. Guirassy",
"position": "F",
"id": 328027
},
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673
}
}],
"freeKickGoal": [
{
"statistics": {
"shotFromSetPiece": 3,
"freeKickGoal": 2,
"id": 1595220,
"type": "overall",
"appearances": 13
},
"playedEnough": true,
"player": {
"name": "Declan Rice",
"shortName": "D. Rice",
"position": "M",
"id": 856714
},
"team": {
"name": "Arsenal",
"gender": "M",
"national": false,
"type": 0,
"id": 42
}
}],
"scoringFrequency": [
{
"statistics": {
"scoringFrequency": 70.333333333333,
"id": 1677305,
"type": "overall",
"appearances": 12
},
"playedEnough": true,
"player": {
"name": "Gonçalo Ramos",
"shortName": "G. Ramos",
"position": "F",
"id": 934510
},
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644
}
}],
"totalShots": [
{
"statistics": {
"totalShots": 39,
"id": 1593892,
"type": "overall",
"appearances": 9
},
"playedEnough": true,
"player": {
"name": "Erling Haaland",
"shortName": "E. Haaland",
"position": "F",
"id": 839956
},
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17
}
}
],
"shotsOnTarget": [
{
"statistics": {
"shotsOnTarget": 21,
"id": 1593892,
"type": "overall",
"appearances": 9
},
"playedEnough": true,
"player": {
"name": "Erling Haaland",
"shortName": "E. Haaland",
"position": "F",
"id": 839956
},
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17
}
}
],
"bigChancesMissed": [
{
"statistics": {
"bigChancesMissed": 12,
"id": 1594080,
"type": "overall",
"appearances": 17
},
"playedEnough": true,
"player": {
"name": "Bradley Barcola",
"shortName": "B. Barcola",
"position": "F",
"id": 996952
},
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644
}
}
],
"bigChancesCreated": [
{
"statistics": {
"bigChancesCreated": 13,
"id": 1595397,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Raphinha",
"shortName": "Raphinha",
"position": "M",
"id": 831005
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}
],
"accuratePasses": [
{
"statistics": {
"accuratePasses": 1158,
"accuratePassesPercentage": 91.686460807601,
"id": 1592311,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Joshua Kimmich",
"shortName": "J. Kimmich",
"position": "M",
"id": 259117
},
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672
}
}
],
"keyPasses": [
{
"statistics": {
"keyPasses": 23,
"id": 1595241,
"type": "overall",
"appearances": 8
},
"playedEnough": true,
"player": {
"name": "Lazar Samardžić",
"shortName": "L. Samardžić",
"position": "M",
"id": 980624
},
"team": {
"name": "Atalanta",
"gender": "M",
"national": false,
"type": 0,
"id": 2686
}
}
],
"accurateLongBalls": [
{
"statistics": {
"accurateLongBalls": 94,
"id": 1593971,
"type": "overall",
"appearances": 12
},
"playedEnough": true,
"player": {
"name": "Nico Schlotterbeck",
"shortName": "N. Schlotterbeck",
"position": "D",
"id": 940871
},
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673
}
}
],
"successfulDribbles": [
{
"statistics": {
"successfulDribbles": 56,
"successfulDribblesPercentage": 58.333333333333,
"id": 1595387,
"type": "overall",
"appearances": 13
},
"playedEnough": true,
"player": {
"name": "Lamine Yamal",
"shortName": "L. Yamal",
"position": "M",
"id": 1402912
},
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817
}
}
],
"penaltyWon": [
{
"statistics": {
"penaltyWon": 3,
"id": 1593949,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Serhou Guirassy",
"shortName": "S. Guirassy",
"position": "F",
"id": 328027
},
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673
}
}
],
"tackles": [
{
"statistics": {
"tackles": 38,
"id": 1595099,
"type": "overall",
"appearances": 9
},
"playedEnough": true,
"player": {
"name": "Florentino Luís",
"shortName": "F. Luís",
"position": "M",
"id": 855845
},
"team": {
"name": "Benfica",
"gender": "M",
"national": false,
"type": 0,
"id": 3006
}
}
],
"interceptions": [
{
"statistics": {
"interceptions": 21,
"id": 1595099,
"type": "overall",
"appearances": 9
},
"playedEnough": true,
"player": {
"name": "Florentino Luís",
"shortName": "F. Luís",
"position": "M",
"id": 855845
},
"team": {
"name": "Benfica",
"gender": "M",
"national": false,
"type": 0,
"id": 3006
}
}
],
"clearances": [
{
"statistics": {
"clearances": 59,
"id": 1593859,
"type": "overall",
"appearances": 8
},
"playedEnough": true,
"player": {
"name": "Guram Kashia",
"shortName": "G. Kashia",
"position": "D",
"id": 43136
},
"team": {
"name": "ŠK Slovan Bratislava",
"gender": "M",
"national": false,
"type": 0,
"id": 2404
}
}
],
"possessionLost": [
{
"statistics": {
"possessionLost": 228,
"id": 1592452,
"type": "overall",
"appearances": 12
},
"playedEnough": true,
"player": {
"name": "Vinícius Júnior",
"shortName": "Vinícius Jr.",
"position": "F",
"id": 868812
},
"team": {
"name": "Real Madrid",
"gender": "M",
"national": false,
"type": 0,
"id": 2829
}
}
],
"yellowCards": [
{
"statistics": {
"yellowCards": 5,
"id": 1592489,
"type": "overall",
"appearances": 8
},
"playedEnough": true,
"player": {
"name": "Alexis Mac Allister",
"shortName": "A. Mac Allister",
"position": "M",
"id": 895324
},
"team": {
"name": "Liverpool",
"gender": "M",
"national": false,
"type": 0,
"id": 44
}
}
],
"redCards": [
{
"statistics": {
"redCards": 1,
"id": 1594100,
"type": "overall",
"appearances": 15
},
"playedEnough": true,
"player": {
"name": "Ousmane Dembélé",
"shortName": "O. Dembélé",
"position": "F",
"id": 818244
},
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644
}
}
],
"saves": [
{
"statistics": {
"saves": 41,
"id": 1593363,
"type": "overall",
"appearances": 8
},
"playedEnough": true,
"player": {
"name": "Peter Vindahl Jensen",
"shortName": "P. V. Jensen",
"position": "G",
"id": 814180
},
"team": {
"name": "AC Sparta Praha",
"gender": "M",
"national": false,
"type": 0,
"id": 2218
}
}
],
"goalsPrevented": [
{
"statistics": {
"goalsPrevented": 5.8922,
"id": 1595263,
"type": "overall",
"appearances": 13
},
"playedEnough": true,
"player": {
"name": "David Raya",
"shortName": "D. Raya",
"position": "G",
"id": 581310
},
"team": {
"name": "Arsenal",
"gender": "M",
"national": false,
"type": 0,
"id": 42
}
}
],
"mostConceded": [
{
"statistics": {
"goalsConceded": 27,
"id": 1593827,
"type": "overall",
"appearances": 8
},
"playedEnough": true,
"player": {
"name": "Dominik Takáč",
"shortName": "D. Takáč",
"position": "G",
"id": 886365
},
"team": {
"name": "ŠK Slovan Bratislava",
"gender": "M",
"national": false,
"type": 0,
"id": 2404
}
}
],
"leastConceded": [
{
"statistics": {
"goalsConceded": 9,
"id": 1595263,
"type": "overall",
"appearances": 13
},
"playedEnough": true,
"player": {
"name": "David Raya",
"shortName": "D. Raya",
"position": "G",
"id": 581310
},
"team": {
"name": "Arsenal",
"gender": "M",
"national": false,
"type": 0,
"id": 42
}
}
],
"cleanSheet": [
{
"statistics": {
"cleanSheet": 7,
"id": 1593883,
"type": "overall",
"appearances": 14
},
"playedEnough": true,
"player": {
"name": "Yann Sommer",
"shortName": "Y. Sommer",
"position": "G",
"id": 16206
},
"team": {
"name": "Inter",
"gender": "M",
"national": false,
"type": 0,
"id": 2697
}
}
]
}
}Get Top Teams in a Specific Competition Season
This endpoint retrieves a list of top teams for a specified competition and season. It is useful for obtaining insights into the performance of teams within a particular league or tournament.
Request Method
GET
Endpoint
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/top-teams
Path Parameters
:tid(string): The unique identifier for the competition (e.g., league or tournament).:sid(string): The unique identifier for the season within the specified competition.
Expected Response Format
The response will be in JSON format and will typically include:
A list of top teams, each containing:
teamId: The unique identifier for the team.teamName: The name of the team.points: The total points accumulated by the team in the specified season.matchesPlayed: The total number of matches played by the team.
Additional Notes
Ensure that the values for
:tidand:sidare valid to receive accurate results.This endpoint is particularly useful for sports analysts, fans, and developers looking to integrate team performance data into their applications.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/top-teams HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": {
"avgRating": [
{
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"avgRating": 7.2305785123967,
"id": 26569,
"matches": 17,
"awardedMatches": 0
}
}
],
"goalsScored": [
{
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"goalsScored": 43,
"id": 26618,
"matches": 14,
"awardedMatches": 0
}
}
],
"goalsConceded": [
{
"team": {
"name": "Liverpool",
"gender": "M",
"national": false,
"type": 0,
"id": 44,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"goalsConceded": 6,
"id": 26517,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Bologna",
"gender": "M",
"national": false,
"type": 0,
"id": 2685,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"goalsConceded": 9,
"id": 26542,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Arsenal",
"gender": "M",
"national": false,
"type": 0,
"id": 42,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"goalsConceded": 10,
"id": 26614,
"matches": 14,
"awardedMatches": 0
}
},
{
"team": {
"name": "Juventus",
"gender": "M",
"national": false,
"type": 0,
"id": 2687,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"goalsConceded": 11,
"id": 26499,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Atalanta",
"gender": "M",
"national": false,
"type": 0,
"id": 2686,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"goalsConceded": 11,
"id": 26613,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Bayer 04 Leverkusen",
"gender": "M",
"national": false,
"type": 0,
"id": 2681,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"goalsConceded": 12,
"id": 26608,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Aston Villa",
"gender": "M",
"national": false,
"type": 0,
"id": 40,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"goalsConceded": 12,
"id": 26502,
"matches": 12,
"awardedMatches": 0
}
},
{
"team": {
"name": "Milan",
"gender": "M",
"national": false,
"type": 0,
"id": 2692,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"goalsConceded": 13,
"id": 26516,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Girona FC",
"gender": "M",
"national": false,
"type": 0,
"id": 24264,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"goalsConceded": 13,
"id": 26570,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Lille",
"gender": "M",
"national": false,
"type": 0,
"id": 1643,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"goalsConceded": 13,
"id": 26513,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Atlético Madrid",
"gender": "M",
"national": false,
"type": 0,
"id": 2836,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"goalsConceded": 14,
"id": 26621,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "SK Sturm Graz",
"gender": "M",
"national": false,
"type": 0,
"id": 2051,
"country": {
"alpha2": "AT",
"alpha3": "AUT",
"name": "Austria"
}
},
"statistics": {
"goalsConceded": 14,
"id": 26616,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"goalsConceded": 15,
"id": 26569,
"matches": 17,
"awardedMatches": 0
}
},
{
"team": {
"name": "Sporting",
"gender": "M",
"national": false,
"type": 0,
"id": 3001,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
}
},
"statistics": {
"goalsConceded": 15,
"id": 26512,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "RB Leipzig",
"gender": "M",
"national": false,
"type": 0,
"id": 36360,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"goalsConceded": 15,
"id": 26622,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Inter",
"gender": "M",
"national": false,
"type": 0,
"id": 2697,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"goalsConceded": 16,
"id": 26564,
"matches": 15,
"awardedMatches": 0
}
},
{
"team": {
"name": "Shakhtar Donetsk",
"gender": "M",
"national": false,
"type": 0,
"id": 3313,
"country": {
"alpha2": "UA",
"alpha3": "UKR",
"name": "Ukraine"
}
},
"statistics": {
"goalsConceded": 16,
"id": 26543,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "AS Monaco",
"gender": "M",
"national": false,
"type": 0,
"id": 1653,
"country": {
"alpha2": "MC",
"alpha3": "MCO",
"name": "Monaco"
}
},
"statistics": {
"goalsConceded": 17,
"id": 26617,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Celtic",
"gender": "M",
"national": false,
"type": 0,
"id": 2352,
"country": {
"alpha2": "SX",
"alpha3": "SCO",
"name": "Scotland"
}
},
"statistics": {
"goalsConceded": 17,
"id": 26561,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "VfB Stuttgart",
"gender": "M",
"national": false,
"type": 0,
"id": 2677,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"goalsConceded": 17,
"id": 26515,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"goalsConceded": 18,
"id": 26510,
"matches": 14,
"awardedMatches": 0
}
},
{
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"goalsConceded": 19,
"id": 26566,
"matches": 14,
"awardedMatches": 0
}
},
{
"team": {
"name": "Benfica",
"gender": "M",
"national": false,
"type": 0,
"id": 3006,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
}
},
"statistics": {
"goalsConceded": 19,
"id": 26610,
"matches": 12,
"awardedMatches": 0
}
},
{
"team": {
"name": "GNK Dinamo Zagreb",
"gender": "M",
"national": false,
"type": 0,
"id": 2032,
"country": {
"alpha2": "HR",
"alpha3": "HRV",
"name": "Croatia"
}
},
"statistics": {
"goalsConceded": 19,
"id": 26511,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Club Brugge KV",
"gender": "M",
"national": false,
"type": 0,
"id": 2888,
"country": {
"alpha2": "BE",
"alpha3": "BEL",
"name": "Belgium"
}
},
"statistics": {
"goalsConceded": 19,
"id": 26565,
"matches": 12,
"awardedMatches": 0
}
},
{
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"goalsConceded": 20,
"id": 26563,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "AC Sparta Praha",
"gender": "M",
"national": false,
"type": 0,
"id": 2218,
"country": {
"alpha2": "CZ",
"alpha3": "CZE",
"name": "Czechia"
}
},
"statistics": {
"goalsConceded": 21,
"id": 26539,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Stade Brestois",
"gender": "M",
"national": false,
"type": 0,
"id": 1715,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"goalsConceded": 21,
"id": 26615,
"matches": 10,
"awardedMatches": 0
}
},
{
"team": {
"name": "Real Madrid",
"gender": "M",
"national": false,
"type": 0,
"id": 2829,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"goalsConceded": 22,
"id": 26514,
"matches": 14,
"awardedMatches": 0
}
},
{
"team": {
"name": "FK Crvena zvezda",
"gender": "M",
"national": false,
"type": 0,
"id": 5149,
"country": {
"alpha2": "RS",
"alpha3": "SRB",
"name": "Serbia"
}
},
"statistics": {
"goalsConceded": 22,
"id": 26609,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"goalsConceded": 24,
"id": 26618,
"matches": 14,
"awardedMatches": 0
}
},
{
"team": {
"name": "PSV Eindhoven",
"gender": "M",
"national": false,
"type": 0,
"id": 2952,
"country": {
"alpha2": "NL",
"alpha3": "NLD",
"name": "Netherlands"
}
},
"statistics": {
"goalsConceded": 24,
"id": 26500,
"matches": 12,
"awardedMatches": 0
}
},
{
"team": {
"name": "Young Boys",
"gender": "M",
"national": false,
"type": 0,
"id": 2445,
"country": {
"alpha2": "CH",
"alpha3": "CHE",
"name": "Switzerland"
}
},
"statistics": {
"goalsConceded": 24,
"id": 26501,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "Feyenoord",
"gender": "M",
"national": false,
"type": 0,
"id": 2959,
"country": {
"alpha2": "NL",
"alpha3": "NLD",
"name": "Netherlands"
}
},
"statistics": {
"goalsConceded": 26,
"id": 26607,
"matches": 12,
"awardedMatches": 0
}
},
{
"team": {
"name": "Red Bull Salzburg",
"gender": "M",
"national": false,
"type": 0,
"id": 2046,
"country": {
"alpha2": "AT",
"alpha3": "AUT",
"name": "Austria"
}
},
"statistics": {
"goalsConceded": 27,
"id": 26540,
"matches": 8,
"awardedMatches": 0
}
},
{
"team": {
"name": "ŠK Slovan Bratislava",
"gender": "M",
"national": false,
"type": 0,
"id": 2404,
"country": {
"alpha2": "SK",
"alpha3": "SVK",
"name": "Slovakia"
}
},
"statistics": {
"goalsConceded": 27,
"id": 26562,
"matches": 8,
"awardedMatches": 0
}
}
],
"bigChances": [
{
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"bigChances": 71,
"id": 26569,
"matches": 17,
"awardedMatches": 0
}
}
],
"bigChancesMissed": [
{
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"bigChancesMissed": 46,
"id": 26569,
"matches": 17,
"awardedMatches": 0
}
}
],
"hitWoodwork": [
{
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"hitWoodwork": 10,
"id": 26563,
"matches": 10,
"awardedMatches": 0
}
}
],
"yellowCards": [
{
"team": {
"name": "Real Madrid",
"gender": "M",
"national": false,
"type": 0,
"id": 2829,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"yellowCards": 34,
"id": 26514,
"matches": 14,
"awardedMatches": 0
}
}
],
"redCards": [
{
"team": {
"name": "AS Monaco",
"gender": "M",
"national": false,
"type": 0,
"id": 1653,
"country": {
"alpha2": "MC",
"alpha3": "MCO",
"name": "Monaco"
}
},
"statistics": {
"redCards": 3,
"id": 26617,
"matches": 10,
"awardedMatches": 0
}
}
],
"averageBallPossession": [
{
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"averageBallPossession": 64.785714285714,
"id": 26510,
"matches": 14,
"awardedMatches": 0
}
}
],
"accuratePasses": [
{
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"accuratePasses": 5785,
"id": 26563,
"matches": 10,
"awardedMatches": 0
}
}
],
"accurateLongBalls": [
{
"team": {
"name": "Bologna",
"gender": "M",
"national": false,
"type": 0,
"id": 2685,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"accurateLongBalls": 195,
"id": 26542,
"matches": 8,
"awardedMatches": 0
}
}
],
"accurateCrosses": [
{
"team": {
"name": "Atalanta",
"gender": "M",
"national": false,
"type": 0,
"id": 2686,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"accurateCrosses": 70,
"id": 26613,
"matches": 10,
"awardedMatches": 0
}
}
],
"shots": [
{
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"shots": 287,
"id": 26510,
"matches": 14,
"awardedMatches": 0
}
}
],
"shotsOnTarget": [
{
"team": {
"name": "FC Bayern München",
"gender": "M",
"national": false,
"type": 0,
"id": 2672,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"shotsOnTarget": 108,
"id": 26510,
"matches": 14,
"awardedMatches": 0
}
}
],
"successfulDribbles": [
{
"team": {
"name": "Paris Saint-Germain",
"gender": "M",
"national": false,
"type": 0,
"id": 1644,
"country": {
"alpha2": "FR",
"alpha3": "FRA",
"name": "France"
}
},
"statistics": {
"successfulDribbles": 203,
"id": 26569,
"matches": 17,
"awardedMatches": 0
}
}
],
"tackles": [
{
"team": {
"name": "Benfica",
"gender": "M",
"national": false,
"type": 0,
"id": 3006,
"country": {
"alpha2": "PT",
"alpha3": "PRT",
"name": "Portugal"
}
},
"statistics": {
"tackles": 259,
"id": 26610,
"matches": 12,
"awardedMatches": 0
}
}
],
"interceptions": [
{
"team": {
"name": "AS Monaco",
"gender": "M",
"national": false,
"type": 0,
"id": 1653,
"country": {
"alpha2": "MC",
"alpha3": "MCO",
"name": "Monaco"
}
},
"statistics": {
"interceptions": 127,
"id": 26617,
"matches": 10,
"awardedMatches": 0
}
}
],
"clearances": [
{
"team": {
"name": "ŠK Slovan Bratislava",
"gender": "M",
"national": false,
"type": 0,
"id": 2404,
"country": {
"alpha2": "SK",
"alpha3": "SVK",
"name": "Slovakia"
}
},
"statistics": {
"clearances": 259,
"id": 26562,
"matches": 8,
"awardedMatches": 0
}
}
],
"corners": [
{
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"corners": 75,
"id": 26563,
"matches": 10,
"awardedMatches": 0
}
}
],
"fouls": [
{
"team": {
"name": "Manchester City",
"gender": "M",
"national": false,
"type": 0,
"id": 17,
"country": {
"alpha2": "EN",
"alpha3": "ENG",
"name": "England"
}
},
"statistics": {
"corners": 75,
"id": 26563,
"matches": 10,
"awardedMatches": 0
}
}
],
"penaltyGoals": [
{
"team": {
"name": "Borussia Dortmund",
"gender": "M",
"national": false,
"type": 0,
"id": 2673,
"country": {
"alpha2": "DE",
"alpha3": "DEU",
"name": "Germany"
}
},
"statistics": {
"penaltyGoals": 7,
"penaltiesTaken": 8,
"id": 26566,
"matches": 14,
"awardedMatches": 0
}
}
],
"penaltyGoalsConceded": [
{
"team": {
"name": "Barcelona",
"gender": "M",
"national": false,
"type": 0,
"id": 2817,
"country": {
"alpha2": "ES",
"alpha3": "ESP",
"name": "Spain"
}
},
"statistics": {
"penaltiesCommited": 4,
"penaltyGoalsConceded": 4,
"id": 26618,
"matches": 14,
"awardedMatches": 0
}
}
],
"cleanSheets": [
{
"team": {
"name": "Inter",
"gender": "M",
"national": false,
"type": 0,
"id": 2697,
"country": {
"alpha2": "IT",
"alpha3": "ITA",
"name": "Italy"
}
},
"statistics": {
"cleanSheets": 8,
"id": 26564,
"matches": 15,
"awardedMatches": 0
}
}
]
}
}Get Competition Rounds
This endpoint retrieves the rounds of a specific season for a given competition in football.
Request
Method:
GETEndpoint:
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/rounds
Path Parameters
:tid(string): The unique identifier for the competition.:sid(string): The unique identifier for the season.
Response Format
The response will be in JSON format and includes the following fields:
status(boolean): Indicates if the request was successful.statusCode(integer): The status code of the response.message(string): A message providing additional information about the request.response(array): An array of objects containing details about each round, where each object includes:round(integer): The round number.name(string): The name of the round.prefix(string): A prefix associated with the round.current(boolean): Indicates if this is the current round.
This endpoint is useful for obtaining the structure of competition rounds within a specified season.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/rounds HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"round": 1,
"name": "Qualification Round 1",
"prefix": "",
"current": false
},
{
"round": 2,
"name": "Qualification Round 2",
"prefix": "",
"current": false
},
{
"round": 3,
"name": "Qualification Round 3",
"prefix": "",
"current": false
},
{
"round": 636,
"name": "Playoff round",
"prefix": "Qualification",
"current": false
},
{
"round": 1,
"name": "",
"prefix": "",
"current": false
},
{
"round": 2,
"name": "",
"prefix": "",
"current": false
},
{
"round": 3,
"name": "",
"prefix": "",
"current": false
},
{
"round": 4,
"name": "",
"prefix": "",
"current": false
},
{
"round": 5,
"name": "",
"prefix": "",
"current": false
},
{
"round": 6,
"name": "",
"prefix": "",
"current": false
},
{
"round": 7,
"name": "",
"prefix": "",
"current": false
},
{
"round": 8,
"name": "",
"prefix": "",
"current": false
},
{
"round": 636,
"name": "Playoff round",
"prefix": "",
"current": false
},
{
"round": 5,
"name": "Round of 16",
"prefix": "",
"current": false
},
{
"round": 27,
"name": "Quarterfinals",
"prefix": "",
"current": false
},
{
"round": 28,
"name": "Semifinals",
"prefix": "",
"current": false
},
{
"round": 29,
"name": "Final",
"prefix": "",
"current": true
}
]
}Endpoint Description
This API endpoint retrieves the matches for a specific round of a tournament in a given season. It provides detailed information about each match, including team details, scores, and tournament information.
HTTP Method
GET
Endpoint
https://apiv3.sportsapi360.com/football/api/v1/competitions/:tid/season/:sid/rounds/matches
URL Parameters
:tid(Tournament ID): The unique identifier for the tournament.:sid(Season ID): The unique identifier for the season.
Expected Response Format
The response will be a JSON object containing the following structure:
status(boolean): Indicates the success of the request.statusCode(integer): A code representing the status of the response.message(string): A message providing additional context about the response.response(array): An array of match details for the specified round, each containing:round(integer): The round number.name(string): The name of the round.matches(array): An array of match objects, each with:tournamentId(integer): The ID of the tournament.id(integer): The unique identifier for the match.startTimestamp(integer): The timestamp when the match starts.detailId(integer): The ID for detailed match information.season(object): Contains season details including:name(string): The name of the season.year(integer): The year of the season.seasonCoverageInfo(object): Additional coverage information.id(integer): The ID of the season.
roundInfo(object): Information about the round including:round(integer): The round number.name(string): The name of the round.
status(object): Current status of the match including:code(integer): Status code.description(string): Description of the status.type(string): Type of status.
homeTeam(object): Details about the home team, including:name(string): Team name.shortName(string): Short name of the team.gender(string): Gender category of the team.disabled(boolean): Indicates if the team is disabled.national(boolean): Indicates if the team is national.country(object): Country details of the team.
homeScore(object): Current score details for the home team.awayTeam(object): Details about the away team (similar structure tohomeTeam).awayScore(object): Current score details for the away team.time(object): Information about the current period of the match.tournament(object): Details about the tournament including:id(integer): Tournament ID.name(string): Name of the tournament.category(object): Category details of the tournament.
Additional Notes
Ensure to replace
:tidand:sidwith the appropriate tournament and season IDs when making the request.The response will provide comprehensive details for each match, which can be useful for applications displaying match schedules or statistics.
761644OK
GET /football/api/v1/competitions/{tid}/season/{sid}/rounds/matches HTTP/1.1
Host: apiv3.sportsapi360.com
Authorization: x-api-key YOUR_SECRET_TOKEN
Accept: */*
OK
{
"status": true,
"statusCode": 200,
"message": "Data fetch successfully",
"response": [
{
"round": 1,
"name": "Qualification Round 1",
"matches": [
]
}
]
}Last updated