Skip to main content
This page is for teams building live entry points into sports coverage: homepage scoreboards, “what’s on today” widgets, push-alert systems, and assistants that need a reliable view of current and near-future games.

Product Outcome

Deliver a live sports surface that can answer questions like what is on now, what is final, what starts next, and which league or sport a user should drill into next.

Who Builds This

  • AI product teams shipping fan-facing assistants
  • editorial and content operations teams
  • mobile, web, and connected-TV teams
  • internal agents that need fresh daily sports context
StepToolWhy it matters
1gns_list_sports or gns_list_leaguesconfirm the catalog you can cover
2gns_resolve_entitymap a fuzzy league or team name to a canonical ID
3gns_schedule_resultsfetch a targeted live or near-live window
4gns_sports_dayboardproduce a compact cross-sport scoreboard
5gns_live_league_dashboardenrich a specific league view with standings and structure

Minimum Inputs

  • a date or time window
  • optionally a sportId or leagueId
  • optionally a canonical ID for the league or team the user is asking about

Example End-User Prompts

  • “What games are on tonight across soccer and basketball?”
  • “Show me today’s Premier League matches.”
  • “Which match just went final?”
  • “What should I pin to the top of a live scoreboard right now?”

Expected Output / UX

The best scoreboard experiences usually show:
  • current or upcoming matches in the requested window
  • scores, status, and start times
  • obvious drill-down paths into a league dashboard or match center
  • consistent naming and identifiers the rest of your product can reuse

Common Mistakes

  • starting from free-text league names without resolving them first
  • building a cross-sport scoreboard out of deep match tools instead of schedule tools
  • over-fetching live detail before the user has chosen a match worth opening
  • forgetting to bound the time window for daily or weekly experiences

Where To Go Deeper