Skip to main content

Season statistics

Season statistics are calculated only for regular season fixtures.

Currently supported sports and leagues:

  • American Football (17) - NFL

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
  • Current snapshot of the season statistics for a participant
  • 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": []
}