Introducing the Alliance GraphQL API

Introducing the Alliance GraphQL API

We're happy to announce the availability of the Alliance GraphQL API to the public. This API can be freely used by developers of all sorts to pull data about the league straight from the source.

What is GraphQL?

GraphQL is a query language developed by Facebook that allows you to request and download exactly what you need from us in a single API request, and nothing more.

For example, if you wanted to get the name of each team's stadium and head coach, you could use a query that looks like this:

{
  teamsConnection {
    nodes {
      coach {
        name {
          givenName
          familyName
        }
      }
      stadium {
        name
      }
    }
  }
}

And the response would contain the names that you requested and nothing else.

You can read about GraphQL at graphql.org.

How can I use it?

The API lives at api.platform.aaf.com.

If you click on the link above, you'll find a front-end that you can use to explore the API and view its documentation.

You don't need to go through any registration process and you don't need any credentials to get started. We just ask one thing: When possible, make sure your requests include a User-Agent header set to something unique and descriptive. It should include the name of your application and an email address or URL that we can use to identity you (such as a GitHub URL).

This is the same API that our internal tools use to manage data, and it'll be the same API that all of our yet-to-be-released apps will use. We'll be exposing more and more through the API in the weeks and months to come.

Introducing the Alliance GraphQL API
Share this