ClearSports

ClearSports API

ClearSports API as documented publicly: 16 operations. Contract generated from the documentation by API Evangelist (2026-11-13); not the provider's own document.

GitHub OpenAPI

Operations 16

GET /api/v1/api-keys/me GET /api/v1/api-keys/me #
GET /api/v1/api-keys/me/stats Get My Usage Statistics – call counts between start_date and end_date #
GET /api/v1/api-keys/me/usage Get My Usage History – per-call usage with limit and offset #
GET /api/v1/news GET /api/v1/news #
GET /api/v1/news-wire News wire – sports news articles with links, images and team tags, newest first #
GET /api/v1/news-wire/league/{league} News wire filtered by league #
GET /api/v1/news-wire/sport/{sport} News wire filtered by sport #
GET /api/v1/news-wire/sport/{sport}/league/{league} News wire filtered by sport and league #
GET /api/v1/sportsbooks Sportsbooks – the sportsbooks that odds rows reference, with logos #
GET /api/v1/{league}/game-odds Game odds Moneyline, spread and total prices from US sportsbooks, in American, decimal and fractional form. #
GET /api/v1/{league}/games Games #
GET /api/v1/{league}/injury-stats Injuries – the current injury report, one row per listed player #
GET /api/v1/{league}/player-stats Player stats Season totals, one row per player. #
GET /api/v1/{league}/team-stats Team stats Season stats, one row per team. #
GET /api/v1/{league}/teams Teams #
GET /api/v1/{league}/teams/{teamid} Team by ID #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/clearsportsapi-com/openapi/_ae-authored/clearsportsapi-com-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-player-stats-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-team-stats-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-game-odds-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-games-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-teams-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/clearsportsapi-com/json-schema/clearsportsapi-com-get-api-v1-league-teams-teamid-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/clearsportsapi-com:clearsportsapi-com-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

clearsportsapi-com-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: ClearSports API
  version: '2026-11-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-13: 16 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; ClearSports has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 15
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.clearsportsapi.com/docs/playground?path=%2Fapi%2Fv1%2Fapi-keys%2Fme
  - https://www.clearsportsapi.com/docs
