Skip to main content
This page is for products that center the experience on a team or a person rather than on a single match. It fits team pages, player cards, season hubs, and profile-driven assistants.

Product Outcome

Create a season-aware home for a team or player that combines identity, schedule, roster context, and season statistics in a way an AI product can explain naturally.

Who Builds This

  • team and athlete profile experiences
  • personalization and follow flows
  • editorial research assistants
  • fantasy, commerce, and engagement products
StepToolWhy it matters
1gns_resolve_entityresolve a team or player name to a canonical ID
2gns_team_info or gns_person_infoload the entity profile
3gns_team_season_profile or gns_person_season_profileget the season-ready bundle
4gns_team_schedule_resultsadd upcoming and recent fixtures
5gns_team_roster or gns_person_league_statsdeepen roster or individual season context

Minimum Inputs

  • teamId or personId
  • leagueId for the current season or leagueSeasonId for a specific season

Example End-User Prompts

  • “Build a season page for Inter Miami.”
  • “Show me Salah’s season profile.”
  • “Who is on this roster and how is the team performing?”
  • “What has this player done in this league this season?”

Expected Output / UX

High-quality hubs usually combine:
  • canonical identity and imagery
  • current season schedule or recent activity
  • roster or teammates when relevant
  • season stats the AI can summarize without extra joins

Common Mistakes

  • mixing current-season and historic-season IDs in the same flow
  • using cross-league team schedule when the user expects one league only
  • building player pages from match stats only instead of season context
  • skipping resolution and relying on a fuzzy name in downstream tools

Where To Go Deeper