Genius Sports Data API

Name: Genius Sports Data API
Brand: Genius Sports Data API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData Transformationbearer, apiKey, basic2 EndpointsREST

For Agents

Authenticate with Genius Sports and pull enhanced live match-state data for football, basketball, American football, and tennis fixtures.

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.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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

GET STARTED

Start building with Genius Sports Data API

Explore with Jentic

View OpenAPI Document

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.

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?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Genius Sports client credentials and x-api-key values are stored encrypted in the Jentic vault. Jentic performs the /oauth2/token exchange and injects the bearer token on outgoing calls — the agent never sees raw OAuth client secrets.

Intent-based discovery

Agents search by intent ('get live match state for a fixture') and Jentic returns the chained operation pair (token exchange + match-state call) with the fixture/sport parameters the agent must supply.

Time to first call

Direct Genius Sports integration: 1-2 weeks for OAuth handling, token refresh, and Ably stream wiring. Through Jentic: under 1 hour to call the enhanced match-state endpoint with your fixture context.

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 at https://app.jentic.com/sign-up.

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.