Pricing
Pay per event
Extract ESPN scoreboard data for NFL, NCAA College Football, NBA, WNBA, and MLB games. Supports live, upcoming, and completed games with flexible date range options.
nfl_enabledbooleanOptional
Collect NFL scoreboard data during this run.
Default value of this property is true
nfl_stateEnumOptional
Auto mode hunts for live events, then falls back to the latest finals, and then upcoming games if the first two buckets are empty.
"auto": string"in": string"post": string"pre": stringDefault value of this property is "auto"
nfl_datestringOptional
Enter a specific date in YYYY-MM-DD format (e.g., 2025-01-15). Leave blank to use the current local date. When range filters are also filled, the range takes precedence and this field is ignored.
nfl_date_startstringOptional
Enter the range start. Accepts absolute dates such as 2025-01-01 or relative lookbacks like 3 days. When set (with or without a range end) the range overrides the single target date.
nfl_date_endstringOptional
Enter the range end. Accepts absolute dates such as 2025-01-07 or relative lookbacks like 0 days for today. When set (with or without a range start) the range overrides the single target date.
nfl_limitintegerOptional
Cap each target date's scoreboard at this many events (defaults to 50). Leave blank to include every event ESPN exposes.
Default value of this property is 50
nba_enabledbooleanOptional
Collect NBA scoreboard data during this run.
Default value of this property is false
nba_stateEnumOptional
Auto mode hunts for live events, then falls back to the latest finals, and then upcoming games if the first two buckets are empty.
"auto": string"in": string"post": string"pre": stringDefault value of this property is "auto"
nba_datestringOptional
Enter a specific date in YYYY-MM-DD format (e.g., 2025-01-15). Leave blank to use the current local date. When range filters are also filled, the range takes precedence and this field is ignored.
nba_date_startstringOptional
Enter the range start. Accepts absolute dates such as 2025-01-01 or relative lookbacks like 3 days. When set (with or without a range end) the range overrides the single target date.
nba_date_endstringOptional
Enter the range end. Accepts absolute dates such as 2025-01-07 or relative lookbacks like 0 days for today. When set (with or without a range start) the range overrides the single target date.
nba_limitintegerOptional
Cap each target date's scoreboard at this many events (defaults to 50). Leave blank to include every event ESPN exposes.
Default value of this property is 50
wnba_enabledbooleanOptional
Collect WNBA scoreboard data during this run.
Default value of this property is false
wnba_stateEnumOptional
Auto mode hunts for live events, then falls back to the latest finals, and then upcoming games if the first two buckets are empty.
"auto": string"in": string"post": string"pre": stringDefault value of this property is "auto"
wnba_datestringOptional
Enter a specific date in YYYY-MM-DD format (e.g., 2025-01-15). Leave blank to use the current local date. When range filters are also filled, the range takes precedence and this field is ignored.
wnba_date_startstringOptional
Enter the range start. Accepts absolute dates such as 2025-01-01 or relative lookbacks like 3 days. When set (with or without a range end) the range overrides the single target date.
wnba_date_endstringOptional
Enter the range end. Accepts absolute dates such as 2025-01-07 or relative lookbacks like 0 days for today. When set (with or without a range start) the range overrides the single target date.
wnba_limitintegerOptional
Cap each target date's scoreboard at this many events (defaults to 50). Leave blank to include every event ESPN exposes.
Default value of this property is 50
mlb_enabledbooleanOptional
Collect MLB scoreboard data during this run.
Default value of this property is false
mlb_stateEnumOptional
Auto mode hunts for live events, then falls back to the latest finals, and then upcoming games if the first two buckets are empty.
"auto": string"in": string"post": string"pre": stringDefault value of this property is "auto"
mlb_datestringOptional
Enter a specific date in YYYY-MM-DD format (e.g., 2025-01-15). Leave blank to use the current local date. When range filters are also filled, the range takes precedence and this field is ignored.
mlb_date_startstringOptional
Enter the range start. Accepts absolute dates such as 2025-01-01 or relative lookbacks like 3 days. When set (with or without a range end) the range overrides the single target date.
mlb_date_endstringOptional
Enter the range end. Accepts absolute dates such as 2025-01-07 or relative lookbacks like 0 days for today. When set (with or without a range start) the range overrides the single target date.
mlb_limitintegerOptional
Cap each target date's scoreboard at this many events (defaults to 50). Leave blank to include every event ESPN exposes.
Default value of this property is 50
cfb_enabledbooleanOptional
Collect College Football scoreboard data during this run.
Default value of this property is false
cfb_stateEnumOptional
Auto mode hunts for live events, then falls back to the latest finals, and then upcoming games if the first two buckets are empty.
"auto": string"in": string"post": string"pre": stringDefault value of this property is "auto"
cfb_datestringOptional
Enter a specific date in YYYY-MM-DD format (e.g., 2025-01-15). Leave blank to use the current local date. When range filters are also filled, the range takes precedence and this field is ignored.
cfb_date_startstringOptional
Enter the range start. Accepts absolute dates such as 2025-01-01 or relative lookbacks like 3 days. When set (with or without a range end) the range overrides the single target date.
cfb_date_endstringOptional
Enter the range end. Accepts absolute dates such as 2025-01-07 or relative lookbacks like 0 days for today. When set (with or without a range start) the range overrides the single target date.
cfb_limitintegerOptional
Cap each target date's scoreboard at this many events (defaults to 50). Leave blank to include every event ESPN exposes.
Default value of this property is 50
cfb_seasonintegerOptional
ESPN season year (e.g., 2023). Combine with season type and week for historic slates.
cfb_seasontypeintegerOptional
ESPN season type (1 = preseason, 2 = regular season, 3 = postseason).
cfb_weekintegerOptional
Target a specific slate by week number when paired with season filters.