v1

latestOpenAPI 3.0.12026-07-24207094.9 KB

TV Shows

Episode Metrics

Retrieves metrics for a tv show episode

get/svm/tv_shows/{id}/seasons/{season}/episodes/{episode}/metrics

Path parameters

idstring required

Unique Luminate ID assigned to the TV show

seasonstring required

ID of the TV show’s season

episodestring required

Episode of the season

Query parameters

start_datestring date required

First date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD).

end_datestring date required

Last date used in the aggregation of the consumption data. Value must be formatted according to the ISO 8601 date standard (YYYY-MM-DD).

Response

Complete metrics over the date range requested

Example response

{
  "data": {
    "id": "91b4ec3ad5a4b7a7eeb44d91befb3d1d",
    "season": "1",
    "episode": "1",
    "start_date": "2025-03-01",
    "end_date": "2025-03-01",
    "metrics": [
      {
        "name": "minutes_watched",
        "granularity": "daily",
        "value": [
          {
            "data_status": "official"
          }
        ]
      }
    ]
  }
}