Season statistics

Season statistics can be calculated either for regular season fixtures or all fixtures in a season, depending on the configuration.

Currently supported sports and leagues:

• American Football (17)
  • NFL regular season only
  • CFL regular season only
• Football (10)
  • Belgium First Division A full season
  • Belgium First Division B full season

Statistics attribution for participants

For participants season statistics are calculated throughout the season, messages with such calculations do not include any competitorId for the participant.
Participant statistics attribution for every represented competitor is enabled for some sports and leagues. In such case, there will be two messages sent for every statistic change, one without competitorId and one with it.

Currently supported sports and leagues:

• Football (10)
  • Belgium First Division A full season
  • Belgium First Division B full season

First message:

{
	"metadata": {
		"version": "v3",
		"generatedAt": "2026-07-01T07:45:25.228949Z",
		"sequence": 1,
		"sourceId": "GeniusIQ",
		"seasonId": "160227",
		"competitionId": "36"
	},
	"competitors": [],
	"participants": [
		{
			"id": "774841",
			"statistics": [
				{
					"name": "appearances",
					"value": 2.00000
				}
			]
		}
	]
}

Second message:

{
	"metadata": {
		"version": "v3",
		"generatedAt": "2026-07-01T07:45:25.2361938Z",
		"sequence": 2,
		"sourceId": "GeniusIQ",
		"seasonId": "160227",
		"competitionId": "36"
	},
	"competitors": [],
	"participants": [
		{
			"competitorId": "10197",
			"id": "774841",
			"statistics": [
				{
					"name": "appearances",
					"value": 2.00000
				}
			]
		}
	]
}

Pull feed

Pull feed contains these endpoints:

• Current snapshot of the season statistics for a competitor, contains all participants that played in at least one fixture for that competitor in a season. If attribution per competitor is enabled for participants, will only return statistics related to representing that competitor, otherwise will return statistics for the whole season
• Current snapshot of the season statistics for a participant, can contain entries for each competitor, if supported
• List of all messages produced for a competitor, used to bootstrap Push feed
• List of all messages produced for a participant, used to bootstrap Push feed

Push feed

Schema can be found in JsonSchema and AsyncAPI pages.

Every message in push feed contains the difference between all messages produced before and newest statistics values. To have a full view of all the statistics, all messages need to be aggregated by sequence that they were published. If the value for a statistic is set to null, it means that the statistic should be discarded. List of all produced messages can be retrieved from the pull feed. Messages are produced for each competitor and participant separately (only one of competitor or participant will be present in a message), each competitor and participant has a separate sequence number.

Examples

Message 1:

{
  "metadata": {
    "seasonId": "158559",
    "competitionId": "296",
    "sourceId": "GeniusPremium",
    "sequence": 1,
    "generatedAt": "2025-07-08T10:00:00.000Z",
    "version": "v3"
  },
  "competitors": [
    {
      "id": "89169",
      "statistics": [
        {
          "name": "rushingYardsAverage",
          "value": 12.11111
        },
        {
          "name": "rushingYards",
          "value": 120
        }
      ]
    }
  ],
  "participants": []
}

Message 2:

{
  "metadata": {
    "seasonId": "158559",
    "competitionId": "296",
    "sourceId": "GeniusPremium",
    "sequence": 2,
    "generatedAt": "2025-07-08T10:01:00.000Z",
    "version": "v3"
  },
  "competitors": [
    {
      "id": "89169",
      "statistics": [
        {
          "name": "passesSucceeded",
          "value": 15
        },
        {
          "name": "passesSucceededYards",
          "value": 150
        }
      ]
    }
  ],
  "participants": []
}

Message 3:

{
  "metadata": {
    "seasonId": "158559",
    "competitionId": "296",
    "sourceId": "GeniusPremium",
    "sequence": 3,
    "generatedAt": "2025-07-08T10:01:00.000Z",
    "version": "v3"
  },
  "competitors": [
    {
      "id": "89169",
      "statistics": [
        {
          "name": "passesSucceeded",
          "value": null
        }
      ]
    }
  ],
  "participants": []
}

All statistics:

{
  "metadata": {
    "seasonId": "158559",
    "competitionId": "296",
    "sourceId": "GeniusPremium",
    "sequence": 3,
    "generatedAt": "2025-07-08T10:01:00.000Z",
    "version": "v3"
  },
  "competitors": [
    {
      "id": "89169",
      "statistics": [
        {
          "name": "rushingYardsAverage",
          "value": 12.11111
        },
        {
          "name": "rushingYards",
          "value": 120
        },
        {
          "name": "passesSucceededYards",
          "value": 150
        }
      ]
    }
  ],
  "participants": []
}