NFL API docs

Start with three NFL calls. Same schema for NBA, NHL, MLB, and soccer. Click "Try it" on any endpoint, or open the playground with your key.

Make your first call.

Three NFL calls for this week's lines and IR. Paste your key and run them in the playground.

GET /api/v1/nfl/gamesThis week's games and status
GET /api/v1/nfl/game-oddsMoneyline, spreads, and totals
GET /api/v1/nfl/injury-statsTeam injury reports

Odds and injuries Injury report fields Quarterback order

Run in playground

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
Tryout is $9/month for 1,000 credits. Keys already issued as free keep those credits.
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

Credits remaining, key prefix, and last used.

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

Per-call usage with limit and offset.

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

Call counts between start_date and end_date.

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

Moneyline, spread, and total for the NFL slate. Full dump; no filters.

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

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

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

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"

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

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

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

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

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 (tournament complete; historical coverage).

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 FIFA World Cup 2026 match schedule (group stage + knockouts). Tournament complete; returns the full historical 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 historical betting odds for FIFA World Cup 2026 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 2026 group standings: points, wins, draws, losses, goals for/against (final tables).

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 2026 player statistics by national team (historical; tournament complete). 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

Sportsbook id, name, site, and sports covered.

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

News items. Optional league filter.

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"

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. Retry 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": "Server error."
}