TheSportsDB

https://thedatadb.readme.io
Admin
TheSportsDB is an API that provides comprehensive sports data, including information on teams,...
Tokens:467,334
Snippets:1,224
Trust Score:9.9
Update:1 year ago
Show doc for...
Tokens:
Raw
### Get All Leagues (V1 API)

Source: https://thedatadb.readme.io/reference/getallleagues

Retrieves a list of all leagues supported by TheSportsDB API. This endpoint requires an API key and returns league data.

```HTTP
GET https://www.thesportsdb.com/api/v1/json/{api-key}/all_leagues.php

Parameters:
  - api-key: Your unique API key.

Description:
  Lists all the leagues supported on the website.

Example Usage:
  https://www.thesportsdb.com/api/v1/json/123/all_leagues.php
```

--------------------------------

### V1 API List and Search All

Source: https://thedatadb.readme.io/reference/getprevioussoccereventsbyvenue

Provides endpoints for listing all available sports, countries, and leagues, as well as searching across all seasons and teams. This facilitates broad data exploration.

```APIDOC
GET /getallsports
  - Description: Retrieves a list of all available sports.

GET /getallcountries
  - Description: Retrieves a list of all countries.

GET /getallleagues
  - Description: Retrieves a list of all leagues.

GET /searchallleagues
  - Description: Searches across all leagues.
  - Parameters:
    - name: The name of the league to search for.

GET /searchallseasons
  - Description: Searches across all available seasons.
  - Parameters:
    - season: The season to search for.

GET /searchallteams
  - Description: Searches across all teams.
  - Parameters:
    - name: The name of the team to search for.

GET /lookupallplayers
  - Description: Retrieves a list of all players.
```

--------------------------------

### Get All Sports API Endpoint

Source: https://thedatadb.readme.io/reference/getallplayersbysport

This API endpoint retrieves a comprehensive list of all sports supported by TheSportsDB. It requires a simple GET request to the specified URL. No authentication or specific headers are mentioned as mandatory for this public endpoint.

```APIDOC
GET https://www.thesportsdb.com/api/v2/json/all/sports

Description:
  Retrieves a list of all sports supported by TheSportsDB.

Parameters:
  None required for this endpoint.

Request:
  Method: GET
  URL: https://www.thesportsdb.com/api/v2/json/all/sports

Response:
  Content-Type: application/json
  Body:
    A JSON object containing an array of sports, where each sport object typically includes an ID and a name.
    Example:
    {
      "sports": [
        {
          "idSport": "4328",
          "strSport": "Soccer",
          "strFormat": "Leagues"
        },
        {
          "idSport": "4329",
          "strSport": "Tennis",
          "strFormat": "Leagues"
        }
      ]
    }

Error Conditions:
  - Network errors or invalid URL will result in standard HTTP error codes.
  - The API may return an empty list if no sports are currently available or if there's an internal issue.
```

--------------------------------

### General Data Listings

Source: https://thedatadb.readme.io/reference/getequipmentbyid

Retrieve comprehensive lists of all available sports, leagues, and countries within the database.

```APIDOC
GET /sports
  Description: Get a list of all available sports.
  Returns: List of sports.

GET /leagues
  Description: Get a list of all available leagues.
  Returns: List of leagues.

GET /countries
  Description: Get a list of all available countries.
  Returns: List of countries.
```

--------------------------------

### Get All Leagues API Endpoint

Source: https://thedatadb.readme.io/reference/getallleaguesbysport

This API endpoint retrieves a list of all leagues supported by TheSportsDB. It is a simple GET request that returns JSON data containing league details. No specific credentials or headers are mentioned for this public endpoint.

```APIDOC
GET https://www.thesportsdb.com/api/v2/json/all/leagues

Description:
  Retrieves all leagues supported by TheSportsDB.

Request:
  Method: GET
  URL: https://www.thesportsdb.com/api/v2/json/all/leagues
  Parameters:
    None
  Headers:
    None specified
  Credentials:
    None specified

Response:
  Returns a JSON object containing an array of league data.
```

--------------------------------

### V1 API Video Highlights

Source: https://thedatadb.readme.io/reference/getprevioussoccereventsbyvenue

Provides an endpoint to retrieve video highlights for specific events, allowing users to access multimedia content related to matches.

```APIDOC
GET /geteventhighlights
  - Description: Retrieves video highlights for a specific event.
  - Parameters:
    - id: The unique identifier for the event.
```

--------------------------------

### Get All Live Scores (V2)

Source: https://thedatadb.readme.io/reference/getalllivescores

Retrieves the current live scores for all sports. This endpoint provides real-time updates on ongoing sporting events.

```APIDOC
GET https://www.thesportsdb.com/api/v2/json/livescore/all

Description:
Show the current Livescores for all sports.

Parameters:
None

Returns:
JSON object containing live score data for all sports.
```

--------------------------------

### V1 API List/Search All Endpoints

Source: https://thedatadb.readme.io/reference/getcontractsbyplayerid

Provides endpoints for listing all available sports, countries, leagues, and for searching across all teams and players.

