Genius Sports Live Sports Data Pull APIs
- Martin Kuks
Overview
Genius Sports Live Sports Data Pull APIs are collection of REST APIs that provide entry point for integration with Genius Sports live sports data ecosystem for both data producers (also called feed providers) and data consumers. Typically a user of Pull APIs would either provide live sports data or consume it but in some cases they can do both.
Match State Platform APIs
Match State Platform APIs are set of APIs that expose entry points for integration for both feed providers and consumers that process information about the current state of a sport event. For example in a football (soccer) game, current state of the sport event would contain information about the goals, corners, cards and many more details that could provide meaningful data for downstream consumers. Such piece of information is called Match State. It is aggregation of all Match Events in the game.
Match Events
Data contracts each of which represents a single action that happened during a match (e.g. GoalScored, CornerAwarded). When aggregated they form Match State. Match Events are sport specific and source agnostic in MS.Platform and Feed Agnostic Framework but they are source and sport specific in Legacy Framework (InPlay.Feeds). Consumer of Match Events need to maintain state of previously published ones as single Match Event only contains data for latest action in a match.
Match State
Match State is a sport specific data contract that represents the current state of a sport event. It is generated by aggregating all Match Events for that match. Amount of data in Match State contract gradually increases with the progress of an ongoing match as data from each Match Event is applied on top of the data from all previous Match Events. In contrast with Match Events that require from their consumers to maintain state, most recent Match State is the only source of truth that consumers need as it contains all the data previously generated Match States for that match have plus the latest update.
Match Actions
Set of collections within Match State contract that represent something that happened during a match. For example - Goals, Substitutions, Corners. Each collection contains all Match Actions that happened so far and new Match Actions are only added with the progress of an ongoing match. Match Actions collections are populated based on Match Events.