Developer Community
StatsBomb LIVE Data API provides highly detailed match event information for current and historic matches.
The API also provides statistical information about players and teams, to help coaches and managers understand the performance dynamics over a match or season. Accessing the LIVE Data API
Please discuss your needs with StatsBomb Sales or Customer Success teams to licence usage of all this data.
LIVE Data API endpoint
https://live-api.statsbomb.com/v1/graphql
Glossary of terms
StatsBomb Live Data API Glossary (external document) includes definitions of the fields available in each section of an event
Secure access to the API
Each customer is provided with a credentials from the StatsBomb Customer Success team. Customers use these credentials to generate a token which is sent with every query and subscription to the LIVE Data API.
A Customer Token expires after 24 hours, so StatsBomb recommends creating a daily task to generate a new token at the start of each day. Tokens can be used via environment variables to simplify use with applications and services.
Obtaining a token
The Customer Token section details how to use the client credentials to obtain a customer token
Querying the API
The StatsBomb Live API is accessed via GraphQL queries and subscriptions.
Subscribe to a match currently being played and get near-realtime information of your choosing, from any of the events in the match. Subscriptions can also provide specific player and team statistics for the current match.
Queries can be run on current matches or any matches a customer is entitled to view.
Statsbomb customers define their own specific queries, defining exactly the information to be returned.
Results Data Format
The results from the Live Data API are returned in JSON format, where each observation is one unique event, with all variable values corresponding to that event and that event type included. The JSON format allows for nested data frames, and thus, observations will never be replicated.
What is GraphQL
GraphQL is a query language for APIs.
Rather than having fixed endpoints as with REST APIs, a GraphQL API allows the developer to write their own queries and choose exactly the information to be returned.
GraphQL APIs provides a complete description of the data available via a single API endpoint and all the types of values can be browsed using tools such as Apollo Studio.
GraphQL Programming Language Support
A wide range of programming languages can be used with GraphQL to develop applications, notebooks and services that connect to the StatsBomb Live Match Data API.
An initial reference and some basic examples of querying the LIVE Data API can be found on the StatsBomb LIVE Data API website. This website and documentation are currently being improved
GraphQL references