```APIDOC
APIDOC:
  Get All Sports:
    GET /api/v1/json/1/all_sports.php
    - Retrieves a list of all available sports.

  Get All Countries:
    GET /api/v1/json/1/all_countries.php
    - Retrieves a list of all countries.

  Get All Leagues:
    GET /api/v1/json/1/all_leagues.php
    - Retrieves a list of all leagues.

  Search All Leagues:
    GET /api/v1/json/1/search_all_leagues.php?s=league_name
    - Searches for leagues by name.
    - Parameters:
      - s: League name (string)

  Search All Seasons:
    GET /api/v1/json/1/search_all_seasons.php?s=season_name
    - Searches for seasons by name.
    - Parameters:
      - s: Season name (string)

  Search All Teams:
    GET /api/v1/json/1/search_all_teams.php?s=team_name
    - Searches for teams by name across all leagues.
    - Parameters:
      - s: Team name (string)

  Lookup All Players:
    GET /api/v1/json/1/all_players.php
    - Retrieves a list of all players.
```

--------------------------------

### Get All Countries Endpoint

Source: https://thedatadb.readme.io/reference/v2-api-all

This endpoint retrieves a list of all countries supported by TheSportsDB. It requires no authentication and returns a JSON object containing country data.

```APIDOC
GET https://www.thesportsdb.com/api/v2/json/all/countries

Description:
  Retrieves a comprehensive list of all countries supported by TheSportsDB.

Request:
  Method: GET
  URL: https://www.thesportsdb.com/api/v2/json/all/countries
  Headers:
    Content-Type: application/json
  Parameters:
    None

Response:
  Status Code: 200 OK
  Content Type: application/json
  Body:
    A JSON object containing an array of countries. Each country object typically includes:
    - idCountry: Unique identifier for the country.
    - nameCountry: The name of the country.
    - codeCountry: The ISO 3166-1 alpha-2 country code.
    - flag: URL to the country's flag image.
    - sport: The primary sport associated with the country in the database.

Example Response Snippet:
{
  "countries": [
    {
      "idCountry": "1",
      "nameCountry": "England",
      "codeCountry": "ENG",
      "flag": "https://www.thesportsdb.com/images/flags/eng.png",
      "sport": "Soccer"
    },
    {
      "idCountry": "2",
      "nameCountry": "France",
      "codeCountry": "FRA",
      "flag": "https://www.thesportsdb.com/images/flags/fra.png",
      "sport": "Soccer"
    }
    // ... more countries
  ]
}

Error Conditions:
  - 404 Not Found: If the API endpoint is incorrect or unavailable.
  - 500 Internal Server Error: If there's a server-side issue.
```

--------------------------------

### V1 API Lookup Endpoints

Source: https://thedatadb.readme.io/reference/searchvenuebyname

Offers endpoints to retrieve detailed information about specific sports entities using their unique identifiers. These are primarily GET requests.

```APIDOC
Lookup League by ID:
  GET /getleaguebyid
  Description: Retrieves league details using its ID.

Lookup Table by ID:
  GET /gettablebyid
  Description: Retrieves table data using its ID.

Lookup Team by ID:
  GET /getteambyid
  Description: Retrieves team details using its ID.

Lookup Equipment by ID:
  GET /getequipmentbyid
  Description: Retrieves equipment details using its ID.

Lookup Player by ID:
  GET /getplayerbyid
  Description: Retrieves player details using its ID.

Lookup Honours by ID:
  GET /gethonourbyid
  Description: Retrieves player honours using their ID.

Lookup Former Teams by Player ID:
  GET /getformerteamsbyplayerid
  Description: Retrieves a list of former teams for a player.

Lookup Milestones by Player ID:
  GET /getmilestonesbyplayerid
  Description: Retrieves player milestones using their ID.

Lookup Contracts by Player ID:
  GET /getcontractsbyplayerid
  Description: Retrieves player contract information using their ID.

Lookup Event by ID:
  GET /geteventbyid
  Description: Retrieves event details using its ID.

Event Results:
  GET /geteventresults
  Description: Retrieves results for events.

Lookup Lineup by Event ID:
  GET /getlineupbyeventid
  Description: Retrieves lineup information for an event.

Lookup Timeline by Event ID:
  GET /gettimelinebyeventid
  Description: Retrieves timeline data for an event.

Lookup Event Stats by ID:
  GET /geteventstatsbyid
  Description: Retrieves statistics for an event.

Lookup TV by Event ID:
  GET /gettvbyeventid
  Description: Retrieves TV broadcast information for an event.

Lookup Venue by ID:
  GET /getvenuebyid
  Description: Retrieves venue details using its ID.
```

--------------------------------

### THESPORTSDB V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/getequipmentbyid

Provides an endpoint to retrieve video highlights for specific events, allowing users to access visual content related to matches.

```APIDOC
GET /api/v1/geteventhighlights.php?id={eventID}
  Description: Retrieves video highlights for a specific event.
  Parameters:
    - id (integer, required): The unique identifier for the event.
  Returns: Video highlights for the event.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/searchvenuebyname

Provides endpoints to retrieve comprehensive lists of sports data, such as all sports, countries, leagues, and teams. These are typically GET requests.

```APIDOC
Get All Sports:
  GET /getallsports
  Description: Retrieves a list of all available sports.

