Betting Odds Feed — Sports Lines API

Free betting odds API style feed on Apify: normalized sports odds JSON (point spread, moneyline, over/under totals) per event and bookmaker, pulled from ESPN's public no-auth endpoints. A simple sports odds api free alternative for dashboards, models, alerts and research — including nfl odds json, MLB run lines, NBA/NHL lines and soccer (EPL, MLS).

Disclaimer: Odds are informational only — not betting advice. This actor is unofficial and not affiliated with ESPN or any sportsbook. Availability of lines and bookmakers depends entirely on ESPN's public feeds.

What it does

• Fetches today's (or a chosen date's) events for the leagues you select.
• Normalizes each event's odds into one row per event × bookmaker.
• Fast mode (default): uses the scoreboard-embedded consensus line.
• includeAllProviders: true: queries ESPN's per-event odds endpoint to enumerate every bookmaker ESPN lists for that event (slower — one extra request per event).
• Events without any posted odds are skipped (count is logged).

Input

{
  "leagues": ["mlb", "nfl", "nba", "nhl"],
  "date": "",
  "includeAllProviders": false
}

Field	Type	Default	Notes
leagues	array	["mlb","nfl","nba","nhl"]	See league codes below
date	string	"" (today)	YYYY-MM-DD
includeAllProviders	boolean	false	Per-bookmaker enumeration

League codes

mlb, nfl, nba, nhl, wnba, ncaaf, ncaab, epl (English Premier League), mls (Major League Soccer).

Output schema

One dataset row per event-provider:

Field	Type	Description
league	string	Input league code
event_id	string	ESPN event id
event_name	string	e.g. Detroit Tigers at Chicago Cubs
start_time_utc	string	ISO 8601 UTC, e.g. 2026-07-22T00:05:00Z
home_team	string|null	Home team display name
away_team	string|null	Away team display name
provider	string	Bookmaker name (e.g. DraftKings)
spread	float|null	Home-relative point spread (negative = home favored)
spread_details	string|null	Raw line string, e.g. PHI -4.5
over_under	float|null	Total (O/U)
home_moneyline	int|null	American odds for home team
away_moneyline	int|null	American odds for away team
fetched_at	string	ISO 8601 UTC fetch timestamp

Example row:

{
  "league": "nfl",
  "event_id": "401872929",
  "event_name": "Washington Commanders at Philadelphia Eagles",
  "start_time_utc": "2026-09-13T20:25:00Z",
  "home_team": "Philadelphia Eagles",
  "away_team": "Washington Commanders",
  "provider": "DraftKings",
  "spread": -4.5,
  "spread_details": "PHI -4.5",
  "over_under": 47.5,
  "home_moneyline": -218,
  "away_moneyline": 180,
  "fetched_at": "2026-07-21T15:49:03Z"
}

Bookmakers / providers note

ESPN currently surfaces mostly a single primary partner book (DraftKings) on its public feeds; historically the per-event odds endpoint has listed multiple providers (Caesars, consensus, numberFire, etc.). This actor emits whatever ESPN exposes — the provider list can change at any time without notice.

FAQ

Is this a free sports odds API? It reads ESPN's public JSON endpoints — no API key or scraping login needed. Standard Apify usage charges apply.

Which markets are covered? Game-level spread, moneyline and total (over/under). No props or live in-play odds.

Why are some leagues empty? Off-season or no games on the selected date, or ESPN posted no lines yet (pre-season games often have no odds). Skipped-event counts are logged.

Can I get historical odds? Pass date for past dates; ESPN keeps closing lines for some leagues, but coverage is not guaranteed.

Is this legal / betting advice? It's public informational data only, not betting advice. Verify local laws before wagering; gamble responsibly.