API Documentation

Complete reference for the ClearSports API. All endpoints, parameters, and examples. Click "Try it" on any endpoint to test it right here.

Authentication

All protected endpoints require an API key passed in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Credit System

Each API call consumes 1 credit
Default allocation: 100 credits per API key
When credits reach 0, API access is denied with 403 Forbidden

API Key Management

GET/api/v1/api-keys/me

Get My API Key Info

Retrieve information about your current API key.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/api-keys/me"

Response Example

{
  "key_prefix": "sk_live_abc...",
  "email": "user@example.com",
  "credits_remaining": 85,
  "credits_total": 100,
  "is_active": true,
  "last_used_at": "2025-12-25T10:30:00Z",
  "created_at": "2025-12-20T08:00:00Z"
}

GET/api/v1/api-keys/me/usage

Get My Usage History

Retrieve detailed usage history for your API key.

Query Parameters

limit

Number of records to returnExample: 50

offset

Pagination offsetExample: 0

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/api-keys/me/usage"

GET/api/v1/api-keys/me/stats

Get My Usage Statistics

Get aggregated usage statistics for your API key.

Query Parameters

start_date

Start date for statistics (ISO 8601 format)Example: 2025-12-01T00:00:00Z

end_date

End date for statistics (ISO 8601 format)Example: 2025-12-25T23:59:59Z

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/api-keys/me/stats"

NFL Endpoints

All NFL endpoints are protected and consume 1 credit per call.

GET/api/v1/nfl/teams

Get NFL Teams

Retrieve all NFL teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/teams"

GET/api/v1/nfl/teams/:teamId

Get NFL Team by ID

Retrieve a specific NFL team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/teams/:teamId"

GET/api/v1/nfl/games

Get NFL Games

Retrieve NFL games.

Query Parameters

season

Season year (e.g., 2024)Example: 2024

week

Week numberExample: 15

team_id

Filter by team IDExample: 123

date

Filter by date (YYYY-MM-DD)Example: 2024-12-25

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/games"

GET/api/v1/nfl/game-odds

Get NFL Game Odds

Retrieve betting odds for NFL games (includes gzip compression and caching).

Query Parameters

game_id

Filter by game ID

season

Season year

week

Week number

sportsbook

Filter by sportsbook nameExample: DraftKings

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/game-odds"

GET/api/v1/nfl/player-stats

Get NFL Player Stats

Retrieve player statistics for NFL games.

Query Parameters

game_id

Filter by game ID

player_id

Filter by player ID

team_id

Filter by team ID

season

Season year

week

Week number

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/player-stats"

GET/api/v1/nfl/team-stats

Get NFL Team Stats

Retrieve team statistics for NFL games.

Query Parameters

game_id

Filter by game ID

team_id

Filter by team ID

season

Season year

week

Week number

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/team-stats"

GET/api/v1/nfl/injury-stats

Get NFL Injury Stats

Retrieve injury reports for NFL players.

Query Parameters

team_id

Filter by team ID

player_id

Filter by player ID

week

Week number

season

Season year

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nfl/injury-stats"

NCAAF Endpoints

All NCAAF (College Football) endpoints follow the same structure as NFL endpoints.

GET/api/v1/ncaaf/teams

Get NCAAF Teams

Retrieve all NCAAF teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/teams"

GET/api/v1/ncaaf/teams/:teamId

Get NCAAF Team by ID

Retrieve a specific NCAAF team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/teams/:teamId"

GET/api/v1/ncaaf/games

Get NCAAF Games

Retrieve NCAAF games.

Query Parameters

season

Season yearExample: 2024

week

Week numberExample: 12

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/games"

GET/api/v1/ncaaf/game-odds

Get NCAAF Game Odds

Retrieve betting odds for NCAAF games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/game-odds"

GET/api/v1/ncaaf/player-stats

Get NCAAF Player Stats

Retrieve player statistics for NCAAF games.

Query Parameters

game_id

Filter by game ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/player-stats"

GET/api/v1/ncaaf/team-stats

Get NCAAF Team Stats

Retrieve team statistics for NCAAF games.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaaf/team-stats"

NBA Endpoints

GET/api/v1/nba/teams

Get NBA Teams

Retrieve all NBA teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/teams"

GET/api/v1/nba/teams/:teamId

Get NBA Team by ID

Retrieve a specific NBA team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/teams/:teamId"

GET/api/v1/nba/games

Get NBA Games

Retrieve NBA games.

Query Parameters

season

Season yearExample: 2024

date

Game date (YYYY-MM-DD)Example: 2024-12-25

team_id

Filter by team IDExample: 123

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/games"

GET/api/v1/nba/players

Get NBA Players

Retrieve NBA players.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/players"

GET/api/v1/nba/game-odds

Get NBA Game Odds

Retrieve betting odds for NBA games.

Query Parameters

game_id

Filter by game ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/game-odds"

GET/api/v1/nba/injury-stats

Get NBA Injury Stats

Retrieve injury reports for NBA players.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/injury-stats"

GET/api/v1/nba/team-stats

Get NBA Team Stats

Retrieve team statistics for NBA games.

Query Parameters

team_id

Filter by team ID

season

Season year

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/team-stats"

