API Documentation — Blaze Sports Intel

Overview

The Blaze Sports Intel API provides access to:

Real-time sports data — Scores, standings, schedules
Historical statistics — Records and trends
Advanced analytics — Predictions and projections
AI-powered insights — Natural language queries via Copilot

Multi-Sport Coverage: We cover MLB, NFL, NBA, College Baseball (all 300+ D1 programs), and NCAA Football with live scores, complete box scores, and real analytics.

Authentication

Most endpoints are publicly accessible. Premium endpoints require API key authentication.

API Key Header

Authorization: Bearer YOUR_API_KEY

Public Endpoints (No Auth Required)

GET /health
GET /mlb/standings
GET /nfl/standings
GET /college-baseball/standings

Premium Endpoints (Auth Required)

POST /copilot/* — AI insights
GET /v1/predictions/* — Game predictions
GET /college-baseball/scouting-professional

Rate Limiting

Plan	Requests/Min	Daily Limit
Free	10	1,000
Scout ($19/mo)	60	50,000
Pro ($49/mo)	300	500,000
Enterprise	Custom	Custom

Rate limit headers are included in all responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1699564800

College Baseball Endpoints

Our core specialty—comprehensive coverage for all 300+ NCAA D1 baseball programs.

GET /college-baseball/standings

Returns current standings for all D1 college baseball programs.

GET /college-baseball/rankings

D1Baseball Top 25 and other major polls.

GET /college-baseball/games?date=YYYY-MM-DD

Live and scheduled games for a specific date.

GET /college-baseball/box-score/:gameId

Complete box score with batting lines, pitching stats, and play-by-play.

Query Parameters

Parameter	Type	Description
`season`	integer	Season year (default: current)
`conference`	string	Filter by conference (e.g., "SEC")
`team`	string	Filter by team name or ID

Response Example

{
  "poll": "D1Baseball Top 25",
  "week": "Preseason 2025",
  "lastUpdated": "2025-12-10T12:00:00-06:00",
  "source": "D1Baseball.com",
  "rankings": [
    {
      "rank": 1,
      "team": "Texas A&M",
      "conference": "SEC",
      "previousRank": 1,
      "record": "0-0"
    }
  ],
  "meta": {
    "timezone": "America/Chicago",
    "cached": true,
    "cacheAge": 120
  }
}

MLB Endpoints

GET /mlb/standings

Current MLB standings by division.

GET /mlb/schedule?date=YYYY-MM-DD

MLB games schedule for a specific date.

GET /mlb/team/:teamId

Team information and season statistics.

NFL Endpoints

GET /nfl/standings

Current NFL standings by division.

GET /nfl/schedule?week=:weekNumber

NFL games for a specific week.

NBA Endpoints

GET /nba/standings

Current NBA standings by conference.

Predictions & Analytics

Premium Feature: Prediction endpoints require API key authentication.

GET /v1/predictions/:sport/games/:gameId

Win probability and game predictions.

GET /v1/predictive/:sport/player/:playerId

Player performance projections.

AI Copilot

Natural language interface for sports data queries.

POST /copilot/query

Ask questions in plain English about sports data.

Request Body

{
  "query": "Who leads the SEC in batting average?",
  "sport": "college-baseball",
  "context": {
    "season": 2025
  }
}

Response

{
  "answer": "Based on current season statistics...",
  "data": { /* Structured data */ },
  "sources": ["D1Baseball", "NCAA Stats"],
  "confidence": 0.95
}

Error Handling

HTTP Status Codes

Code	Description
200	Success
400	Bad Request — Invalid parameters
401	Unauthorized — Missing or invalid API key
404	Not Found — Resource doesn't exist
429	Too Many Requests — Rate limit exceeded
500	Server Error

Error Response Format

{
  "error": "ValidationError",
  "message": "Invalid sport parameter",
  "code": "INVALID_PARAMETER",
  "details": {
    "parameter": "sport",
    "allowedValues": ["mlb", "nfl", "nba", "college-baseball"]
  }
}