Get All Countries:
  GET /getallcountries
  Description: Retrieves a list of all countries.

Get All Leagues:
  GET /getallleagues
  Description: Retrieves a list of all leagues.

Search All Leagues:
  GET /searchallleagues
  Description: Searches across all leagues.

Search All Seasons:
  GET /searchallseasons
  Description: Searches across all available seasons.

Search All Teams:
  GET /searchallteams
  Description: Searches across all teams.

Lookup All Players:
  GET /lookupallplayers
  Description: Retrieves a list of all players.
```

--------------------------------

### TheSportsDB V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/getfullsoccerschedulebyteam

Provides an endpoint to retrieve highlight videos for specific soccer events.

```APIDOC
GET /api/v1/json/1/eventhighlights.php?idEvent=event_id
  Description: Retrieves highlight videos for a specific event.
  Parameters:
    idEvent (string): The unique identifier for the event.
  Returns: Video highlight information for the event.
```

--------------------------------

### V1 API List and Search All Endpoints

Source: https://thedatadb.readme.io/reference/geteventsbyseason

Endpoints for listing all available sports, countries, leagues, and for searching across all seasons, teams, and players.

```APIDOC
GET /api/v1/json/1/all_sports.php
  - Retrieves a list of all available sports.
  - Returns: A list of sports.

GET /api/v1/json/1/all_countries.php
  - Retrieves a list of all countries.
  - Returns: A list of countries.

GET /api/v1/json/1/all_leagues.php
  - Retrieves a list of all leagues.
  - Returns: A list of leagues.

GET /api/v1/json/1/search_all_leagues.php
  - Searches across all leagues.
  - Returns: A list of leagues.

GET /api/v1/json/1/search_all_seasons.php
  - Searches across all seasons.
  - Returns: A list of seasons.

GET /api/v1/json/1/search_all_teams.php
  - Searches across all teams.
  - Returns: A list of teams.

GET /api/v1/json/1/lookup_all_players.php
  - Retrieves a list of all players.
  - Returns: A list of players.
```

--------------------------------

### Get Sports Event by ID

Source: https://thedatadb.readme.io/reference/lookupeventbyid

Retrieves details for a specific sports event using its unique identifier. The event ID is a required path parameter.

```HTTP
GET https://www.thesportsdb.com/api/v2/json/lookup/event/{idEvent}

Parameters:
  - idEvent: The unique identifier for the sports event (path parameter).

Returns:
  - JSON object containing the details of the sports event.
```

--------------------------------

### V1 API List and Search Endpoints

Source: https://thedatadb.readme.io/reference/getnextsoccereventsbyteam

Endpoints for listing all available sports, countries, leagues, and searching across leagues, seasons, and players. These provide comprehensive overviews and search capabilities.

```APIDOC
GET /getallsports
  Description: Retrieves a list of all available sports.
  Returns:
    - Array of sport objects.

GET /getallcountries
  Description: Retrieves a list of all countries.
  Returns:
    - Array of country objects.

GET /getallleagues
  Description: Retrieves a list of all leagues.
  Returns:
    - Array of league objects.

GET /searchallleagues
  Description: Searches for leagues based on provided criteria.
  Parameters:
    - name (string, optional): Name of the league to search.
    - country (string, optional): Country of the league.
  Returns:
    - Array of league objects.

GET /searchallseasons
  Description: Searches for seasons based on provided criteria.
  Parameters:
    - season (string, optional): The season string (e.g., '2023-2024').
  Returns:
    - Array of season objects.

GET /searchallteams
  Description: Searches for teams based on provided criteria.
  Parameters:
    - name (string, optional): Name of the team to search.
    - league (string, optional): League of the team.
  Returns:
    - Array of team objects.

GET /lookupallplayers
  Description: Retrieves a list of all players.
  Returns:
    - Array of player objects.
```

--------------------------------

### Get Next Soccer Events API

Source: https://thedatadb.readme.io/reference/getnextsoccereventsbyteam

Retrieves the next 5 soccer events for a specified team. Requires the team's unique identifier.

```APIDOC
APIDOC
Endpoint: /api/v2/json/schedule/next/team/{idTeam}
Method: GET
Description: Lists the next 5 events for a team using its unique ID.
Parameters:
  - name: idTeam
    in: path
    required: true
    description: The unique identifier for the team.
    type: integer
