stat-api — Sports Data

List every league/data group this API serves (nfl, nba, mlb, nhl, pga, dfs, reference) with table counts and availability. No credentials needed. Start here, then call list_tables.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List every queryable table in one league with a one-line summary each. No credentials needed. Follow with describe_table before querying.

{
  "type": "object",
  "properties": {
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    }
  },
  "required": [
    "league"
  ],
  "additionalProperties": false
}

Full contract for one table: fields with types and descriptions, the filters query_table accepts (with operators like __gte/__lte/__between/__like and required filter combinations), page-size limits, primary key, and a runnable example URL. No credentials needed. Always call this before query_table — filters not listed here are rejected.

{
  "type": "object",
  "properties": {
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    },
    "table": {
      "type": "string"
    }
  },
  "required": [
    "league",
    "table"
  ],
  "additionalProperties": false
}

Query any table. Returns `{"<table>": [rows], "limit": N, "next_from_id": M|null, "has_more": bool}`. To read every row, start with from_id=0 and re-call with from_id set to the previous next_from_id until it is null. A call without from_id returns the first page in the table's default sort with next_from_id null. filters is a flat object of `field` or `field__op` keys from describe_table (e.g. {"season_id": 2024, "day__between": "20250101,20250131"}). Requires a stat-api account: sign in when the app asks (free account at https://stat-api.com), or send an API key as Authorization: Bearer <key>. Every returned row counts against the monthly record quota.

{
  "type": "object",
  "properties": {
    "filters": {
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "field or field__op keys → scalar values; see describe_table",
      "type": "object"
    },
    "from_id": {
      "description": "keyset cursor: 0 for the first page of a full walk, then the previous next_from_id",
      "type": "integer"
    },
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    },
    "limit": {
      "minimum": 1,
      "type": "integer"
    },
    "table": {
      "type": "string"
    }
  },
  "required": [
    "league",
    "table"
  ],
  "additionalProperties": false
}

Fetch a single row by primary key. Returns the row object. Requires a stat-api sign-in or API key; costs 1 record of quota.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "primary-key value (integer or text PK)",
      "type": "string"
    },
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    },
    "table": {
      "type": "string"
    }
  },
  "required": [
    "league",
    "table",
    "id"
  ],
  "additionalProperties": false
}

Fuzzy player-name search (typo-tolerant). Currently NBA only — for other leagues query the players table with a name filter via query_table. Returns player rows ordered by match quality. Requires a stat-api sign-in or API key; rows count against quota.

{
  "type": "object",
  "properties": {
    "league": {
      "default": "nba",
      "enum": [
        "nba"
      ],
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "maxLength": 100,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

Games scheduled/played on one calendar date (US-Eastern) for nba, mlb, or nhl; defaults to today. Returns the same envelope as query_table on the games table. NFL is week-based, not date-based — for nfl, use query_table on nfl/games with season_id + week filters instead. Requires a stat-api sign-in or API key; rows count against quota.

{
  "type": "object",
  "properties": {
    "date": {
      "description": "YYYY-MM-DD; defaults to today in US-Eastern time",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "type": "string"
    },
    "league": {
      "enum": [
        "nba",
        "mlb",
        "nhl"
      ],
      "type": "string"
    }
  },
  "required": [
    "league"
  ],
  "additionalProperties": false
}

Run a GraphQL query against the same data with relations — nest from a game to its teams/players/odds in one call. Root fields are leagues (nfl, nba, …), each exposing its tables with the same filter arguments as REST plus `first`/`after` pagination. Do NOT send introspection queries (the schema is huge) — use describe_table instead; the SDL is at https://api.stat-api.com/api/v1/graphql/sdl. Requires a stat-api sign-in or API key; every row resolved anywhere in the tree counts against quota.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "variables": {
      "type": "object"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Your account's quota position: plan, monthly record limit, records used, remaining, and when the quota resets. Requires a stat-api sign-in or API key; costs 1 record.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}