Football Metrics
Football Metrics · GPT 작업
Football API
Provide information about Football matches, player, leagues, countries, and all information related to Football
GET /fixturesFind the fixture with the information for any match or matches.GET /fixtures/headtoheadGet head to head stats.GET /teamsGet the list of available teams.GET /teams/statisticsReturns the statistics of a team in relation to a given competition and season.GET /teams/seasonsGet the list of seasons available for a team.GET /teams/countriesGet the list of countries available for the teams endpoint.GET /leaguesGet the list of available leagues and cups.GET /standingsGet the standings for a league or a team.GET /leagues/seasonsGet the list of available seasons.GET /players/seasonsGet all available seasons for players statisticsGET /playersGet players statisticsGET /players/squadsReturn the current squad of a team when the team parameter is used. When the player parameter is used the endpoint returns the set of teams associated with the player.GET /players/topscorersGet the 20 best players for a league or cup.GET /players/topassistsGet the 20 best players assists for a league or cup.GET /players/topyellowcardsGet the 20 players with the most yellow cards for a league or cup.GET /players/topredcardsGet the 20 players with the most red cards for a league or cup.GET /predictionsGet predictions about a fixture.
원본 API 스키마
{
"openapi": "3.1.0",
"info": {
"title": "Football API",
"version": "1.0.0",
"description": "Provide information about Football matches, player, leagues, countries, and all information related to Football"
},
"servers": [
{
"url": "https://api-football-v1.p.rapidapi.com/v3",
"description": "API server for providing information about Football."
}
],
"paths": {
"/fixtures": {
"get": {
"summary": "Find the fixture with the information for any match or matches.",
"operationId": "searchFixture",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "id",
"in": "query",
"required": false,
"description": "The id of the fixture",
"schema": {
"type": "integer"
}
},
{
"name": "ids",
"in": "query",
"required": false,
"description": "One or more fixture ids",
"schema": {
"type": "string"
}
},
{
"name": "live",
"in": "query",
"required": false,
"description": "All or several leagues ids",
"schema": {
"type": "string",
"enum": [
"all",
"id-id"
]
}
},
{
"name": "date",
"in": "query",
"required": false,
"description": "A valid date",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "league",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": false,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "team",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "last",
"in": "query",
"required": false,
"description": "For the X last fixtures",
"schema": {
"type": "integer",
"maxLength": 2
}
},
{
"name": "next",
"in": "query",
"required": false,
"description": "For the X next fixtures",
"schema": {
"type": "integer",
"maxLength": 2
}
},
{
"name": "from",
"in": "query",
"required": false,
"description": "A valid start date",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"required": false,
"description": "A valid end date",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "round",
"in": "query",
"required": false,
"description": "The round of the fixture",
"schema": {
"type": "string"
}
},
{
"name": "status",
"in": "query",
"required": false,
"description": "One or more fixture status short",
"schema": {
"type": "string",
"enum": [
"TBD",
"NS",
"1H",
"HT",
"2H",
"ET",
"BT",
"P",
"SUSP",
"INT"
]
}
},
{
"name": "venue",
"in": "query",
"required": false,
"description": "The venue id of the fixture",
"schema": {
"type": "integer"
}
},
{
"name": "timezone",
"in": "query",
"required": false,
"description": "A valid timezone from the endpoint Timezone",
"schema": {
"type": "string"
}
}
]
}
},
"/fixtures/headtohead": {
"get": {
"summary": "Get head to head stats.",
"operationId": "searchh2h",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "h2h",
"in": "query",
"required": true,
"description": "The ids of the teams",
"schema": {
"type": "string"
}
},
{
"name": "date",
"in": "query",
"required": false,
"description": "A valid date in YYYY-MM-DD format",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "league",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": false,
"description": "The season of the league",
"schema": {
"type": "integer"
}
},
{
"name": "last",
"in": "query",
"required": false,
"description": "For the X last fixtures",
"schema": {
"type": "integer",
"default": 5
}
},
{
"name": "next",
"in": "query",
"required": false,
"description": "For the X next fixtures",
"schema": {
"type": "integer"
}
},
{
"name": "from",
"in": "query",
"required": false,
"description": "A valid start date in YYYY-MM-DD format",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "to",
"in": "query",
"required": false,
"description": "A valid end date in YYYY-MM-DD format",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "status",
"in": "query",
"required": false,
"description": "One or more fixture status short",
"schema": {
"type": "string"
}
},
{
"name": "venue",
"in": "query",
"required": false,
"description": "The venue id of the fixture",
"schema": {
"type": "integer"
}
},
{
"name": "timezone",
"in": "query",
"required": false,
"description": "A valid timezone from the endpoint Timezone",
"schema": {
"type": "string"
}
}
]
}
},
"/teams": {
"get": {
"summary": "Get the list of available teams.",
"operationId": "searchTeams",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "id",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "name",
"in": "query",
"required": false,
"description": "The name of the team",
"schema": {
"type": "string"
}
},
{
"name": "league",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "string"
}
},
{
"name": "season",
"in": "query",
"required": false,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "country",
"in": "query",
"required": false,
"description": "The country name of the team",
"schema": {
"type": "string"
}
},
{
"name": "code",
"in": "query",
"required": false,
"description": "The code of the team",
"schema": {
"type": "string",
"minLength": 3,
"maxLength": 3
}
},
{
"name": "venue",
"in": "query",
"required": false,
"description": "The id of the venue",
"schema": {
"type": "integer"
}
},
{
"name": "last",
"in": "query",
"required": false,
"description": "For the X last fixtures",
"schema": {
"type": "integer"
}
},
{
"name": "search",
"in": "query",
"required": false,
"description": "The name or the country name of the team",
"schema": {
"type": "string",
"minLength": 3
}
}
]
}
},
"/teams/statistics": {
"get": {
"summary": "Returns the statistics of a team in relation to a given competition and season.",
"operationId": "searchTeamsStatistics",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": true,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "team",
"in": "query",
"required": true,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "date",
"in": "query",
"required": false,
"description": "The limit date",
"schema": {
"type": "string",
"format": "date"
}
}
]
}
},
"/teams/seasons": {
"get": {
"summary": "Get the list of seasons available for a team.",
"operationId": "searchTeamsSeasons",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "team",
"in": "query",
"required": true,
"description": "The id of the team",
"schema": {
"type": "integer"
}
}
]
}
},
"/teams/countries": {
"get": {
"summary": "Get the list of countries available for the teams endpoint.",
"operationId": "searchTeamsCountries",
"x-openai-isConsequential": false
}
},
"/leagues": {
"get": {
"summary": "Get the list of available leagues and cups.",
"operationId": "searchLeagues",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "id",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "name",
"in": "query",
"required": false,
"description": "The name of the league",
"schema": {
"type": "string"
}
},
{
"name": "country",
"in": "query",
"required": false,
"description": "The country name of the league",
"schema": {
"type": "string"
}
},
{
"name": "code",
"in": "query",
"required": false,
"description": "A valid date",
"schema": {
"type": "string",
"minLength": 2,
"maxLength": 2
}
},
{
"name": "season",
"in": "query",
"required": false,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "team",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "type",
"in": "query",
"required": false,
"description": "The type of the league",
"schema": {
"type": "string",
"enum": [
"league",
"cup"
]
}
},
{
"name": "current",
"in": "query",
"required": false,
"description": "The state of the league",
"schema": {
"type": "string",
"enum": [
"true",
"false"
],
"default": "true"
}
},
{
"name": "search",
"in": "query",
"required": false,
"description": "The name or the country of the league",
"schema": {
"type": "string",
"minLength": 3
}
},
{
"name": "last",
"in": "query",
"required": false,
"description": "The X last leagues/cups added in the API",
"schema": {
"type": "integer",
"maxLength": 2
}
}
]
}
},
"/standings": {
"get": {
"summary": "Get the standings for a league or a team.",
"operationId": "getStandings",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season year",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "team",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
}
]
}
},
"/leagues/seasons": {
"get": {
"summary": "Get the list of available seasons.",
"operationId": "searchLeagueSeasons",
"x-openai-isConsequential": false
}
},
"/players/seasons": {
"get": {
"summary": "Get all available seasons for players statistics",
"operationId": "searchPlayerSeasons",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "player",
"in": "query",
"required": false,
"description": "The id of the player",
"schema": {
"type": "integer"
}
}
]
}
},
"/players": {
"get": {
"summary": "Get players statistics",
"operationId": "searchPlayer",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "id",
"in": "query",
"required": false,
"description": "The id of the player",
"schema": {
"type": "integer"
}
},
{
"name": "team",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "league",
"in": "query",
"required": false,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": false,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
},
{
"name": "search",
"in": "query",
"required": false,
"description": "The name of the player",
"schema": {
"type": "string",
"minLength": 4
}
},
{
"name": "page",
"in": "query",
"required": false,
"description": "Use for the pagination",
"schema": {
"type": "integer",
"default": 1
}
}
]
}
},
"/players/squads": {
"get": {
"summary": "Return the current squad of a team when the team parameter is used. When the player parameter is used the endpoint returns the set of teams associated with the player.",
"operationId": "searchPlayerSquad",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "team",
"in": "query",
"required": false,
"description": "The id of the team",
"schema": {
"type": "integer"
}
},
{
"name": "player",
"in": "query",
"required": false,
"description": "The id of the player",
"schema": {
"type": "integer"
}
}
]
}
},
"/players/topscorers": {
"get": {
"summary": "Get the 20 best players for a league or cup.",
"operationId": "searchTopScorers",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": true,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
}
]
}
},
"/players/topassists": {
"get": {
"summary": "Get the 20 best players assists for a league or cup.",
"operationId": "searchTopAssists",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": true,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
}
]
}
},
"/players/topyellowcards": {
"get": {
"summary": "Get the 20 players with the most yellow cards for a league or cup.",
"operationId": "searchTopYellow",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": true,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
}
]
}
},
"/players/topredcards": {
"get": {
"summary": "Get the 20 players with the most red cards for a league or cup.",
"operationId": "searchTopRed",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "league",
"in": "query",
"required": true,
"description": "The id of the league",
"schema": {
"type": "integer"
}
},
{
"name": "season",
"in": "query",
"required": true,
"description": "The season of the league",
"schema": {
"type": "integer",
"minLength": 4,
"maxLength": 4
}
}
]
}
},
"/predictions": {
"get": {
"summary": "Get predictions about a fixture.",
"operationId": "searchPredictions",
"x-openai-isConsequential": false,
"parameters": [
{
"name": "fixture",
"in": "query",
"required": true,
"description": "The id of the fixture",
"schema": {
"type": "integer"
}
}
]
}
}
}
}