foxsports.com APIwww.foxsports.com ↗
Access live scores, soccer match details, player lineups, play-by-play events, and game stats from Fox Sports across soccer, MLB, WNBA, and more.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/fe299940-f924-45be-866c-0d189568c945/get_live_scores' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace foxsports-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Fox Sports Live Scores SDK — bounded, re-runnable."""
from parse_apis.Fox_Sports_Live_Scores_API import FoxSports, SoccerGroup, EventNotFound
client = FoxSports()
# Get today's live scores across all sports
for section in client.scoreboards.live(limit=3):
print(f"Sport: {section.sport}")
for event in section.events[:2]:
print(f" {event.upper_team.long_name} vs {event.lower_team.long_name} — {event.status_line or event.event_time}")
# Get soccer scores filtered to FIFA World Cup
match = client.scoreboards.soccer(group_id=SoccerGroup.FEATURED, limit=5).first()
if match:
print(f"\nFirst match: {match.upper_team.long_name} vs {match.lower_team.long_name}")
print(f" Status: {match.status_line}, TV: {match.tv_station}")
# Drill into match details
try:
details = match.details()
print(f"\n Venue: {details.venue_name}, {details.venue_location}")
print(f" Score: {details.left_team.long_name} {details.left_team.score} - {details.right_team.score} {details.right_team.long_name}")
for stat in details.match_stats[:3]:
print(f" {stat.title}: {stat.left_stat} vs {stat.right_stat}")
except EventNotFound as exc:
print(f"Event not found: {exc}")
print("\nexercised: scoreboards.live / scoreboards.soccer / event.details")
Retrieves today's top live scores and upcoming games across all sports (soccer, MLB, WNBA, etc.). Results are grouped by sport/league. Includes live game status, scores, team records, odds, and TV station info. Event status: 1=in progress, 2=scheduled, 3=final.
No input parameters required.
{
"type": "object",
"fields": {
"sections": "array of sport sections, each containing sport name and events"
},
"sample": {
"sections": [
{
"sport": "FIFA WORLD CUP",
"events": [
{
"id": "soccer647660",
"league": "WORLD CUP",
"web_url": "/soccer/fifa-world-cup-men-portugal-vs-uzbekistan-jun-23-2026-game-boxscore-647660",
"odds_line": "",
"event_time": "2026-06-23T17:00:00Z",
"game_notes": "GROUP K",
"lower_team": {
"name": "UZB",
"score": 0,
"record": "0-0-1",
"is_loser": false,
"logo_url": "https://b.fssta.com/uploads/application/countries/flag-logos/860.vresize.80.80.medium.0.png",
"long_name": "Uzbekistan"
},
"tv_station": "FOX",
"upper_team": {
"name": "POR",
"score": 3,
"record": "0-1-0",
"is_loser": false,
"logo_url": "https://b.fssta.com/uploads/application/countries/flag-logos/620.vresize.80.80.medium.0.png",
"long_name": "Portugal"
},
"status_line": "45'+1'",
"event_status": 1,
"event_headline": "",
"over_under_line": ""
}
]
}
]
}
}About the foxsports.com API
The Fox Sports API provides 3 endpoints covering live scores across all sports, soccer-specific schedules with league filtering, and detailed per-match data including lineups, match statistics, and play-by-play events. The get_event_details endpoint returns over 10 distinct fields per match — from venue name and TV broadcast channel to per-player lineup arrays and stat comparisons like possession and shots on goal.
Live Scores and Multi-Sport Coverage
The get_live_scores endpoint returns today's top scores and upcoming games grouped into sections by sport and league. Each section includes events with live game status (1=in progress, 2=scheduled, 3=final), team records, current scores, betting odds where available, and the TV station airing the game. No parameters are required — a single call surfaces the current state of all sports Fox Sports tracks.
Soccer Schedule and League Filtering
The get_soccer_scores endpoint accepts an optional date parameter in YYYY-MM-DD format and a group_id to filter by league. Use group_id=12 for FIFA World Cup matches, group_id=5 for MLS, or group_id=0 for featured games. The response includes an array of match events alongside a subtitle date label and a segment_id. Omitting the date defaults to today in UTC.
Per-Match Detail: Stats, Lineups, and Play-by-Play
The get_event_details endpoint takes an event_id (obtainable from either get_live_scores or get_soccer_scores) and returns a complete match record. The match_stats array contains side-by-side stat comparisons with title, left_stat, and right_stat fields covering metrics like possession and shots. The lineups object maps each team name to an array of players with their position and name. The plays array provides a chronological play-by-play log with event time and description. Additional top-level fields include venue_name, tv_station, game_notes (e.g. group stage label), and event_time in ISO datetime format.
Coverage Notes
Event IDs are integers prefixed by sport slug in some contexts (e.g. soccer647660) but the endpoint accepts either the full prefixed form or the bare numeric ID. The sport input on get_event_details is optional. Status codes are consistent across endpoints: check for status 3 to identify completed matches and status 1 for games currently in progress.
The foxsports.com API is a managed, monitored endpoint for www.foxsports.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when www.foxsports.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official www.foxsports.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Display a live sports ticker showing in-progress scores and TV channel info across all Fox Sports-covered leagues
- Build a FIFA World Cup match tracker filtered by group stage using group_id=12 and game_notes field
- Generate post-match stat summaries using match_stats comparisons like possession and shots on goal
- Show pre-match lineups side-by-side for both teams using the lineups object from get_event_details
- Create a play-by-play feed for a specific soccer match using the plays array with timestamps and descriptions
- Alert users when a game transitions from scheduled (status=2) to in-progress (status=1) using get_live_scores
- Pull MLS schedules for a given date using get_soccer_scores with group_id=5 and a date parameter
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.