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.

PropertyValue(s)Description
idStringassets unique identifier
typeString
Examples: episode, movie
The asset's type
productionYearInteger (Optional)The production year of the asset
certificationString (Optional)
Examples: 18, PG, U
The asset's certification
metaMetaAssets meta data, see data dictionary.
categoryCategory (Optional)Indicates the asset's associated category types
attributeAttribute (Optional)Indicates the asset's associated attributes
summary.shortString (Optional)Short description of the asset
summary.mediumString (Optional)Medium description of the asset
summary.longString (Optional)Long description of the asset
related.typeString
Examples: episode, season, series
The related asset's type
related.titleStringThe 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