Ball Don't Lie

Ball Don't Lie · Actions GPT

BallDontLie API

Access to NBA data including players, teams, and games

  • GET /playersGetAllPlayers

    Retrieves all players from all seasons

  • GET /players/{id}GetSpecificPlayer

    Retrieves a specific player by ID

  • GET /teamsGetAllTeams

    Retrieves all teams for the current season

  • GET /teams/{id}GetSpecificTeam

    Retrieves a specific team by ID

  • GET /gamesGetAllGames

    Retrieves all games for the current season

Schéma original API
{
  "openapi": "3.1.0",
  "info": {
    "title": "BallDontLie API",
    "description": "Access to NBA data including players, teams, and games",
    "version": "v1.0.0"
  },
  "servers": [
    {
      "url": "https://www.balldontlie.io/api/v1"
    }
  ],
  "paths": {
    "/players": {
      "get": {
        "description": "Retrieves all players from all seasons",
        "operationId": "GetAllPlayers",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "description": "Number of results per page, max 100",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 25
            }
          }
        ],
        "deprecated": false
      }
    },
    "/players/{id}": {
      "get": {
        "description": "Retrieves a specific player by ID",
        "operationId": "GetSpecificPlayer",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID of the player",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "deprecated": false
      }
    },
    "/teams": {
      "get": {
        "description": "Retrieves all teams for the current season",
        "operationId": "GetAllTeams",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Page number for pagination",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 0
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "description": "Number of results per page",
            "required": false,
            "schema": {
              "type": "integer",
              "default": 30
            }
          }
        ],
        "deprecated": false
      }
    },
    "/teams/{id}": {
      "get": {
        "description": "Retrieves a specific team by ID",
        "operationId": "GetSpecificTeam",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "ID of the team",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "deprecated": false
      }
    },
    "/games": {
      "get": {
        "description": "Retrieves all games for the current season",
        "operationId": "GetAllGames",
        "parameters": [
          {
            "name": "seasons",
            "in": "query",
            "description": "Filter games by seasons",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            }
          },
          {
            "name": "team_ids",
            "in": "query",
            "description": "Filter games by team IDs",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "integer"
              }
            }
          }
        ],
        "deprecated": false
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    },
    "schemas": {}
  }
}