Global Metadata API

Getting global supplementary data

The global metadata API can be used to fetch supplementary information about shared entities like sport, location, league, or competitor.

The endpoints are rate-limited.

Recommended Usage Pattern

To discover what types of metadata are available for a specific entity, it's recommended to call the /types endpoint first. This helps you query only the relevant data types afterward.

Example:

• Get available metadata types for a team/competitor:

get

Authorizations

Bearer

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

sportIdinteger · int64Required

leagueIdinteger · int64Required

competitorIdinteger · int64Required

Responses

200

OK

text/plainapplication/jsontext/json

Responsestring[]

401

Unauthorized

403

Forbidden

429

Too many requests

get

/api/GlobalMetadata/sport/{sportId}/league/{leagueId}/competitor/{competitorId}/types

HTTPcURLJavaScriptPython

GET /api/GlobalMetadata/sport/{sportId}/league/{leagueId}/competitor/{competitorId}/types HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  "text"
]

• Get available metadata for that specific metadata type:

get

Authorizations

Bearer

HTTPRequired

JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Path parameters

sportIdinteger · int64Required

leagueIdinteger · int64Required

competitorIdinteger · int64Required

dataTypestringRequired

Query parameters

versioninteger · int64Optional

Responses

200

OK

text/plainapplication/jsontext/json

401

Unauthorized

403

Forbidden

404

Not Found

text/plainapplication/jsontext/json

429

Too many requests

get

/api/GlobalMetadata/sport/{sportId}/league/{leagueId}/competitor/{competitorId}/{dataType}

HTTPcURLJavaScriptPython

GET /api/GlobalMetadata/sport/{sportId}/league/{leagueId}/competitor/{competitorId}/{dataType} HTTP/1.1
Host: 
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "sportId": 1,
  "locationId": 1,
  "leagueId": 1,
  "competitorId": 1,
  "playerId": 1,
  "dataType": "text",
  "version": 1,
  "data": null,
  "creationTime": "2025-12-05T16:59:17.821Z",
  "feedSource": 1
}