Guides
Each guide is a complete project you can run today, with the full code in the public examples repo (MIT). Every example was run against the live API before publishing.
Building a product? Use cases cover app push alerts, media scoreboards, fantasy scoring, venue screens and analytics feeds, with the plan that fits each.
- Track NBA box scores live, with player milestone alerts
A zero-dependency Node script that finds live NBA games (or one team's game), redraws each box score every minute and alerts once per player when they reach 20/30/40/50 points, a double-double or a triple-double.
Node.js · NBA · Discord/Slack webhook · Free for a few test games; Starter for one team all season
- Build NHL goal alerts with a goal horn
A Node script that watches live NHL games (or one team), fires an alert the moment the score changes, adds the scorer from the latest scoring play, sends a phone push and runs your goal-horn command for your team's goals.
Node.js · NHL · ntfy · Free for a few test games; Starter for one team all season
- Track men's college basketball and the March Madness bracket
One Python script with three commands: today's scoreboard for the teams you follow, a live watcher that flags close finishes and finals, and the NCAA tournament grouped First Four to Championship with winners and a CSV export.
Python · College basketball · CSV · Free for the scoreboard and bracket; Starter to watch games live
- Add live scores to Home Assistant
One YAML package: a RESTful resource reads the league scoreboard, six template sensors pick out your team's game, and automations refresh it often during games and rarely otherwise, notify the final and (optionally) flash a light when your team scores.
Home Assistant · YAML · Jinja · Starter for live updates all season; Free for next-game and final scores only
- Send sports score alerts with n8n
Import a workflow, add two credentials and activate it: game starts, score changes and finals for your team arrive in Telegram. The polling version calls the API only when a game is live or about to start; the webhook version is pushed by the API.
n8n · Telegram · Webhooks · Polling: Starter for live alerts all season. Webhooks: paid plans
- Build an ESP32 live scoreboard
A desk scoreboard: an ESP32 reads the league scoreboard over HTTPS, keeps only the fields it shows, picks your team's game and refreshes every 45 seconds while it's live and rarely otherwise.
ESP32 · Arduino · ArduinoJson · SSD1306 · Starter for live updates all season; Free for a few test games
- Build a Telegram live scores bot
A zero-dependency Node bot that polls live games every 60 seconds and messages a Telegram chat when a game starts, the score changes and it ends, then sleeps until the next game.
Node.js · Telegram Bot API · Free to try; Starter for one team all season
- Add a live score overlay to your stream
Run one Node server, add one browser source, and your stream shows your team's live score and clock, the start time before the game and the final afterwards, with a flash when a team scores.
OBS · Node.js · HTML · Free for a couple of test streams; Starter for weekly streams
- Build a Discord live scores bot
A bot that posts every score change and final score for a league, or just your team, to a Discord channel. It streams over WebSocket when your plan has it and falls back to quota-friendly REST polling.
Node.js · Discord webhook · WebSocket · Free for a dry run; Starter for live polling all season
- Build a Slack live scores bot
A zero-dependency Node script that polls live games every 60 seconds and posts a Slack message when a game starts, when the score changes and when it ends, then sleeps until the next game.
Node.js · Slack Incoming Webhook · Free to try; Starter for live polling every game day
- Get live scores into Google Sheets
One Apps Script file adds spreadsheet formulas for live games, season schedules, the current scoreboard, teams and your remaining quota, with caching so recalculations are free.
Google Sheets · Apps Script · Free for a manually refreshed sheet; Starter for a 5-minute auto-refresh
- Build a Raspberry Pi LED scoreboard
A Python script that draws live games for a league or one team on a 64x32 RGB LED matrix, or in your terminal, polling every 45 seconds only while games are live.
Python · Raspberry Pi · RGB LED matrix · Free for occasional checks; Starter for one team all season
- Build a live scoreboard with Next.js
A small Next.js app: a server helper calls the API with a 30-second cache, a route handler serves trimmed JSON, and a client component refreshes the board every 60 seconds while the tab is visible. The key never reaches the browser.
Next.js 14 · React · Vercel · Free to build; Starter or Growth for an always-on public site
- Live sports scores in JavaScript
Four small Node scripts that share one helper: the games in progress right now for any league, a season schedule (NFL and college football by week), one game's details, box score and latest plays, and a watcher that polls the live endpoint and prints only what changed.
Node.js 18+ · fetch · Free to build and try; Starter to poll one team's games all season
- Live sports scores in Python
Four short scripts on one helper module: live games for any league, a season schedule, one game's details, box score and plays, and a watcher that polls and prints only score changes. For one league in depth, the NFL, NBA, NHL, soccer and college football guides go further.
Python 3.10+ · requests · Free to build and try; Starter to poll one team's games all season
- NFL API in Python: scores, box scores and injuries
A single Python script with three commands: this week's NFL games (or any past week) with scores and team ids, passing/rushing/receiving lines from one game's box score, and the league-wide or per-team injury report.
Python · requests · Free (each command is one call)
- NBA API in Python: scores, box scores and play-by-play
A single Python script with three commands: a day's NBA games with scores and event ids, every player's line from one game's box score, and the game's play-by-play (the last plays, or every page).
Python · requests · Free (scores and box are one call each; plays pages through the game)
- NHL API in Python: scores, goals and injuries
A single Python script with three commands: a day's NHL games with scores and event ids, every goal in one game with the score after it, and the league-wide or per-team injury report.
Python · requests · Free (goals reads every play page, typically 3 calls per game)
- Soccer API in Python: Premier League, LaLiga and MLS scores
A single Python script that prints a league's fixtures and scores for today or any day. Change one league code to switch from the Premier League to LaLiga, MLS or the Champions League.
Python · requests · Free (one call per command)
- College football API in Python: scores, rankings, box scores and play-by-play
A single Python script with four commands: the current scoreboard or any day's games (filter by team), the AP Top 25, coaches poll or CFP rankings, passing/rushing/receiving lines from one game's box score, and a game's play-by-play with the score after each play.
Python · requests · Free (each command is one or two calls)
- College football rankings API in Python
One small script with three commands: print a poll with records, points and first-place votes; compare it with the previous week (movers, new entries, teams that dropped out); and list this week's games that involve a ranked team.
Python · requests · Free (one call per command; movers makes two)
- Analyze a season of games with Python and pandas
A Python script that loads a full NFL or college football season into a DataFrame, one week per API call, and writes standings and league-wide stats (home win rate, average margin, one-score games) to CSV.
Python · pandas · requests · Free (a full NFL season is 18 calls)
- Build an odds feed for a fantasy or pick'em app
A Node script that builds a JSON feed for a league's upcoming games: current spread, moneyline and total, the opening line, margin-free implied win probability and every recorded line move. Games without a line stay in the feed with odds: null.
Node.js · JSON · Free for a few runs a month; Starter for hourly refreshes
- Use live sports data in Claude, Cursor and ChatGPT with MCP
Point your AI assistant at one URL and it can answer "Which NFL games are live?" or "Who leads the Premier League match right now?" with real data. Nothing to install; each tool call counts as one API call.
MCP · Claude · Cursor · ChatGPT · Free (each tool call is one API call)
- Get game alerts with webhooks
A tiny Node server that receives webhook deliveries, verifies their signature against the raw body, prints alerts and can forward them to Slack or Discord, plus a script that registers, tests and deletes webhooks.
Node.js · Webhooks · HMAC-SHA256 · Webhooks need a paid plan (Starter and up); local testing is free
- Build a sports stats newsletter
A Node script that writes a recap newsletter (final scores, passing/rushing/receiving leaders and next week's games) as Markdown and inline-styled HTML for any email tool. It never sends email itself.
Node.js · Markdown · Email HTML · Free for a weekly NFL issue (about 18 calls each)