Sports picks your app can use.
Confidence-ranked picks, win probabilities and parlay scoring for NFL, college football, NBA and MLB, as clean JSON. The same model behind sportsjedi.com.
Get a free API key Quick start OpenAPI specQuick start
1. Sign in at sportsjedi.com/developers and create a key. 2. Call the API:
curl https://api.sportsjedi.com/v1/picks?league=NFL \ -H "X-API-Key: sj_live_your_key_here"
JavaScript
const res = await fetch("https://api.sportsjedi.com/v1/picks?league=NBA&min_confidence=70", {
headers: { "X-API-Key": process.env.SPORTS_JEDI_API_KEY },
});
const { data } = await res.json();
Python
import os, requests
r = requests.get("https://api.sportsjedi.com/v1/picks", params={"league": "NCAAF"},
headers={"X-API-Key": os.environ["SPORTS_JEDI_API_KEY"]})
picks = r.json()["data"]
Authentication
Send your key in the X-API-Key header on every request. Keys start with sj_live_. Keep them on your server; browsers are blocked from calling the API directly so keys can't leak from web pages. You can revoke and create keys anytime at sportsjedi.com/developers.
Plans
| Plan | Price | Requests / day | Requests / min | Keys |
|---|---|---|---|---|
| Free | $0 | 100 | 10 | 2 |
| Starter | $19/mo | 5,000 | 60 | 5 |
| Pro | $79/mo | 50,000 | 300 | 10 |
Limits are per account and reset at midnight UTC. Upgrade or cancel anytime from your developer page.
Endpoints
Base URL: https://api.sportsjedi.com. All responses are JSON: {"success": true, "data": ..., "meta": {...}}.
GET /v1/picks
Today's Sports Jedi picks, highest confidence first. Games that are final are left out.
| Parameter | Meaning |
|---|---|
league | NFL, NCAAF, NBA or MLB (optional) |
min_confidence | 0-100, default 0 |
limit | 1-200, default 50 |
Response
{
"success": true,
"data": [{
"game": { "id": "4f6688e4d1818bd8...", "league": "NBA", "startTime": "2026-11-05T00:30:00Z",
"status": "upcoming", "away": { "name": "Chicago Bulls", "abbr": "CB" },
"home": { "name": "New York Knicks", "abbr": "NYK" } },
"analysis": { "pick": "NYK", "confidence": 78, "grade": "PLAY",
"homeWinProbability": 71.4, "awayWinProbability": 28.6, "edge": 21.4,
"marketAgreement": 100, "summary": "NYK is the market-consensus side..." }
}],
"meta": { "plan": "starter", "requestsToday": 41, "dailyLimit": 5000, "count": 1 }
}
GET /v1/games
Games Sports Jedi is tracking, soonest first.
| Parameter | Meaning |
|---|---|
league | NFL, NCAAF, NBA or MLB (optional) |
status | upcoming, live, final or postponed |
date | YYYY-MM-DD (UTC) |
GET /v1/games/{id}
One game with its full Sports Jedi analysis.
| Parameter | Meaning |
|---|---|
id | a game id from /v1/games or /v1/picks |
POST /v1/parlays/analyze
Score a parlay. Each leg's probability comes from Sports Jedi's model, so the result reflects the real chance every leg hits. Up to 12 legs.
Request body
{ "legs": [ { "gameId": "4f6688e4d1818bd8...", "pick": "NYK" },
{ "gameId": "a91c02b7e4f3...", "pick": "KC" } ] }
Response
{
"success": true,
"data": { "legs": 2, "combinedConfidence": 52.1, "risk": "Medium",
"message": "2-leg card has approximately 52.1% combined model probability..." }
}
GET /v1/usage
Your plan, requests used today and what's left.
GET /v1/leagues
Supported leagues. No key needed.
Errors & rate limits
Errors look like {"success": false, "error": "message", "code": "CODE"}.
| Status | Code | Meaning |
|---|---|---|
| 400 | INVALID_LEAGUE, INVALID_LEGS, … | A parameter is wrong; the message says which. |
| 401 | API_KEY_REQUIRED, INVALID_API_KEY | Missing, wrong or revoked key. |
| 403 | PLAN_REQUIRED | Your plan doesn't include this endpoint. |
| 404 | NOT_FOUND | No game with that id. |
| 429 | RATE_LIMITED, DAILY_QUOTA_EXCEEDED | Slow down; see Retry-After. |
Every keyed response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (seconds until the daily reset).
Terms
Sports Jedi provides sports analysis for information and entertainment. Picks and probabilities are model estimates, not guarantees and not betting advice. If you show them to people, say so, follow the gambling laws where your users are, and point anyone who needs it to help such as 1-800-GAMBLER.
Questions: sportsjedi.com