Bundles

The API representation of the default set of Bundles accessible to your application.

Bundles are like TV channels, but with every show available on-demand. Bundles are collections of Series. Wurl creates Bundles by selecting the Series that will be included in each Bundle and by specifying the order in which the selected Series will be presented in each Bundle.

Each Wurl application is automatically assigned the Wurl system-wide default set of Bundles. To have a different set of Bundles assigned as your application’s default, contact Wurl Support. Based on customer request, Wurl will create and manage additional Bundles.

For more information about how “Bundles” are used in the Wurl Index, visit the Wurl Index Hierarchy.

Request URL

https://api.wurl.com/api/bundles?format=json&access_token=TOKEN

Properties in the API Response

Name Type Description
none

Entities in the API Response

Name Class Description
Bundle .*bundle The API response to the Bundle query contains the API representation of a single Bundle accessible to your application.

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.
up The url to the parent of this resource.

Sample API Response

{
  "rel": [
    "urn:x-resource:schema:https://api.wurl.com/schemas/bundles.json"
  ],
  "class": [
    "collection",
    "bundles"
  ],
  "entities": [
    {
      "rel": [
        "urn:x-resource:schema:https://api.wurl.com/schemas/bundle.json",
        "urn:x-resource:name:bundle",
        "urn:x-resource:name:bundle"
      ],
      "class": [
        "bundle"
      ],
      "properties": {
        "id": 56,
        "title": "US Mix",
        "slug": "Featured_US",
        "description": "Featured series for US market",
        "primaryLanguage": "en",
        "category": "Mix",
        "topSeries": [
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394565,
              "description": "Billboard's YouTube channel brings you exclusive interviews with chart-topping artists, one-of-a-kind studio performance sessions and in-depth coverage of the world's biggest music events.",
              "channelsRank": 82.6346023602306,
              "pubDate": "2013-09-24T16:36:02Z",
              "title": "billboardmagazine",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394565/Uploads-by-Billboard--jpg"
                }
              },
              "totalEpisodes": 358,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCsVcseUYbYjldc-XgcsiEbg/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394565/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394565
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394565
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394565"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 342903,
              "description": "The Worldwide Leader in Sports",
              "channelsRank": 84.1644766839764,
              "pubDate": "2013-09-27T15:51:27Z",
              "title": "ESPN",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/167-2215/342903/Uploads-by-ESPN--jpg"
                }
              },
              "totalEpisodes": 2101,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCiWLfSweyRNmLpgEHekhoAg/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/342903/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 342903
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 342903
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/342903"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394567,
              "description": "Interviews and comedy sketches with host Jimmy Fallon.",
              "channelsRank": 83.1067839345378,
              "pubDate": "2013-09-27T08:30:00Z",
              "title": "latenight",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394567/Uploads-by-latenight--jpg"
                }
              },
              "totalEpisodes": 1097,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UC8-Th83bH_thdKZDJCrn88g/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394567/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394567
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394567
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394567"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394466,
              "description": "CNN delivers the latest breaking news and information on the latest top stories, weather, business, entertainment, politics, and more. For in-depth coverage, CNN.com provides special reports, video, audio, photo galleries, and interactive guides.",
              "channelsRank": 84.3332506036771,
              "pubDate": "2013-09-27T15:21:05Z",
              "title": "CNN",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394466/Uploads-by-CNN--jpg"
                }
              },
              "totalEpisodes": 2698,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCupvZG-5ko_eiXAupbDfxWw/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394466/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394466
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394466
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394466"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 393497,
              "description": "",
              "channelsRank": 83.2774433721628,
              "pubDate": "2013-09-27T14:47:05Z",
              "title": "PBSNewsHour",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/393497/Uploads-by-PBS-NewsHour--jpg"
                }
              },
              "totalEpisodes": 1025,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UC6ZFN9Tx6xh-skXCuRHCDpQ/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/393497/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 393497
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 393497
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/393497"
              }
            ]
          }
        ],
        "totalItems": 15
      },
      "entities": [
        {
          "rel": [
            "urn:x-resource:name:items"
          ],
          "href": "https://api.wurl.com/api/bundles/56/items",
          "class": [
            "link",
            "collection"
          ]
        }
      ],
      "links": [
        {
          "rel": [
            "self"
          ],
          "href": "https://api.wurl.com/api/bundles/56"
        },
        {
          "rel": [
            "up"
          ],
          "href": "https://api.wurl.com/api/bundles"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": [
        "self"
      ],
      "href": "https://api.wurl.com/api/bundles"
    },
    {
      "rel": [
        "up"
      ],
      "href": "https://api.wurl.com/api"
    }
  ]
}

Bundles

The API representation of the default set of Bundles accessible to your application.

Bundles are like TV channels, but with every show available on-demand. Bundles are collections of Series. Wurl creates Bundles by selecting the Series that will be included in each Bundle and by specifying the order in which the selected Series will be presented in each Bundle.

Each Wurl application is automatically assigned the Wurl system-wide default set of Bundles. To have a different set of Bundles assigned as your application’s default, contact Wurl Support. Based on customer request, Wurl will create and manage additional Bundles.

For more information about how “Bundles” are used in the Wurl Index, visit the Wurl Index Hierarchy.

Request URL

