Subscription Queries
Subscriptions can be used to receive near real-time results whilst a match is being played (or if Hudl Statsbomb replays a match).
A subscription is a GraphQL query that also listens for updates to the data and continues to return results as new data is added. When a subscription receives new data it may contain new and existing events if the new data is smaller than the limit set on the subscription.
Some fields are not available via a subscription (e.g. player
, team
and match
metadata) and including those fields will return an error.
API limits
A subscription returns 50 events by default. Include a limit
condition to change the maximum number of results returned from each update.