Documentation Index
Fetch the complete documentation index at: https://docs.novig.com/llms.txt
Use this file to discover all available pages before exploring further.
Player Aggregation
Access player data through the event, game, competitor, and player relationship hierarchy.
Data Hierarchy
Event
Top-level object representing a game (e.g., “KC Chiefs vs BUF Bills - Week 14”)
Game
Contains start time, league, and competitors
Competitors
Home and away teams with their rosters
Players
Individual players with stats and positions
Example Query
query EventPlayers($eventId: ID!) {
event(id: $eventId) {
id
description
game {
id
startTime
homeCompetitor {
id
name
players {
id
name
number
position
stats {
rushingYards
passingYards
receptions
}
}
}
awayCompetitor {
id
name
players {
id
name
number
position
stats {
rushingYards
passingYards
receptions
}
}
}
}
}
}
Variables
{
"eventId": "123e4567-e89b-12d3-a456-426614174001"
}
Example Response
{
"data": {
"event": {
"id": "123e4567-e89b-12d3-a456-426614174001",
"description": "KC Chiefs vs BUF Bills - Week 14",
"game": {
"id": "game-001",
"startTime": "2023-12-10T20:00:00Z",
"homeCompetitor": {
"id": "team-buf",
"name": "Buffalo Bills",
"players": [
{
"id": "player-001",
"name": "Josh Allen",
"number": "17",
"position": "QB",
"stats": {
"rushingYards": 45,
"passingYards": 275,
"receptions": 0
}
}
]
},
"awayCompetitor": {
"id": "team-kc",
"name": "Kansas City Chiefs",
"players": [
{
"id": "player-002",
"name": "Patrick Mahomes",
"number": "15",
"position": "QB",
"stats": {
"rushingYards": 30,
"passingYards": 298,
"receptions": 0
}
}
]
}
}
}
}
}
Field Reference
Event Fields
| Field | Type | Description |
|---|
id | ID | Unique event identifier |
description | String | Human-readable event description |
game | Game | Associated game details |
Game Fields
| Field | Type | Description |
|---|
id | ID | Unique game identifier |
startTime | DateTime | Scheduled start time (UTC) |
homeCompetitor | Competitor | Home team details |
awayCompetitor | Competitor | Away team details |
Competitor Fields
| Field | Type | Description |
|---|
id | ID | Unique team identifier |
name | String | Team name |
players | [Player] | Array of players on the roster |
Player Fields
| Field | Type | Description |
|---|
id | ID | Unique player identifier |
name | String | Player name |
number | String | Jersey number |
position | String | Playing position (QB, RB, WR, etc.) |
stats | PlayerStats | Player statistics |
PlayerStats Fields
| Field | Type | Description |
|---|
rushingYards | Int | Total rushing yards |
passingYards | Int | Total passing yards |
receptions | Int | Total receptions |
