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: 1,000 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": 985,
  "credits_total": 1000,
  "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 all NFL games. This endpoint returns the full set and does not accept filter parameters.

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). Returns the full set and does not accept filter parameters.

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. Optionally filter by team.

Query Parameters

team_id

Filter by team ID (e.g., nfl_ari)Example: nfl_ari

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. Optionally filter by team.

Query Parameters

team_id

Filter by team ID (e.g., nfl_ari)Example: nfl_ari

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. Optionally filter by team.

Query Parameters

team_id

Filter by team ID (e.g., nfl_ari)Example: nfl_ari

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 all NCAAF games. Returns the full set and does not accept filter parameters.

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. Optionally filter by team.

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/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"

NCAAB Endpoints

All NCAAB (College Basketball) endpoints are protected and consume 1 credit per call.

GET/api/v1/ncaab/teams

Get NCAAB Teams

Retrieve all NCAAB teams.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/ncaab/teams/:teamId

Get NCAAB Team by ID

Retrieve a specific NCAAB 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/ncaab/teams/:teamId"

GET/api/v1/ncaab/games

Get NCAAB Games

Retrieve all NCAAB games. Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/ncaab/game-odds

Get NCAAB Game Odds

Retrieve betting odds for NCAAB games. Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/ncaab/injury-stats

Get NCAAB Injury Stats

Retrieve injury reports for NCAAB players. Optionally filter by team.

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/ncaab/injury-stats"

GET/api/v1/ncaab/team-stats

Get NCAAB Team Stats

Retrieve team statistics for NCAAB games. Optionally filter by team.

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/ncaab/team-stats"

GET/api/v1/ncaab/player-stats

Get NCAAB Player Stats

NCAAB player statistics. Optionally filter by team.

Query Parameters

team_id

Team ID

full_roster

Only applies with team_id: true returns the full roster instead of only players with stats

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/ncaab/player-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 all NBA games. Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/nba/game-odds

Get NBA Game Odds

Retrieve betting odds for NBA games. Returns the full set and does not accept filter parameters.

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. Optionally filter by team.

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/team-stats"

GET/api/v1/nba/player-stats

Get NBA Player Stats

NBA player statistics. Optionally filter by team.

Query Parameters

team_id

Team ID

full_roster

Only applies with team_id: true returns the full roster instead of only players with stats

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. Returns the full set and does not accept filter parameters.

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 all NHL games. Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

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. Optionally filter by team.

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/injury-stats"

GET/api/v1/nhl/team-stats

Get NHL Team Stats

Retrieve team statistics for NHL games. Optionally filter by team.

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/team-stats"

GET/api/v1/nhl/player-stats

Get NHL Player Stats

NHL player statistics. Optionally filter by team.

Query Parameters

team_id

Team ID

full_roster

Only applies with team_id: true returns the full roster instead of only players with stats

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 all MLB games. Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

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"

GET/api/v1/mlb/team-stats

Get MLB Team Stats

Retrieve team statistics for MLB teams (batting average, OBP, slugging, runs, home runs, ERA, WHIP, wins, losses, saves, fielding percentage). Optionally filter by team.

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/team-stats"

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, FIFA World Cup.

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 all EPL games. Returns the full set and does not accept filter parameters. (Applies to every soccer league: laliga, bundesliga, mls, ligue1, ligaportugal, uefa, eredivisie, seriea, ligamx, brazilian-serie-a.)

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. Optionally filter by team.

Query Parameters

team_id

Filter by team ID (e.g., epl_ars)

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/world-cup/teams

Get FIFA World Cup Teams

Retrieve all 48 FIFA World Cup 2026 national teams.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/world-cup/teams/:teamId

Get FIFA World Cup Team by ID

Retrieve a specific FIFA World Cup national 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/world-cup/teams/:teamId"

GET/api/v1/world-cup/games

Get FIFA World Cup Games

Retrieve the full FIFA World Cup 2026 match schedule (group stage + knockouts). Returns the full set and does not accept filter parameters.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/world-cup/game-odds

Get FIFA World Cup Game Odds

Retrieve betting odds for FIFA World Cup games: 3-way moneyline (home/draw/away), spreads, and totals across major sportsbooks.

Code Examples

Click "Try it" to test this endpoint

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

GET/api/v1/world-cup/team-stats

Get FIFA World Cup Team Stats

Retrieve FIFA World Cup group standings: points, wins, draws, losses, goals for/against.

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/world-cup/team-stats"

GET/api/v1/world-cup/player-stats

Get FIFA World Cup Player Stats

Retrieve FIFA World Cup player statistics by national team (best-effort; fills in through the tournament). Optionally filter by team.

Query Parameters

team_id

Filter by team ID (e.g., fifa_world_cup_ger)

Code Examples

Click "Try it" to test this endpoint

curl -X GET "https://api.clearsportsapi.com/api/v1/world-cup/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. Optionally filter by league.

Query Parameters

league

Filter by league (e.g., EPL, NFL)

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. Optionally filter by league.

Query Parameters

league

Filter by league

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"
}