servers:
- url: https://api.clearsportsapi.com
paths:
  /api/v1/api-keys/me:
    get:
      operationId: get_api_v1_api_keys_me
      tags:
      - Api
      summary: GET /api/v1/api-keys/me
      x-source: https://www.clearsportsapi.com/docs/playground?path=%2Fapi%2Fv1%2Fapi-keys%2Fme
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -s -X GET https://api.clearsportsapi.com/api/v1/api-keys/me  -H "Authorization: Bearer $CLEARSPORTS_KEY"

          NEW

          NFL 2026 odds, injuries, and this week''s slate are live.

          Open NFL'
  /api/v1/api-keys/me/stats:
    get:
      operationId: get_api_v1_api_keys_me_stats
      tags:
      - Api
      summary: Get My Usage Statistics – call counts between start_date and end_date
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: start_date
        in: query
        required: false
        schema:
          type: string
        description: Start date for statistics (ISO 8601 format)
      - name: end_date
        in: query
        required: false
        schema:
          type: string
        description: End date for statistics (ISO 8601 format)
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/api-keys/me/usage:
    get:
      operationId: get_api_v1_api_keys_me_usage
      tags:
      - Api
      summary: Get My Usage History – per-call usage with limit and offset
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Number of records to return
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Pagination offset
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/news:
    get:
      operationId: get_api_v1_news
      tags:
      - Api
      summary: GET /api/v1/news
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/news-wire:
    get:
      operationId: get_api_v1_news_wire
      tags:
      - Api
      summary: News wire – sports news articles with links, images and team tags, newest first
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1-100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Rows to skip, default 0
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: published_at (default), created_at or headline
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: desc (default) or asc
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/news-wire/league/{league}:
    get:
      operationId: get_api_v1_news_wire_league_league
      tags:
      - Api
      summary: News wire filtered by league
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1-100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Rows to skip, default 0
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: published_at (default), created_at or headline
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: desc (default) or asc
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/news-wire/sport/{sport}:
    get:
      operationId: get_api_v1_news_wire_sport_sport
      tags:
      - Api
      summary: News wire filtered by sport
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: sport
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1-100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Rows to skip, default 0
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: published_at (default), created_at or headline
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: desc (default) or asc
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/news-wire/sport/{sport}/league/{league}:
    get:
      operationId: get_api_v1_news_wire_sport_sport_league_league
      tags:
      - Api
      summary: News wire filtered by sport and league
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: sport
        in: path
        required: true
        schema:
          type: string
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: 1-100, default 50
      - name: offset
        in: query
        required: false
        schema:
          type: string
        description: Rows to skip, default 0
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: published_at (default), created_at or headline
      - name: order
        in: query
        required: false
        schema:
          type: string
        description: desc (default) or asc
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/sportsbooks:
    get:
      operationId: get_api_v1_sportsbooks
      tags:
      - Api
      summary: Sportsbooks – the sportsbooks that odds rows reference, with logos
      x-source: https://www.clearsportsapi.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/{league}/game-odds:
    get:
      operationId: get_api_v1_league_game_odds
      tags:
      - Api
      summary: Game odds Moneyline, spread and total prices from US sportsbooks, in American, decimal and fractional form.
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeagueGameOddsResponse'
      x-evidence:
        kind: documentation
  /api/v1/{league}/games:
    get:
      operationId: get_api_v1_league_games
      tags:
      - Api
      summary: Games
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeagueGamesResponse'
      x-evidence:
        kind: documentation
  /api/v1/{league}/injury-stats:
    get:
      operationId: get_api_v1_league_injury_stats
      tags:
      - Api
      summary: Injuries – the current injury report, one row per listed player
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: team_id
        in: query
        required: false
        schema:
          type: string
        description: Only that team's players, e.g. ?team_id=nfl_gb
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/{league}/player-stats:
    get:
      operationId: get_api_v1_league_player_stats
      tags:
      - Api
      summary: Player stats Season totals, one row per player.
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: team_id
        in: query
        required: false
        schema:
          type: string
        description: Only that team's players, e.g. ?team_id=nfl_kc
      - name: full_roster
        in: query
        required: false
        schema:
          type: string
        description: When true returns the whole roster (NBA, NCAAB, NHL).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeaguePlayerStatsResponse'
      x-evidence:
        kind: documentation
  /api/v1/{league}/team-stats:
    get:
      operationId: get_api_v1_league_team_stats
      tags:
      - Api
      summary: Team stats Season stats, one row per team.
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: team_id
        in: query
        required: false
        schema:
          type: string
        description: Only that team's row, e.g. ?team_id=nfl_kc
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeagueTeamStatsResponse'
      x-evidence:
        kind: documentation
  /api/v1/{league}/teams:
    get:
      operationId: get_api_v1_league_teams
      tags:
      - Api
      summary: Teams
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeagueTeamsResponse'
      x-evidence:
        kind: documentation
  /api/v1/{league}/teams/{teamid}:
    get:
      operationId: get_api_v1_league_teams_teamid
      tags:
      - Api
      summary: Team by ID
      x-source: https://www.clearsportsapi.com/docs
      parameters:
      - name: league
        in: path
        required: true
        schema:
          type: string
      - name: teamid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1LeagueTeamsTeamidResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1LeagueGameOddsResponse:
      type: object
      properties:
        game_odds:
          type: array
          description: Array of GameOdds objects.
        count:
          type: integer
          description: Number of rows returned.
    GetApiV1LeagueGamesResponse:
      type: object
      properties:
        games:
          type: array
          description: Array of Game objects
        count:
          type: integer
          description: Total number of games returned
    GetApiV1LeaguePlayerStatsResponse:
      type: object
      properties:
        <sport>_player_stats:
          type: array
          description: Array of player stats objects, key varies by sport.
        count:
          type: integer
          description: Number of rows returned.
    GetApiV1LeagueTeamStatsResponse:
      type: object
      properties:
        <sport>_team_stats:
          type: array
          description: Array of team stats objects, key varies by sport.
        count:
          type: integer
          description: Number of rows returned.
    GetApiV1LeagueTeamsResponse:
      type: object
      properties:
        teams:
          type: array
          description: Array of Team objects
        count:
          type: integer
          description: Total number of teams returned
    GetApiV1LeagueTeamsTeamidResponse:
      type: object
      properties:
        team:
          type: object
          description: Single Team object
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api