TV Shows

Episode Metrics

Retrieves metrics for a tv show episode

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

Request

  • Base URL
    https://api.luminatedata.com
  • URL
    https://api.luminatedata.com/svm/tv_shows/{id}/seasons/{season}/episodes/{episode}/metrics
  • Auth
    API key in header x-api-key and API key in header authorization

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"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.