Response:
  200 OK:
    description: A list of upcoming events for the team.
    content:
      application/json:
        schema:
          type: object
          properties:
            events:
              type: array
              items:
                type: object
                properties:
                  idEvent: { type: string, description: Unique event ID }
                  strEvent: { type: string, description: Event name }
                  strFilename: { type: string, description: Filename associated with the event }
                  strSport: { type: string, description: Sport type }
                  idSoccerXML: { type: string, description: Soccer XML ID }
                  idAPIfootball: { type: string, description: API Football ID }
                  resOwned: { type: string, description: Ownership status }
                  IsEvent: { type: string, description: Indicates if it's an event }
                  dateEvent: { type: string, description: Event date (YYYY-MM-DD) }
                  dateEventLocal: { type: string, description: Local event date }
                  strTime: { type: string, description: Event time }
                  strTimeLocal: { type: string, description: Local event time }
                  idHomeTeam: { type: string, description: Home team ID }
                  strHomeTeam: { type: string, description: Home team name }
                  idAwayTeam: { type: string, description: Away team ID }
                  strAwayTeam: { type: string, description: Away team name }
                  intHomeScore: { type: string, description: Home team score (nullable) }
                  intRound: { type: string, description: Round number }
                  intDoorsOpen: { type: string, description: Doors open time }
                  intHomeShots: { type: string, description: Home team shots (nullable) }
                  intAwayShots: { type: string, description: Away team shots (nullable) }
                  strTweetEarthquake: { type: string, description: Tweet related to earthquake (nullable) }
                  strTweetVenue: { type: string, description: Tweet related to venue (nullable) }
                  strMap: { type: string, description: Map link }
                  strPoster: { type: string, description: Event poster URL }
                  strFanart: { type: string, description: Event fanart URL }
                  strBanner: { type: string, description: Event banner URL }
                  strVideo: { type: string, description: Event video URL }
                  strTVStation: { type: string, description: TV broadcast station }
                  strHomeYellowCards: { type: string, description: Home team yellow cards (nullable) }
                  strHomeRedCards: { type: string, description: Home team red cards (nullable) }
                  strAwayYellowCards: { type: string, description: Away team yellow cards (nullable) }
                  strAwayRedCards: { type: string, description: Away team red cards (nullable) }
                  intHomeYellowCards: { type: string, description: Home team yellow cards count (nullable) }
                  intHomeRedCards: { type: string, description: Home team red cards count (nullable) }
                  intAwayYellowCards: { type: string, description: Away team yellow cards count (nullable) }
                  intAwayRedCards: { type: string, description: Away team red cards count (nullable) }
                  strHometeam_Badge: { type: string, description: Home team badge URL }
                  strAwayteam_Badge: { type: string, description: Away team badge URL }
                  strLocked: { type: string, description: Lock status }
Example:
  GET https://www.thesportsdb.com/api/v2/json/schedule/next/team/130403
```

--------------------------------

### Get All Countries Endpoint

Source: https://thedatadb.readme.io/reference/getallteamsbysport

This endpoint retrieves a list of all countries supported by TheSportsDB. It requires no authentication and returns a JSON object containing country data.

```APIDOC
GET https://www.thesportsdb.com/api/v2/json/all/countries

Description:
  Retrieves a comprehensive list of all countries supported by TheSportsDB.

Request:
  Method: GET
  URL: https://www.thesportsdb.com/api/v2/json/all/countries
  Headers:
    Content-Type: application/json
  Parameters:
    None

Response:
  Status Code: 200 OK
  Content Type: application/json
  Body:
    A JSON object containing an array of countries. Each country object typically includes:
    - idCountry: Unique identifier for the country.
    - nameCountry: The name of the country.
    - codeCountry: The ISO 3166-1 alpha-2 country code.
    - flag: URL to the country's flag image.
    - sport: The primary sport associated with the country in the database.

Example Response Snippet:
{
  "countries": [
    {
      "idCountry": "1",
      "nameCountry": "England",
      "codeCountry": "ENG",
      "flag": "https://www.thesportsdb.com/images/flags/eng.png",
      "sport": "Soccer"
    },
    {
      "idCountry": "2",
      "nameCountry": "France",
      "codeCountry": "FRA",
      "flag": "https://www.thesportsdb.com/images/flags/fra.png",
      "sport": "Soccer"
    }
    // ... more countries
  ]
}

Error Conditions:
  - 404 Not Found: If the API endpoint is incorrect or unavailable.
  - 500 Internal Server Error: If there's a server-side issue.
```

--------------------------------

### TheSportsDB V2 API All Data Endpoints

Source: https://thedatadb.readme.io/reference/getequipmentbyid

Endpoints for retrieving comprehensive lists of all available sports, leagues, and teams, often categorized by sport.

```APIDOC
Get All Countries:
  GET /getallteamsbysport
  Description: Retrieves a list of all countries for which sports data is available.
  Parameters: Implicitly takes sport parameter to list countries related to that sport.
  Returns: List of countries.

Get All Sports:
  GET /getallplayersbysport
  Description: Retrieves a list of all sports supported by the API.
  Parameters: Implicitly takes sport parameter to list players related to that sport.
  Returns: List of sports.

Get All Leagues:
  GET /getallleaguesbysport
  Description: Retrieves a list of all leagues available, often filtered by sport.
  Parameters: Implicitly takes sport parameter.
  Returns: List of leagues.
```

--------------------------------

### TheSportsDB V2 API All Data Endpoints

Source: https://thedatadb.readme.io/reference/v1-api-video

Endpoints for retrieving comprehensive lists of all available sports, leagues, and teams, often categorized by sport.

```APIDOC
Get All Countries:
  GET /getallteamsbysport
  Description: Retrieves a list of all countries for which sports data is available.
  Parameters: Implicitly takes sport parameter to list countries related to that sport.
  Returns: List of countries.

Get All Sports:
  GET /getallplayersbysport
  Description: Retrieves a list of all sports supported by the API.
  Parameters: Implicitly takes sport parameter to list players related to that sport.
  Returns: List of sports.

Get All Leagues:
  GET /getallleaguesbysport
  Description: Retrieves a list of all leagues available, often filtered by sport.
  Parameters: Implicitly takes sport parameter.
  Returns: List of leagues.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/v2-api-schedule

Provides endpoints to list all available sports, countries, and leagues, as well as search functionalities for leagues, seasons, teams, and players.

```APIDOC
GET /getallsports
  Description: Retrieves a list of all supported sports.
  Returns: List of sports.

GET /getallcountries
  Description: Retrieves a list of all supported countries.
  Returns: List of countries.

GET /getallleagues
  Description: Retrieves a list of all supported leagues.
  Returns: List of leagues.

GET /searchallleagues
  Description: Searches for leagues based on provided criteria.
  Parameters:
    - name: Name of the league to search.
    - country: Country of the league.
  Returns: List of leagues matching the search.

GET /searchallseasons
  Description: Searches for seasons based on provided criteria.
  Parameters:
    - season: The season year to search.
  Returns: List of seasons.

GET /searchallteams
  Description: Searches for teams based on provided criteria.
  Parameters:
    - name: Name of the team to search.
    - country: Country of the team.
    - league: League of the team.
  Returns: List of teams matching the search.

GET /lookupallplayers
  Description: Retrieves a list of all players.
  Returns: List of all players.
```

--------------------------------

### List Teams by League ID API

Source: https://thedatadb.readme.io/reference/v2-api-list

Retrieves a list of all teams belonging to a specific league using its unique ID. This endpoint requires a GET request.

```APIDOC
GET /api/v2/json/list/teams/{idLeague}
  Description: List all teams in a particular league by its unique ID.
  Parameters:
    - idLeague (Path Parameter, Integer): The unique identifier for the league.
  Returns:
    - JSON object containing a list of teams.
  Example:
    GET https://www.thesportsdb.com/api/v2/json/list/teams/4328
```

--------------------------------

### Get Next Events Endpoint

Source: https://thedatadb.readme.io/reference/v1-api-schedule

This endpoint retrieves the next upcoming events for a specified team. It requires an API key and the Team ID to function correctly.

```APIDOC
Endpoint: /eventsnext.php

Method: GET

Description:
  Retrieves the next few upcoming events for a team using the Team ID.

URL:
  https://www.thesportsdb.com/api/v1/json/{api-key}/eventsnext.php

Parameters:
  - api-key (string, required): Your unique API key.
  - teamid (integer, required): The ID of the team for which to fetch events.

Example Usage:
  GET https://www.thesportsdb.com/api/v1/json/123/eventsnext.php?teamid=130001

Response:
  The API returns a JSON object containing event details. Users can click 'Try It!' to see the response.
```

--------------------------------

### V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/getnextsoccereventsbyleague

Provides an endpoint to retrieve highlight videos for specific events.

```APIDOC
GET /geteventhighlights
  Description: Retrieves highlight videos for a specific event.
  Parameters:
    - id: The unique identifier for the event.
  Returns: List of highlight videos for the event.
```

--------------------------------

### Lookup Player Milestones API

Source: https://thedatadb.readme.io/reference/lookupplayermilestonesbyid

Retrieves player milestones using the player's unique ID. This endpoint requires a GET request to the specified URL.

```APIDOC
API Endpoint: Lookup Player Milestones

Description: Look up player milestones by player ID.

Method: GET

URL: https://www.thesportsdb.com/api/v2/json/lookup/player_milestones/{idPlayer}

Parameters:
  - idPlayer (Path Parameter): The unique identifier for the player. This is a required field.

Example Request:
GET https://www.thesportsdb.com/api/v2/json/lookup/player_milestones/130000

Response:
Returns a JSON object containing player milestone data. The exact structure depends on the API's current schema.

Notes:
- No specific authentication or API key is mentioned in the provided documentation snippet.
- The response structure is not detailed, but typically includes player information and their achievements.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/getnextsoccereventsbyleague

Provides endpoints to list all available sports, countries, and leagues, as well as search functionalities for leagues, seasons, teams, and players.

```APIDOC
GET /getallsports
  Description: Retrieves a list of all supported sports.
  Returns: List of sports.

GET /getallcountries
  Description: Retrieves a list of all supported countries.
  Returns: List of countries.

GET /getallleagues
  Description: Retrieves a list of all supported leagues.
  Returns: List of leagues.

GET /searchallleagues
  Description: Searches for leagues based on provided criteria.
  Parameters:
    - name: Name of the league to search.
    - country: Country of the league.
  Returns: List of leagues matching the search.

GET /searchallseasons
  Description: Searches for seasons based on provided criteria.
  Parameters:
    - season: The season year to search.
  Returns: List of seasons.

GET /searchallteams
  Description: Searches for teams based on provided criteria.
  Parameters:
    - name: Name of the team to search.
    - country: Country of the team.
    - league: League of the team.
  Returns: List of teams matching the search.

GET /lookupallplayers
  Description: Retrieves a list of all players.
  Returns: List of all players.
```

--------------------------------

### THESPORTSDB V1 API Lookup Endpoints

Source: https://thedatadb.readme.io/reference/lookupplayercareerhistorybyid

Offers endpoints to retrieve detailed information about specific entities using their unique identifiers. These are primarily GET requests.

```APIDOC
GET /getleaguebyid
  Description: Retrieves league information by its ID.
  Parameters:
    - id: The unique identifier for the league.
  Returns: League details.

GET /gettablebyid
  Description: Retrieves table (standings) information by league ID.
  Parameters:
    - id: The unique identifier for the league.
  Returns: League standings.

GET /getteambyid
  Description: Retrieves team information by its ID.
  Parameters:
    - id: The unique identifier for the team.
  Returns: Team details.

GET /getequipmentbyid
  Description: Retrieves equipment information by its ID.
  Parameters:
    - id: The unique identifier for the equipment.
  Returns: Equipment details.

GET /getplayerbyid
  Description: Retrieves player information by their ID.
  Parameters:
    - id: The unique identifier for the player.
  Returns: Player details.

GET /gethonourbyid
  Description: Retrieves honour information by its ID.
  Parameters:
    - id: The unique identifier for the honour.
  Returns: Honour details.

GET /getformerteamsbyplayerid
  Description: Retrieves a list of former teams for a given player ID.
  Parameters:
    - id: The unique identifier for the player.
  Returns: List of former teams.

GET /getmilestonesbyplayerid
  Description: Retrieves a list of milestones for a given player ID.
  Parameters:
    - id: The unique identifier for the player.
  Returns: List of player milestones.

GET /getcontractsbyplayerid
  Description: Retrieves a list of contracts for a given player ID.
  Parameters:
    - id: The unique identifier for the player.
  Returns: List of player contracts.

GET /geteventbyid
  Description: Retrieves event information by its ID.
  Parameters:
    - id: The unique identifier for the event.
  Returns: Event details.

GET /geteventresults
  Description: Retrieves results for events.
  Parameters:
    - (Optional) eventId: Filter results by a specific event ID.
  Returns: Event results.

GET /getlineupbyeventid
  Description: Retrieves the lineup for a specific event ID.
  Parameters:
    - id: The unique identifier for the event.
  Returns: Event lineup.

GET /gettimelinebyeventid
  Description: Retrieves the timeline for a specific event ID.
  Parameters:
    - id: The unique identifier for the event.
  Returns: Event timeline.

GET /geteventstatsbyid
  Description: Retrieves statistics for a specific event ID.
  Parameters:
    - id: The unique identifier for the event.
  Returns: Event statistics.

GET /gettvbyeventid
  Description: Retrieves TV broadcast information for a specific event ID.
  Parameters:
    - id: The unique identifier for the event.
  Returns: TV broadcast details.

GET /getvenuebyid
  Description: Retrieves venue information by its ID.
  Parameters:
    - id: The unique identifier for the venue.
  Returns: Venue details.
```

--------------------------------

### List Teams by League ID API

Source: https://thedatadb.readme.io/reference/listteamsbyleagueid

Retrieves a list of all teams belonging to a specific league using its unique ID. This endpoint requires a GET request.

```APIDOC
GET /api/v2/json/list/teams/{idLeague}
  Description: List all teams in a particular league by its unique ID.
  Parameters:
    - idLeague (Path Parameter, Integer): The unique identifier for the league.
  Returns:
    - JSON object containing a list of teams.
  Example:
    GET https://www.thesportsdb.com/api/v2/json/list/teams/4328
```

--------------------------------

### THESPORTSDB V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/getequipmentbyid

Provides endpoints to retrieve comprehensive lists of sports-related data, such as all available sports, countries, leagues, and seasons.

```APIDOC
GET /api/v1/getallsports.php
  Description: Retrieves a list of all available sports.
  Returns: A list of sports.

GET /api/v1/getallcountries.php
  Description: Retrieves a list of all available countries.
  Returns: A list of countries.

GET /api/v1/getallleagues.php
  Description: Retrieves a list of all available leagues.
  Returns: A list of leagues.

GET /api/v1/searchallleagues.php?s={seasonID}
  Description: Searches for all leagues associated with a specific season.
  Parameters:
    - s (integer, required): The season ID.
  Returns: A list of leagues for the season.

GET /api/v1/searchallseasons.php?l={leagueID}
  Description: Searches for all seasons associated with a specific league.
  Parameters:
    - l (integer, required): The league ID.
  Returns: A list of seasons for the league.

GET /api/v1/searchallteams.php?l={leagueID}
  Description: Searches for all teams within a specific league.
  Parameters:
    - l (integer, required): The league ID.
  Returns: A list of teams in the league.

GET /api/v1/lookupallplayers.php?id={teamID}
  Description: Retrieves a list of all players associated with a specific team.
  Parameters:
    - id (integer, required): The team ID.
  Returns: A list of players for the team.
```

--------------------------------

### V1 API List/Search All Endpoints

Source: https://thedatadb.readme.io/reference/getnextleagueevents

Provides endpoints to list all available sports, countries, leagues, and to search across all entities for leagues, seasons, teams, and players.

```APIDOC
THESPORTSDB V1 API List/Search All:

Get All Sports (GET)
  - Endpoint: /all_sports.php
  - Description: Retrieves a list of all available sports.

Get All Countries (GET)
  - Endpoint: /all_countries.php
  - Description: Retrieves a list of all supported countries.

Get All Leagues (GET)
  - Endpoint: /all_leagues.php
  - Description: Retrieves a list of all available leagues.

Search All Leagues (GET)
  - Endpoint: /search_all_leagues.php
  - Description: Searches for leagues based on provided parameters.
  - Parameters:
    - c: Country name (optional).
    - s: Sport name (optional).

Search All Seasons (GET)
  - Endpoint: /search_all_seasons.php
  - Description: Searches for seasons based on provided parameters.
  - Parameters:
    - idLeague: League ID (optional).
    - season: Season name (optional).

Search All Teams (GET)
  - Endpoint: /search_all_teams.php
  - Description: Searches for teams based on provided parameters.
  - Parameters:
    - idTeam: Team ID (optional).
    - l: League name (optional).
    - s: Season name (optional).

Lookup All Players (GET)
  - Endpoint: /lookup_all_players.php
  - Description: Retrieves all players associated with a team or league.
  - Parameters:
    - idTeam: Team ID (optional).
    - idLeague: League ID (optional).
```

--------------------------------

### Get Next Events Endpoint

Source: https://thedatadb.readme.io/reference/getnextevents

This endpoint retrieves the next upcoming events for a specified team. It requires an API key and the Team ID to function correctly.

```APIDOC
Endpoint: /eventsnext.php

Method: GET

Description:
  Retrieves the next few upcoming events for a team using the Team ID.

URL:
  https://www.thesportsdb.com/api/v1/json/{api-key}/eventsnext.php

Parameters:
  - api-key (string, required): Your unique API key.
  - teamid (integer, required): The ID of the team for which to fetch events.

Example Usage:
  GET https://www.thesportsdb.com/api/v1/json/123/eventsnext.php?teamid=130001

Response:
  The API returns a JSON object containing event details. Users can click 'Try It!' to see the response.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/getmilestonesbyplayerid

Provides endpoints to retrieve lists of all available sports, countries, leagues, and players. These are useful for populating dropdowns or getting an overview of the data.

```APIDOC
Get All Sports (GET)
  Endpoint: /getallsports
  Description: Retrieves a list of all sports available in the database.
  Returns: A list of sports.

Get All Countries (GET)
  Endpoint: /getallcountries
  Description: Retrieves a list of all countries represented in the database.
  Returns: A list of countries.

Get All Leagues (GET)
  Endpoint: /getallleagues
  Description: Retrieves a list of all leagues available in the database.
  Returns: A list of leagues.

Search All Leagues (GET)
  Endpoint: /searchallleagues
  Description: Searches across all leagues, potentially by name or other criteria.
  Returns: A list of leagues matching the search.

Search All Seasons (GET)
  Endpoint: /searchallseasons
  Description: Searches for available seasons across different sports and leagues.
  Returns: A list of seasons.

Search All Teams (GET)
  Endpoint: /searchallteams
  Description: Searches across all teams in the database.
  Returns: A list of teams matching the search.

Lookup All Players (GET)
  Endpoint: /lookupallplayers
  Description: Retrieves a list of all players available in the database.
  Returns: A list of players.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/gettvbyeventid

Provides endpoints to list all available sports, countries, leagues, and to search across these categories.

```APIDOC
GET /getallsports
  Description: Retrieves a list of all sports available in the database.
  Returns: A list of sports.

GET /getallcountries
  Description: Retrieves a list of all countries.
  Returns: A list of countries.

GET /getallleagues
  Description: Retrieves a list of all leagues.
  Returns: A list of leagues.

GET /searchallleagues
  Description: Searches for leagues based on provided criteria.
  Parameters:
    - (Optional) sport: Filter by sport.
    - (Optional) country: Filter by country.
  Returns: A list of leagues matching the search.

GET /searchallseasons
  Description: Searches for seasons based on provided criteria.
  Parameters:
    - (Optional) sport: Filter by sport.
    - (Optional) league: Filter by league.
  Returns: A list of seasons matching the search.

GET /searchallteams
  Description: Searches for teams across all sports and leagues.
  Parameters:
    - (Optional) sport: Filter by sport.
    - (Optional) league: Filter by league.
    - (Optional) name: Filter by team name.
  Returns: A list of teams matching the search.

GET /lookupallplayers
  Description: Retrieves a list of all players.
  Returns: A list of players.
```

--------------------------------

### Get Events by TV Endpoint

Source: https://thedatadb.readme.io/reference/geteventsbytv

Retrieves all events for a particular TV station and allows filtering by league ID. Requires an API key. The response format is JSON.

```APIDOC
GET https://www.thesportsdb.com/api/v1/json/{api-key}/eventstv.php

Description:
  Retrieves all events for a particular TV station and allows filtering by league ID.

Parameters:
  {api-key}: Your unique API key for TheSportsDB.
  (Optional) league_id: Filter events by a specific league ID.

Example Request:
  GET https://www.thesportsdb.com/api/v1/json/123/eventstv.php?league_id=4328

Response:
  JSON object containing event data.
```

--------------------------------

### THESPORTSDB V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/lookupplayerbyid

Provides access to video highlights for events through the THESPORTSDB V1 API.

```APIDOC
GET /geteventhighlights
  Description: Retrieves video highlights for a specific event.
  Parameters:
    - id (string): The unique identifier for the event.
  Returns:
    - Video highlight object or URL.
```

--------------------------------

### V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/getprevioussoccereventsbyleague

Endpoints for retrieving lists of all available sports, countries, leagues, and for searching across seasons and teams. These provide overview data and search capabilities across broad categories.

```APIDOC
Get All Sports (GET):
  Endpoint: /getallsports
  Description: Retrieves a list of all supported sports.
  Returns: List of sports.

Get All Countries (GET):
  Endpoint: /getallcountries
  Description: Retrieves a list of all supported countries.
  Returns: List of countries.

Get All Leagues (GET):
  Endpoint: /getallleagues
  Description: Retrieves a list of all supported leagues.
  Returns: List of leagues.

Search All Leagues (GET):
  Endpoint: /searchallleagues
  Description: Searches for leagues based on various criteria.
  Parameters:
    - name: Optional. Name of the league to search for.
    - country: Optional. Country of the league.
  Returns: List of leagues matching the search criteria.

Search All Seasons (GET):
  Endpoint: /searchallseasons
  Description: Searches for available seasons across different leagues.
  Parameters:
    - league: Optional. League name to filter seasons.
    - season: Optional. Season year to filter.
  Returns: List of seasons.

Search All Teams (GET):
  Endpoint: /searchallteams
  Description: Searches for teams across all leagues and countries.
  Parameters:
    - name: Optional. Name of the team to search for.
    - league: Optional. League name to filter teams.
    - country: Optional. Country name to filter teams.
  Returns: List of teams matching the search criteria.

Lookup All Players (GET):
  Endpoint: /lookupallplayers
  Description: Retrieves a list of all players, potentially with filtering options.
  Parameters:
    - name: Optional. Name of the player to search for.
  Returns: List of players.
```

--------------------------------

### TheSportsDB V1 API List Endpoints

Source: https://thedatadb.readme.io/reference/searchteambyname

Provides endpoints to list all available sports, countries, leagues, and to search across these categories. Useful for populating dropdowns or getting overview data.

```APIDOC
Get All Sports:
  GET /allsports.php
  Description: Retrieves a list of all supported sports.

Get All Countries:
  GET /allcountries.php
  Description: Retrieves a list of all supported countries.

Get All Leagues:
  GET /allleagues.php
  Description: Retrieves a list of all supported leagues.

Search All Leagues:
  GET /searchallleagues.php
  Description: Searches for leagues based on various criteria.
  Parameters:
    - s: Sport name.
    - c: Country name.
    - l: League name.

Search All Seasons:
  GET /searchallseasons.php
  Description: Searches for available seasons.
  Parameters:
    - idLeague: League ID.
    - strSeason: Season name (e.g., '2023-2024').

Search All Teams:
  GET /searchallteams.php
  Description: Searches for all teams across different leagues and sports.
  Parameters:
    - s: Sport name.
    - l: League name.

Lookup All Players:
  GET /lookupallplayers.php
  Description: Retrieves a list of all players.
  Parameters:
    - idTeam: Team ID (optional).
    - idLeague: League ID (optional).
```

--------------------------------

### V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/v2-api-schedule

Provides an endpoint to retrieve highlight videos for specific events.

```APIDOC
GET /geteventhighlights
  Description: Retrieves highlight videos for a specific event.
  Parameters:
    - id: The unique identifier for the event.
  Returns: List of highlight videos for the event.
```

--------------------------------

### Lookup Table API Endpoint

Source: https://thedatadb.readme.io/reference/gettablebyid

Retrieves information about a specific table using its unique identifier via an HTTP GET request. The API key is a required placeholder in the URL.

```APIDOC
Lookup Table API:
  Endpoint: GET https://www.thesportsdb.com/api/v1/json/{api-key}/lookuptable.php
  Description: Get information about a specific table by its unique identifier.
  Parameters:
    - {api-key}: Your unique API key (required placeholder in the URL).
  Base URL Example:
    https://www.thesportsdb.com/api/v1/json/123/lookuptable.php
  Response:
    The response format is not detailed in the provided documentation, but users can test requests via the 'Try It!' feature.
```

--------------------------------

### V1 API Video Endpoints

Source: https://thedatadb.readme.io/reference/getnextsoccereventsbyteam

Endpoint for retrieving video highlights of specific soccer events.

```APIDOC
GET /geteventhighlights
  Description: Retrieves video highlights for a specific event.
  Parameters:
    - eventid (integer): The unique identifier for the event.
  Returns:
    - Event highlights object, including video URLs.
```
Tokens:
Raw