Gracenote Global Sports Data Update API

The update and ingestion counterpart to the Global Sports Data Lookup API — thirteen endpoints that deliver changed sports records so a consumer can keep a local store in sync rather than re-polling the lookup surface.

Operations 13

GET /TvSportsData/Sports Sports
GET /TvSportsData/Disciplines Disciplines
GET /TvSportsData/Events Events
GET /TvSportsData/Organizations Organizations
GET /TvSportsData/Persons Persons
GET /TvSportsData/Venues Venues
GET /TvSportsData/EventParticipants EventParticipants
GET /TvSportsData/EventClassifications EventClassifications
GET /TvSportsData/Actions Actions
GET /TvSportsData/Phases Phases
GET /TvSportsData/Articles Articles
GET /TvSportsData/Images Images
GET /TvSportsData/Translations Translations

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/global-sports-data-update-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gracenote-global-sports-data-update-api-openapi.json Raw ↑
{
  "openapi": "3.1.1",
  "info": {
    "title": "Global Sports Data Update API v6",
    "description": "Update endpoints for Global Sports Data",
    "version": "6"
  },
  "servers": [
    {
      "url": "/proxy/sports"
    }
  ],
  "paths": {
    "/TvSportsData/Sports": {
      "get": {
        "summary": "Sports",
        "description": "Returns all sports.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Disciplines": {
      "get": {
        "summary": "Disciplines",
        "description": "Returns all sport disciplines.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Events": {
      "get": {
        "summary": "Events",
        "description": "Returns all sports events. Events represent matches (e.g. Philadelphia-NY Giants) as well as league/conference/division seasons (e.g. 2016-2017 NFL, 2016-2017 NFC, 2016-2017 NFC East ) and league/conference/division season phases (e.g. NFL 2016-2017 Regular Season,  NFL 2016-2017 Regular Season - Week 1). ",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Organizations": {
      "get": {
        "summary": "Organizations",
        "description": "Returns all sports organizations. Organizations represent teams (e.g. Philadelphia Eagles), leagues (e.g. NFL), conferences (e.g. NFC) and divisions (e.g.. NFC East).",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Persons": {
      "get": {
        "summary": "Persons",
        "description": "Returns all people (players, officials).",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Venues": {
      "get": {
        "summary": "Venues",
        "description": "Returns all sports venues.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/EventParticipants": {
      "get": {
        "summary": "EventParticipants",
        "description": "Returns all participants (teams, persons, venues) from events and their stats.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/EventClassifications": {
      "get": {
        "summary": "EventClassifications",
        "description": "Returns all event classifications.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Actions": {
      "get": {
        "summary": "Actions",
        "description": "Returns all actions for sports events. Actions represent the play-by-play for matches with this level of coverage.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Phases": {
      "get": {
        "summary": "Phases",
        "description": "",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Articles": {
      "get": {
        "summary": "Articles",
        "description": "",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Images": {
      "get": {
        "summary": "Images",
        "description": "Returns all sports images.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    },
    "/TvSportsData/Translations": {
      "get": {
        "summary": "Translations",
        "description": "Returns all translations.",
        "tags": [
          "Update Endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ApiKeyQuery"
          },
          {
            "$ref": "#/components/parameters/AcceptHeader"
          },
          {
            "name": "updateId",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Token-based update retrieval. Updates will be retrieved with specified updateId value. For full seeding, specify updateId=0. Increment max updateId by one to retrieve next set of updated records."
          },
          {
            "name": "limit",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "default": ""
            },
            "description": "Maximum number of objects to retrieve for processing predictable batch sizes. Each iteration would retain limit number for same batch size."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response"
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "ApiKeyQuery": {
        "name": "api_key",
        "in": "query",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "API key for authentication"
      },
      "AcceptHeader": {
        "name": "Accept",
        "in": "header",
        "required": false,
        "schema": {
          "type": "string",
          "default": "application/json"
        }
      }
    }
  }
}