Asset

Details for asset resource

The following examples show how the Asset property values are identified.

The asset shown below is a movie asset.

{
  "id":"88934e86-c6c9-3403-b4c2-ab4c427e2325",
  "title":"The Fast and the Furious: Tokyo Drift",
  "type":"movie",
  "productionYear":2006,
  "certification":{
    "bbfc":"12"
  },
  "meta":{

  },
  "category":[
    {
      "id":"genre:adventure",
      "name":"Adventure",
      "dvb":"1F0F"
    }
  ],
  "attribute":[
    {
      "name":"Violent Scenes",
      "namespace":"violent-scenes"
    }
  ],
  "summary":{
    "short":"Motor-racing adventure, starring Lucas Black.",
    "medium":"An American teenager living in Japan gets involved in illegal street racing, but ends up owing money to gangsters. Action adventure, starring Lucas Black and Nathalie Kelley.",
    "long":"An American teenager is sent to live with his father in Tokyo after a brush with the law, but soon becomes involved in illegal street racing. When he ends up owing money to gangsters after losing a race against a driver with Yakuza connections, he has to learn to master the Japanese style of driving to win and pay back his debts. Action adventure, starring Lucas Black, Nathalie Kelley and Bow Wow."
  },
  "subject":[
    {
      "code":"movie:patv:916633",
      "profile":"asset"
    }
  ]
}

The asset shown below is a season asset, note the differing levels of content across asset types.

{
  "id":"697fb244-236a-5993-a95d-c9eba6e5f670",
  "type":"season",
  "title":"Midsomer Murders Season 15",
  "number":15,
  "certification":{

  },
  "meta":{

  },
  "attribute":[

  ],
  "summary":{
    "long":"A new run opens with John investigating reports of a headless horseman. In other shows, a barrister is killed with a lethal dose of morphine; and an astronomer is killed during a total eclipse of the sun.",
    "short":"Season 15 sees John investigating reports of a headless horseman. Plus, a barrister is murdered with a lethal dose of morphine, and an astronomer is killed during a total eclipse of the sun."
  },
  "related":[
    {
      "type":"series",
      "id":"0912ab38-d154-554b-8656-d4bfaf233026",
      "title":"Midsomer Murders",
      "subject":[
        {
          "code":"series:patv:4123",
          "profile":"asset"
        }
      ]
    }
  ],
  "subject":[
    {
      "code":"season:patv:32241",
      "profile":"asset"
    }
  ]
}

The table below outlines the possible values exposed in the Asset Detail and Asset Collection resources.

Property

Value(s)

Description

id

String

assets unique identifier

type

String
Examples: episode, movie

The asset's type

productionYear

Integer (Optional)

The production year of the asset

certification

String (Optional)
Examples: 18, PG, U

The asset's certification

meta

Meta

Assets meta data, see data dictionary.

category

Category (Optional)

Indicates the asset's associated category types

attribute

Attribute (Optional)

Indicates the asset's associated attributes

summary.short

String (Optional)

Short description of the asset

summary.medium

String (Optional)

Medium description of the asset

summary.long

String (Optional)

Long description of the asset

related.type

String
Examples: episode, season, series

The related asset's type

related.title

String

The related asset's title

Asset collection query parameters are outlined in the following Catalog collection.

👍

Pagination

The Asset collection allows for pagination. See the Pagination page for more details.

If no limit query parameter is supplied, a default value of 500 will be used.

🚧

v1 to v2

See our Migration section for further information on the changes made to this resource between API v1 and v2