Genius Sports Data API
Agent-ready OpenAPI document · curated by JenticData EnrichmentData Transformationbearer, apiKey, basic2 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Authenticate with Genius Sports and pull enhanced live match-state data for football, basketball, American football, and tennis fixtures.
Use for: I need to authenticate against Genius Sports and get a bearer token, Get the live match state for fixture 12345 in basketball, Retrieve enhanced match data for a specific tennis fixture, Find the current game clock and score for an American Football fixture
Not supported: Does not handle betting placement, odds compilation, or wagering settlement - use for official live match-state and fixture data retrieval only.
Jentic publishes the only available OpenAPI specification for Genius Sports Data API, keeping it validated and agent-ready. Genius Sports provides authenticated access to sports fixtures and live match-state data for American Football, Basketball, Football, and Tennis. The two-step flow exchanges client credentials for an OAuth token at /oauth2/token and then pulls enhanced live match state from the platform fixtures endpoint, which feeds into a real-time Ably stream for downstream subscribers. It is built for sportsbooks, broadcasters, and analytics products that need official, low-latency match data.
Install Jentic One Beta
Connect the Genius Sports Data API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Genius Sports Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgeniussports.com%2Fgeniussports" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fgeniussports.com%2Fgeniussports" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Genius Sports Data API.
Exchange client credentials for an OAuth bearer token via /oauth2/token
Pull enhanced live match-state for a specific fixture and sport combination
Drive a real-time Ably stream subscription using the access token returned by the auth call
Power sportsbook pricing models with low-latency play-by-play data
Feed broadcaster graphics overlays from the live match-state payload
Use Cases
Patterns agents use Genius Sports Data API for, with concrete tasks.
★ Sportsbook Live Pricing
Sportsbooks pricing in-play markets need authoritative, low-latency match state to update odds. Genius Sports provides official-feed match state for football, basketball, American football, and tennis through its enhanced match-state endpoint, with continuous updates pushed via Ably so trading engines can react to scores, fouls, and possession changes within sub-second latency.
Authenticate via /oauth2/token, then call the enhanced match-state endpoint for fixture 88421 in basketball every 5 seconds and update the in-play odds model
Broadcast Graphics Pipeline
Broadcast graphics overlays - scorebugs, possession arrows, win-probability widgets - need a single authoritative source of match state. Genius Sports' enhanced match-state response provides the structured fields the graphics engine consumes, eliminating the manual operator entry step for low-tier matches.
Pull enhanced match state for fixture 99231 in tennis and push the current set score and break-point indicator to the graphics engine
Fan App Live Updates
Consumer fan apps push live notifications and update lineup screens during matches. Genius Sports' fixture+match-state pairing gives the app a structured stream of game events; apps can subscribe to the Ably channel returned by the live-access call and render score, time, and momentum changes in real time.
Authenticate, then call the live-access match-state endpoint for fixture 77123 to obtain the Ably channel and subscribe for push updates
AI Agent Sports Insights
An AI agent generating commentary, fantasy advice, or betting context can lean on Genius Sports as the structured ground truth. Through Jentic, the agent exchanges credentials for a token and pulls the latest match state for the requested fixture without handling raw OAuth client secrets or x-api-key values directly.
Search Jentic for 'get live match state', authenticate against Genius Sports, and return the current score and possession for fixture 65501 in American Football
Key Endpoints
2 endpoints — jentic publishes the only available openapi specification for genius sports data api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/oauth2/token
Exchange client credentials for a bearer access token
GET
/api/v2/sources/{source}/sports/{sportId}/fixtures/{fixtureId}/liveaccess/matchstate/enhanced
Retrieve enhanced live match-state for a specific fixture
POST
/oauth2/token
Exchange client credentials for a bearer access token
GET
/api/v2/sources/{source}/sports/{sportId}/fixtures/{fixtureId}/liveaccess/matchstate/enhanced
Retrieve enhanced live match-state for a specific fixture
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Genius Sports Data API by hand means running the /oauth2/token exchange, choosing between the auth and match-state hosts, and attaching the bearer token and x-api-key on the right calls yourself. Through Jentic you install once, import Genius Sports from the API Directory, store the client credentials once, and your agent calls it.
Permission scoping
Genius Sports puts the fixture in the URL path (/sources/{source}/sports/{sportId}/fixtures/{fixtureId}/liveaccess/matchstate/enhanced), so a rule can pin your agent to one fixture: it can read that fixture's live match state and nothing else. You choose the operations it may call, so nothing beyond the read you allow runs.
Credential isolation
Your Genius Sports client credentials and x-api-key are stored once, encrypted, by your own Jentic One instance, and the token exchange runs at execution time. The raw OAuth secrets never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get live match state for a fixture', and Jentic returns the matching Genius Sports operation with its input schema and the fixture and sport parameters the agent must supply, so it calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Genius Sports Data API through Jentic.
Why is there no official OpenAPI spec for Genius Sports Data API?
Genius Sports does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Genius Sports Data API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Genius Sports Data API use?
Genius Sports requires an OAuth flow - POST client credentials to /oauth2/token to obtain a bearer token, then send it on subsequent calls. An x-api-key header and basic auth are also accepted depending on the deployment. Through Jentic the credentials live in the vault and tokens are refreshed transparently.
Which sports does the Genius Sports Data API cover?
The spec exposes enhanced live match-state for American Football, Basketball, Football (soccer), and Tennis. The sportId path parameter on the match-state endpoint selects the sport for a given fixture.
What are the rate limits for the Genius Sports Data API?
The OpenAPI spec does not declare formal rate limits. Genius Sports caps usage by contract - the live match-state endpoint is intended to be combined with the Ably stream for push updates rather than tight polling, so subscribe to the channel returned by the call instead of re-polling per second.
How do I get live match state for a fixture through Jentic?
Run pip install jentic, search Jentic for 'get live match state', and execute the OAuth token call followed by the enhanced match-state operation with your source, sportId, and fixtureId. Jentic chains the two calls so the agent only specifies the fixture context.
Is the Genius Sports Data API free?
No - Genius Sports operates on commercial contracts with sportsbooks, broadcasters, and media partners. You need credentials issued by Genius Sports to authenticate against /oauth2/token before any data calls succeed.
Can I limit what my agent is allowed to do with the Genius Sports Data API?
Yes. Because you run Jentic One yourself, your own rules decide which Genius Sports operations and credentials the agent may use, and this API exposes just two: the /oauth2/token exchange and the enhanced live match-state read. Since the source, sport, and fixture are all in the URL path, a rule can pin the agent to a single fixture so it reads that fixture's live match state and nothing else. Any operation you do not allow simply does not run.
GET STARTED