Sports data models in Liveblog API

This documents the sports data models which are currently supported in the Liveblog API.

Note: all fields with id should be treated as string: they can be either integer or UUID.

Changes compared to Football API models

team: id integer to string, removed country property
tournament: id integer to string, removed the country and the seasons property
coach: id integer to string, removed country property
player: id integer to string, removed country, height, weight
match: id integer to string

Generic data models

These are generic data models which contain basic information about the sport entity.

The same data structure will be used for all sports. Some additional information may be added as necessary for the context of the sport.

Competition

This is the top level competition that is the same entity across seasons. E.g 'Champions League', 'NBA', 'Roland Garros'.

Note the entity_type: tournament is kept for legacy reasons due to Football API.

The model is used in the Liveblog in the competitions array.

{
  "id": "3",
  "entity_type": "tournament",
  "sport": "football",
  "name": "Premier League",
  "region": "DOMESTIC",
  "gender": "MALE",
  "regional_league": true,
  "type": "LEAGUE",
  "url_logo": "https://image.api.integration.sportal365.com/process/smp-image-api-shared-region-integration/assets/15082022/87501e33-d82d-4098-854c-9e50259d7c6f.png",
  "slug": "premier-league-3"
}

Team

This model is used in the Liveblog teams array and the Liveblog posts sport_tags array.

{
  "id": "104",
  "entity_type": "team",
  "sport": "football",
  "name": "Manchester City",
  "type": "club",
  "gender": "MALE",
  "three_letter_code": "MNC",
  "short_name": "M. City",
  "url_logo": "https://image.api.integration.sportal365.com/process/smp-image-api-shared-region-integration/assets/12052022/d867d35a-17fe-4b14-839b-44a4a87e17a9.png?operations=autocrop(150:150)",
  "undecided": false,
  "slug": "manchester-city-104"
}

Athlete

Used in the Liveblog posts sport_tags array

{
  "id": "133190",
  "entity_type": "player",
  "sport": "football",
  "name": "Erling Haaland",
  "slug": "erling-haaland-133190",
  "gender": "MALE",
  "url_thumb": "https://sportal365images.com/process/smp-images-production/assets/06082021/1628278011237.jpg?operations=autocrop(150:150)",
  "url_image": null,
  "birthdate": "2000-07-21",
  "active": true,
  "position": "forward"
}

Coach

Used in the Liveblog posts sport_tags array

{
  "id": "8494",
  "entity_type": "coach",
  "sport": "football",
  "name": "Pep Guardiola",
  "slug": "pep-guardiola-8494",
  "gender": "MALE",
  "url_image": null,
  "url_thumb": "https://sportal365images.com/process/smp-images-production/assets/15052023/a17dd26f-644b-4887-81a8-9d19b7fb5bd7.jpg?operations=autocrop(150:150)",
  "birthdate": "1971-01-18",
  "active": true
}

Sport specific data models

This section contains information on data models which are sports specific. This is usually the sport event where there is custom information according to the context of the sport.

Football Match

The football match is the same data model as returned the Football API /matches?match_ids=... endpoint.

NOTE: The minute property of the match is only available when the match is actually live.

{
  "id": "2699781",
  "event_status": {
    "id": 1,
    "name": "Finished",
    "type": "finished",
    "code": "finished",
    "short_name": "FIN"
  },
  "start_time": "2023-05-28T15:30:00+00:00",
  "home_team": {
    "id": "136",
    "name": "Brentford",
    "slug": "brentford-136",
    "three_letter_code": "BRE",
    "type": "club",
    "gender": "MALE",
    "short_name": null,
    "url_logo": "https://sportal365images.com/process/smp-images-production/assets/22032022/e2154e81-8cbc-4e73-993a-13e7aae588fe.png?operations=autocrop(150:150)"
  },
  "away_team": {
    "id": "104",
    "name": "Manchester City",
    "slug": "manchester-city-104",
    "three_letter_code": "MCI",
    "type": "club",
    "gender": "MALE",
    "short_name": null,
    "url_logo": "https://sportal365images.com/process/smp-images-production/assets/12052022/d867d35a-17fe-4b14-839b-44a4a87e17a9.png?operations=autocrop(150:150)"
  },
  "round": "38",
  "goal_home": 1,
  "goal_away": 0,
  "slug": "brentford-manchester-city-2699781",
  "tournament_season_stage": {
    "id": 18118,
    "name": "Premier League",
    "slug": "premier-league-18118",
    "cup": false,
    "tournament_season_id": 7550,
    "tournament_id": 3,
    "country": {
      "id": 15,
      "name": "England",
      "slug": "england-15",
      "url_flag": "https://sportal365images.com/process/smp-images-production/assets/country/flag/15-England-flag.png"
    }
  },
  "incidents": 11,
  "home_score": {
    "half_time": 0,
    "ordinary_time": 1,
    "after_extra_time": 0
  },
  "away_score": {
    "half_time": 0,
    "ordinary_time": 0,
    "after_extra_time": 0
  },
  "venue": {
    "id": 70277,
    "name": "Gtech Community Stadium",
    "slug": "gtech-community-stadium-70277",
    "url_image": null
  },
  "referee": {
    "id": 1022,
    "name": "John Brooks",
    "slug": "john-brooks-1022",
    "url_thumb": null,
    "url_image": null
  },
  "spectators": 17120,
  "lineup_available": true,
  "live_updates": true,
  "updated_at": "2023-06-08T13:27:34+00:00",
  "teamstats_available": true,
  "finished_at": "2023-05-28T17:23:15+00:00",
  "started_at": "2023-05-28T16:33:02+00:00"
}