Navigating Games

Schedules

There are two common ways of navigating games. The first is to use the schedule API. For example:

{
  nfl {
    schedule(season: 2022, type: REGULAR) {
      games {
        id
        time
        week
      }
    }
  }
}

Open in GraphQL Explorer

The schedule field isn't part of the FootballOrganization interface since the arguments differ slightly by league. However, you can still re-use the same fragment for the results like so:

{
  nfl {
    schedule(season: 2022, type: REGULAR) {
      games {
        ...game
      }
    }
  }
  ncaa {
    football(conference: PAC12) {
      schedule(season: 2022, type: REGULAR) {
        games {
          ...game
        }
      }
    }
  }
}

fragment game on FootballGame {
  id
  awayTeamEdge {
    node {
      abbreviation
    }
  }
  homeTeamEdge {
    node {
      abbreviation
    }
  }
}

Open in GraphQL Explorer

Search

The other common way of navigating games is via the gamesConnection API, which provides powerful search functionality using FQL:

{
  nfl {
    gamesConnection(first: 10, predicate: {
      expression: """SEASON = 2020 and team("ATL") has SCORE > 30"""
    }) {
      edges {
        node {
          id
          time
        }
      }
    }
  }
}

Open in GraphQL Explorer

Node Lookup

Football games implement the Node interface, so games found via the above methods can be looked up directly by id:

{
  node(id: "CA~MjAyMi9SRUcvOC81ODk0OA") {
    ... on NFLGame {
      id
      homeTeamEdge {
        node {
          name
        }
      }
      awayTeamEdge {
        node {
          name
        }
      }
    }
  }
}

Open in GraphQL Explorer

This site is open source!

See something that could be improved? Open a pull request on GitHub.

Contribute to This Page

FusionFeed

Navigating Games

Schedules

Search

Node Lookup

This site is open source!

On This Page