Episode

A single video that is published by a Series.

Request URL

https://api.wurl.com/api/series/SERIES_ID/episodes/ID?format=json&access_token=TOKEN
  • SERIES_ID – a unique identifier for a Series in the Wurl Index (e.g. 394565)
  • ID – a unique identifier for a video Episode in the Wurl Index (e.g. 18029764)
  • TOKEN - your Wurl API access token (Get more info at: Authentication Guide)

Properties in the API Response

Name Type Description
id number A number (assigned by Wurl) that uniquely identifies this Episode.
title string The episode title as provided by the publisher.
description string A description of the Episode provided by the publisher.
link string The publisher-provided URL of the video Episode. Typically, a deep link to a page on the publisher’s website.
thumbnails A thumbnail image from the Episode.
channelsRank number ChannelsRank is a number reflecting our view of the quality of each Episode. This value is inherited from the Series that contains this Episode. Scale of 0-100 (100 = highest rank).
pubDate string The publication date of the episode.
playback array The properties relevant to playing a video are the values inside the playback array. These are more fully described in 'Play a Video'.

Entities in the API Response

Name Class Description
Series Link link,series,wurl-series Sub-entity link to the API representation of a Wurl Series.

Links in the API Response

Name Description
self The canonical or preferred url to a resource.
schema The url to a resource's json-schema.

Sample API Response

{
  "links": [
    {
      "rel": [
        "self"
      ],
      "href": "https://api.wurl.com/api/series/405266/episodes/31334969"
    },
    {
      "rel": [
        "schema"
      ],
      "href": "https://api.wurl.com/schemas/episode.json"
    }
  ],
  "entities": [
    {
      "href": "https://api.wurl.com/api/series/405266",
      "class": [
        "link",
        "series",
        "wurl-series"
      ],
      "rel": [
        "urn:x-resource:name:series",
        "series"
      ]
    }
  ],
  "class": [
    "episode",
    "wurl-episode"
  ],
  "properties": {
    "id": 31334969,
    "studioName": "info@wurl.com",
    "description": "Lola Gold entices The Awesomes to boost their profile.",
    "channelsRank": 59.660391342665,
    "height": 720,
    "pubDate": "2015-10-12T14:12:02.000Z",
    "title": "The Awesomes Season 2 Ep 5 - The Awesome's Awesome",
    "link": "http://wurl.com",
    "thumbnails": {
      "default": {
        "url": "http://static1.wurl.com/thumbs/2245/episodes/31334969-jpg"
      }
    },
    "showId": 405266,
    "playback": [
      {
        "aspectRatio": "16:9",
        "definition": "hd",
        "duration": 318,
        "embed": "<video controls preload=\"auto\" height=\"448\" style=\"width: 100%; image-fit: fill; object-fit:fill;\" poster=\"http://static1.channels.com/thumbs/2245/episodes/31334969-jpg\">\n    <source src=\"http://media.wurl.com/auto/7e6884ebe/item.wurl\" type=\"*/*\"/>\n</video>\n\n",
        "mediaUrl": "http://media.wurl.com/auto/7e6884ebe/item.wurl",
        "provider": "",
        "mediaType": "*/*",
        "type": "html5"
      },
      {
        "aspectRatio": "16:9",
        "definition": "hd",
        "duration": 318,
        "mediaUrl": "http://media.wurl.com/auto/7e6884ebe/item.wurl",
        "provider": "",
        "mediaType": "*/*",
        "type": "direct"
      }
    ],
    "width": 1280
  }
}

Episode

A single video that is published by a Series.

Request URL

https://api.wurl.com/api/series/SERIES_ID/episodes/ID?format=json&access_token=TOKEN

Properties in the API Response

Name Type Description
id number A number (assigned by Wurl) that uniquely identifies this Episode.
title string The episode title as provided by the publisher.
description string A description of the Episode provided by the publisher.
link string The publisher-provided URL of the video Episode. Typically, a deep link to a page on the publisher’s website.
thumbnails A thumbnail image from the Episode.
channelsRank number ChannelsRank is a number reflecting our view of the quality of each Episode. This value is inherited from the Series that contains this Episode. Scale of 0-100 (100 = highest rank).
pubDate string The publication date of the episode.
playback array The properties relevant to playing a video are the values inside the playback array. These are more fully described in 'Play a Video'.

Entities in the API Response

Name Class Description
Series Link link,series,wurl-series Sub-entity link to the API representation of a Wurl Series.

Links in the API Response

Name Description
self The canonical or preferred url to a resource.
schema The url to a resource's json-schema.

Sample API Response

{
  "links": [
    {
      "rel": [
        "self"
      ],
      "href": "https://api.wurl.com/api/series/405266/episodes/31334969"
    },
    {
      "rel": [
        "schema"
      ],
      "href": "https://api.wurl.com/schemas/episode.json"
    }
  ],
  "entities": [
    {
      "href": "https://api.wurl.com/api/series/405266",
      "class": [
        "link",
        "series",
        "wurl-series"
      ],
      "rel": [
        "urn:x-resource:name:series",
        "series"
      ]
    }
  ],
  "class": [
    "episode",
    "wurl-episode"
  ],
  "properties": {
    "id": 31334969,
    "studioName": "info@wurl.com",
    "description": "Lola Gold entices The Awesomes to boost their profile.",
    "channelsRank": 59.660391342665,
    "height": 720,
    "pubDate": "2015-10-12T14:12:02.000Z",
    "title": "The Awesomes Season 2 Ep 5 - The Awesome's Awesome",
    "link": "http://wurl.com",
    "thumbnails": {
      "default": {
        "url": "http://static1.wurl.com/thumbs/2245/episodes/31334969-jpg"
      }
    },
    "showId": 405266,
    "playback": [
      {
        "aspectRatio": "16:9",
        "definition": "hd",
        "duration": 318,
        "embed": "<video controls preload=\"auto\" height=\"448\" style=\"width: 100%; image-fit: fill; object-fit:fill;\" poster=\"http://static1.channels.com/thumbs/2245/episodes/31334969-jpg\">\n    <source src=\"http://media.wurl.com/auto/7e6884ebe/item.wurl\" type=\"*/*\"/>\n</video>\n\n",
        "mediaUrl": "http://media.wurl.com/auto/7e6884ebe/item.wurl",
        "provider": "",
        "mediaType": "*/*",
        "type": "html5"
      },
      {
        "aspectRatio": "16:9",
        "definition": "hd",
        "duration": 318,
        "mediaUrl": "http://media.wurl.com/auto/7e6884ebe/item.wurl",
        "provider": "",
        "mediaType": "*/*",
        "type": "direct"
      }
    ],
    "width": 1280
  }
}