https://api.wurl.com/api/bundles?format=json&access_token=TOKEN

Properties in the API Response

Name Type Description
none

Entities in the API Response

Name Class Description
Bundle .*bundle The API response to the Bundle query contains the API representation of a single Bundle accessible to your application.

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.
up The url to the parent of this resource.

Sample API Response

{
  "rel": [
    "urn:x-resource:schema:https://api.wurl.com/schemas/bundles.json"
  ],
  "class": [
    "collection",
    "bundles"
  ],
  "entities": [
    {
      "rel": [
        "urn:x-resource:schema:https://api.wurl.com/schemas/bundle.json",
        "urn:x-resource:name:bundle",
        "urn:x-resource:name:bundle"
      ],
      "class": [
        "bundle"
      ],
      "properties": {
        "id": 56,
        "title": "US Mix",
        "slug": "Featured_US",
        "description": "Featured series for US market",
        "primaryLanguage": "en",
        "category": "Mix",
        "topSeries": [
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394565,
              "description": "Billboard's YouTube channel brings you exclusive interviews with chart-topping artists, one-of-a-kind studio performance sessions and in-depth coverage of the world's biggest music events.",
              "channelsRank": 82.6346023602306,
              "pubDate": "2013-09-24T16:36:02Z",
              "title": "billboardmagazine",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394565/Uploads-by-Billboard--jpg"
                }
              },
              "totalEpisodes": 358,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCsVcseUYbYjldc-XgcsiEbg/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394565/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394565
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394565
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394565"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 342903,
              "description": "The Worldwide Leader in Sports",
              "channelsRank": 84.1644766839764,
              "pubDate": "2013-09-27T15:51:27Z",
              "title": "ESPN",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/167-2215/342903/Uploads-by-ESPN--jpg"
                }
              },
              "totalEpisodes": 2101,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCiWLfSweyRNmLpgEHekhoAg/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/342903/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 342903
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 342903
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/342903"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394567,
              "description": "Interviews and comedy sketches with host Jimmy Fallon.",
              "channelsRank": 83.1067839345378,
              "pubDate": "2013-09-27T08:30:00Z",
              "title": "latenight",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394567/Uploads-by-latenight--jpg"
                }
              },
              "totalEpisodes": 1097,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UC8-Th83bH_thdKZDJCrn88g/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394567/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394567
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394567
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394567"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 394466,
              "description": "CNN delivers the latest breaking news and information on the latest top stories, weather, business, entertainment, politics, and more. For in-depth coverage, CNN.com provides special reports, video, audio, photo galleries, and interactive guides.",
              "channelsRank": 84.3332506036771,
              "pubDate": "2013-09-27T15:21:05Z",
              "title": "CNN",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/394466/Uploads-by-CNN--jpg"
                }
              },
              "totalEpisodes": 2698,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UCupvZG-5ko_eiXAupbDfxWw/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/394466/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394466
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 394466
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/394466"
              }
            ]
          },
          {
            "rel": [
              "urn:x-resource:schema:https://api.wurl.com/schemas/series.json"
            ],
            "class": [
              "series"
            ],
            "properties": {
              "id": 393497,
              "description": "",
              "channelsRank": 83.2774433721628,
              "pubDate": "2013-09-27T14:47:05Z",
              "title": "PBSNewsHour",
              "thumbnails": {
                "default": {
                  "url": "http://static0.channels.com/thumbnails/assets/youtube-com/feeds/192-2240/393497/Uploads-by-PBS-NewsHour--jpg"
                }
              },
              "totalEpisodes": 1025,
              "matchesApp": true,
              "link": "http://www.youtube.com/channel/UC6ZFN9Tx6xh-skXCuRHCDpQ/videos"
            },
            "entities": [
              {
                "rel": [
                  "urn:x-resource:name:episodes"
                ],
                "href": "https://api.wurl.com/api/series/393497/episodes",
                "class": [
                  "link",
                  "collection"
                ]
              }
            ],
            "actions": [
              {
                "name": "follow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Start following a series",
                "method": "POST",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 393497
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              },
              {
                "name": "unfollow-series",
                "href": "https://api.wurl.com/api/follows",
                "title": "Stop following a series",
                "method": "DELETE",
                "fields": [
                  {
                    "name": "series_id",
                    "type": "text",
                    "value": 393497
                  },
                  {
                    "name": "user_id",
                    "type": "text"
                  }
                ]
              }
            ],
            "links": [
              {
                "rel": [
                  "self"
                ],
                "href": "https://api.wurl.com/api/series/393497"
              }
            ]
          }
        ],
        "totalItems": 15
      },
      "entities": [
        {
          "rel": [
            "urn:x-resource:name:items"
          ],
          "href": "https://api.wurl.com/api/bundles/56/items",
          "class": [
            "link",
            "collection"
          ]
        }
      ],
      "links": [
        {
          "rel": [
            "self"
          ],
          "href": "https://api.wurl.com/api/bundles/56"
        },
        {
          "rel": [
            "up"
          ],
          "href": "https://api.wurl.com/api/bundles"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": [
        "self"
      ],
      "href": "https://api.wurl.com/api/bundles"
    },
    {
      "rel": [
        "up"
      ],
      "href": "https://api.wurl.com/api"
    }
  ]
}