GET/api/v1/nba/player-stats

Get NBA Player Stats

Retrieve player statistics for NBA games.

Query Parameters

player_id

Filter by player ID

game_id

Filter by game ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/player-stats"

GET/api/v1/nba/predictions

Get NBA Predictions

Retrieve AI-powered NBA game predictions.

Query Parameters

game_id

Filter by game ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nba/predictions"

NHL Endpoints

GET/api/v1/nhl/teams

Get NHL Teams

Retrieve all NHL teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/teams"

GET/api/v1/nhl/teams/:teamId

Get NHL Team by ID

Retrieve a specific NHL team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/teams/:teamId"

GET/api/v1/nhl/games

Get NHL Games

Retrieve NHL games.

Query Parameters

date

Game date (YYYY-MM-DD)

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/games"

GET/api/v1/nhl/players

Get NHL Players

Retrieve NHL players.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/players"

GET/api/v1/nhl/game-odds

Get NHL Game Odds

Retrieve betting odds for NHL games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/game-odds"

GET/api/v1/nhl/injury-stats

Get NHL Injury Stats

Retrieve injury reports for NHL players.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/injury-stats"

GET/api/v1/nhl/team-stats

Get NHL Team Stats

Retrieve team statistics for NHL games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/team-stats"

GET/api/v1/nhl/player-stats

Get NHL Player Stats

Retrieve player statistics for NHL games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/nhl/player-stats"

MLB Endpoints

GET/api/v1/mlb/teams

Get MLB Teams

Retrieve all MLB teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/mlb/teams"

GET/api/v1/mlb/teams/:teamId

Get MLB Team by ID

Retrieve a specific MLB team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/mlb/teams/:teamId"

GET/api/v1/mlb/games

Get MLB Games

Retrieve MLB games.

Query Parameters

date

Game date (YYYY-MM-DD)

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/mlb/games"

GET/api/v1/mlb/players

Get MLB Players

Retrieve MLB players.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/mlb/players"

GET/api/v1/mlb/game-odds

Get MLB Game Odds

Retrieve betting odds for MLB games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/mlb/game-odds"

Soccer Leagues

All soccer leagues share the same endpoint structure. Supported leagues: EPL, La Liga, Bundesliga, MLS, Ligue 1, Liga Portugal, UEFA, Eredivisie, Serie A, Liga MX, Brazilian Serie A.

GET/api/v1/epl/teams

Get EPL Teams

Retrieve all EPL (English Premier League) teams.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/teams"

GET/api/v1/epl/teams/:teamId

Get EPL Team by ID

Retrieve a specific EPL team by ID.

Path Parameters

teamId*

The team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/teams/:teamId"

GET/api/v1/epl/games

Get EPL Games

Retrieve EPL games.

Query Parameters

date

Game date (YYYY-MM-DD)

team_id

Filter by team ID

season

Season (e.g., 2024-2025)

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/games"

GET/api/v1/epl/game-odds

Get EPL Game Odds

Retrieve betting odds for EPL games.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/game-odds"

GET/api/v1/epl/team-stats

Get EPL Team Stats

Retrieve team statistics for EPL games.

Query Parameters

team_id

Filter by team ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/team-stats"

GET/api/v1/epl/player-stats

Get EPL Player Stats

Retrieve player statistics for EPL games.

Query Parameters

player_id

Filter by player ID

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/epl/player-stats"

Sportsbooks

GET/api/v1/sportsbooks

Get Sportsbooks

Get list of available sportsbooks and their information.

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/sportsbooks"

Response Example

[
  {
    "id": "123",
    "name": "DraftKings",
    "website": "https://www.draftkings.com",
    "supported_sports": [
      "NFL",
      "NBA",
      "MLB",
      "NHL",
      "Soccer"
    ]
  }
]

News

GET/api/v1/news

Get Sports News Feed

Get aggregated sports news feed.

Query Parameters

sport

Filter by sport (e.g., NFL, NBA, Soccer)

limit

Number of news itemsExample: 50

offset

Pagination offsetExample: 0

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/news"

Predictions

GET/api/v1/soccer/predictions

Get Soccer Predictions V1

Get AI-powered soccer match predictions.

Query Parameters

league

Filter by league

date

Filter by date (YYYY-MM-DD)

team_id

Filter by team

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/soccer/predictions"

GET/api/v2/soccer/predictions

Get Soccer Predictions V2

Enhanced version of soccer predictions with improved accuracy.

Query Parameters

league

Filter by league

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v2/soccer/predictions"

Error Responses

401 Unauthorized

{
  "error": "unauthorized",
  "message": "Invalid or missing API key"
}

403 Forbidden (Insufficient Credits)

{
  "error": "insufficient_credits",
  "message": "Your API key has insufficient credits",
  "credits_remaining": 0
}

429 Too Many Requests

{
  "error": "rate_limit_exceeded",
  "message": "Too many API key requests. Please try again in an hour.",
  "retry_after": 3600
}

400 Bad Request

{
  "error": "invalid_request",
  "message": "Invalid request parameters"
}

404 Not Found

{
  "error": "not_found",
  "message": "Resource not found"
}

500 Internal Server Error

{
  "error": "internal_error",
  "message": "An internal server error occurred"
}