Loading live scores...
SportsDatabase.io
Sign In
Data coverage

API data guide

Understand the breadth of SportsDatabase coverage, freshness guarantees, and schema resources. Use this guide to plan your ingestion strategy and communicate expectations with stakeholders.

๐Ÿ›๏ธ

Core taxonomy

Nightly sync from SportsData.db imports with steward moderation overlays

  • Sports, leagues, teams, players, venues, and referees with canonical IDs
  • Cross-league franchise hierarchies and historical relocations
  • Rich metadata: founding year, colors, logos, alternative spellings
๐Ÿ“…

Schedules & results

Live event delta feeds (โ‰ค90s) for paid tiers, nightly for free tier

  • Season calendars with kickoff times normalized to UTC and local time zones
  • Event status tracking (scheduled, live, final) with score progression and attendance
  • Referee crews, broadcasters, and streaming availability flags
๐Ÿ†

Statistics & honours

Post-event backfill within 15 minutes, leaderboard recalcs hourly

  • Per-event box scores across scoring summaries, player minutes, and advanced metrics
  • Cumulative leaderboards aligned to league conventions
  • Honours & trophies with season span, rank, and official naming
โšก

Freshness by tier

Every dataset ships with explicit refresh SLAs. Paid tiers receive prioritized pipelines and steward escalations when anomalies trigger alerts.

DatasetFreeTIER 1ProTIER 2EnterpriseTIER 3
TaxonomyNightlyNightly + steward hotfixesOn-demand backfills
SchedulesNightlyHourlyโ‰ค5 minutes
Live scoresUnavailable90-second lag30-second lag
Stats & box scores4 hours60 minutes15 minutes
Honours & awardsWeeklyDailyDaily with steward alerts
๐Ÿ›ก๏ธ

Quality guardrails

Data flows through multiple enrichment and validation stages. Steward reviewers triage anomalies and escalate urgent fixes to engineering with clear SLAs.

๐Ÿ”’

Schema stability

Breaking field removals require 60-day notice. Additive changes ship behind preview headers and are announced via changelog.

๐Ÿ“œ

Attribution

All datasets trace back to steward-sourced evidence. We version provenance documents and make them available on request.

โœ…

Quality checks

Automated validation gates enforce referential integrity, enum ranges, and duplicate detection before data is promoted.

๐Ÿ“Š

Dataset directory

Available metadata fields per resource type. Each response includes catalog IDs to power downstream joins.

Sports

/v1/sports

Available fields

idcatalogIdnameslugstatus

Leagues

/v1/leagues?sportSlug=soccer

Available fields

idcatalogIdsportIdnameslugstatuscountrytiergenderlogoUrl

Teams

/v1/teams?leagueSlug=english-premier-league

Available fields

idcatalogIdleagueIdnameslugcitycountryfoundedYearcolorslogoUrlbannerUrlstadiumNamestadiumCapacitystatus

Players

/v1/players?teamSlug=manchester-united

Available fields

idcatalogIdteamIdfirstNamelastNamepositionnumbernationalitybirthDateheightweightthumbUrlcutoutUrlrenderUrlstatus

Events

/v1/events?leagueSlug=english-premier-league

Available fields

idcatalogIdleagueIdseasonIdhomeTeamIdawayTeamIdhomeScoreawayScorestatusstartTimevenueattendanceroundmatchdaybroadcasters

Seasons

/v1/seasons?leagueSlug=english-premier-league

Available fields

idcatalogIdleagueIdnamestartDateendDatestatusisCurrent

Venues

/v1/venues

Available fields

idcatalogIdnamecitycountrycapacitysurfaceopenedimageUrllatitudelongitude

Countries

/v1/countries

Available fields

idnamecodeflagUrlcontinent
๐Ÿ’กMissing a field or dataset?

We're always expanding coverage. Contact us with suggestions for new metadata fields or data sources.

๐Ÿ”ง

Developer resources

Align your internal models with ours. These resources stay in lockstep with production deployments.

๐Ÿš€

Need deeper access?

Enterprise partners can request bespoke datasets, ingestion jobs, and SLAs. Our data engineering team will scope custom feeds and coordinate delivery windows.

๐Ÿ’ฌ

Frequently asked questions

Yes. Enterprise contacts can request historical exports dating back to the 1950s for major leagues, delivered as CSV or Parquet with signed URLs.
Stewards submit corrections with evidence. Once approved, we issue changefeed notices and revalidate affected caches within minutes.
Absolutely. Use the Prisma schema and OpenAPI spec to align datatypes. We also provide nightly dumps for staging environments.