Overview

This is the reference guide to the Boclips API.

Terms of service

Playback information

As an API user, you are responsible for submitting video playback information to Boclips via our events API. If you are using Boclips' JavaScript player this will be done automatically, however, if you are not, you must submit these playback events yourselves. More information about how to do this can be found here.

Undocumented fields

When using the API you may notice some fields in the response that are not documented. These undocumented fields are likely to change and must not be implemented against unless explicit approval has been given from Boclips (typically when testing beta features). The full extent of Boclips' API offering is explicitly documented in these docs.

Changes to the API

On the rare occasion that we need to make breaking changes to our API, the process of making this change will go like:

  1. Keeping support for the old way, we will introduce the change into our API.

  2. We will notify you of this change, with clear instructions on how to start using the new changes. We will then give a time frame for when we will drop support for the old way.

    • Our docs will be updated and the old way will be clearly deprecated.

  3. A week before we are scheduled to drop support we will notify you again to make sure you’re ready.

  4. If you need more time, we will push back on dropping support.

  5. Once you are happy you have made the change we will then drop support and undocument the old way.

HTTP verbs

The API adheres as closely as possible to standard HTTP and REST conventions in its use of HTTP verbs. Supported operations vary from resource to resource.

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to fully replace an existing resource

PATCH

Used to update an existing resource, including partial updates

DELETE

Used to delete an existing resource

HTTP status codes

The API adheres as closely as possible to standard HTTP and REST conventions in its use of HTTP status codes.

Status code Usage

200 OK

The request completed successfully

201 Created

A new resource has been created successfully. The resource’s URI is available from the response’s Location header

204 No Content

An update to an existing resource has been applied successfully

400 Bad Request

The request was malformed. The response body will include an error providing further information

404 Not Found

The requested resource did not exist

Hypermedia

The API uses hypermedia, and resources include links to other resources in their responses. Responses are in Hypertext Application from resource to resource Language (HAL) format. Links can be found beneath the _links key of retrieved resource.

Note that one of the goals of indirection introduced through hypermedia and links is to handle API changes. Users of the API should not use hardcoded resource URIs, but instead use the above-described links to navigate the API. This way they’ll always receive correct and up-to-date URIs to resources they need.

More information on Hypermedia as the Engine of Application State (HATEOAS) can be found here.

Interpolating URLs

As part of the HAL links spec, the API may return templated URLs. In order to obtain the effective URL, you will need to interpolate values appropriately.

If a link is templated, its templated property will be set to true, for example:

{
  "_links": {
    "video": {
      "href": "https://api.boclips.com/v1/videos/{id}",
      "templated": true
    }
  }
}

Now if you wanted to use that link, you need to interpolate the value of id with the identifier corresponding to your video. If you are implementing a web application, libraries such as URI.js will take care of this for you. Most major web frameworks should support this pattern.

Please keep in mind, some params may be mandatory, whereas others may be optional. Also, although logical names for params will remain consistent to avoid breaking changes, mandatory params may become optional or vice-versa.

For instance you may get a URL that looks like: https://api.boclips.com/v1/resource/{resourceId}?mandatoryParam1={mandatoryParam1}&mandatoryParam2={mandatoryParam2}{&optionalParam}

Which over time could become: https://api.boclips.com/v1/resource/{resourceId}?mandatoryParam={mandatoryParam}{&mandatoryParam2,optionalParam}

This sort of modifications should not break your client.

Errors

Whenever an error response (status code >= 400) is returned, the body will contain a JSON object that describes the problem. The error object has the following structure:

Path Type Description

error

String

The HTTP error that occurred, e.g. Invalid field

message

String

A description of the cause of the error

path

String

The path to which the request was made

status

Number

The HTTP status code, e.g. 400

timestamp

String

The time at which the error occurred

For example, a request that attempts to apply a non-existent tag to a note will produce a 400 Bad Request response:

HTTP/1.1 400 Bad Request
X-Boclips-Trace-ID: fb28793221da03bd
Vary: Origin
Vary: Accept-Encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Type: application/json
content-encoding: gzip
Via: 1.1 google
Alt-Svc: clear
Content-Length: 210

{
  "path" : "/v1/videos",
  "status" : 400,
  "timestamp" : "2021-11-26T18:12:42.123713Z",
  "error" : "Invalid request",
  "message" : "not-quite-a-number is not a valid ISO 8601 duration. Example is PT5S."
}

Cross-Origin Resource Sharing

Any requests to our API originating from within a browser will be subject to CORs restrictions.

If you receive any CORs related errors it is possible the API requests have originated from a domain that has not been whitelisted on our server.

Please contact us with any domains that you expect to call our API from (including protocols and port numbers — if necessary).

Authentication

The Boclips API authorization is based on OpenID Connect (OIDC).

OIDC is an additional layer on top of OAuth 2.0 that enables user information access.

The first step of using Boclips API in your application is obtaining an access token. Depending on the type of integration, we can provide different OAuth grant types.

Boclips will provide you with a client_id and, depending on the integration, a client_secret.

Regardless of how the access token is retrieved, the structure of the response will look like this:

{
  "access_token" : "***",
  "expires_in" : "300",
  "refresh_expires_in" : "604799",
  "refresh_token" : "***",
  "token_type" : "Bearer",
  "not-before-policy" : "1540309427",
  "session_state" : "de8d34f5-2053-4545-9f9f-7f95989876bd",
  "scope" : "profile email"
}
Path Type Description

access_token

String

The OIDC access_token JWT-encoded that can be used to fetch Boclips resources

refresh_token

String

The OIDC refresh_token that can be used to get a new access_token if the current expires

expires_in

String

Expiration of the access_token in seconds

refresh_expires_in

String

Expiration of the refresh_token in millis

scope

String

OIDC claims allowed for this particular access_token

session_state

String

OIDC Session State - only present if the OP supports session management

not-before-policy

String

The instant after which the access_token will become valid as long as it hasn’t expired

token_type

String

OIDC token type must be bearer

Authentication Use Cases

Backend Service Integration

You may want to use Boclips straight from your backend services. In this case the OAuth 2 flow to use should will be client_credentials and Boclips will provide you with your own client_id and client_secret.

All the communication will happen outside of the context of a user in that case, therefore some features like user collections may not be available (See Full user context if user based features are needed).

In order to get an access token using client_credentials we would perform a request:

HTTP request

POST /v1/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1
Host: api.boclips.com

grant_type=client_credentials&client_id=***&client_secret=***

Example request

$ curl 'https://api.boclips.com/v1/token' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1' \
    -d 'grant_type=client_credentials&client_id=***&client_secret=***'

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be client_credentials

client_id

String

false

The client ID that you’ve been issued with

client_secret

String

false

The client secret that was Boclips issued to you

Assuming all the parameters are correct, you will get a valid token response back.

Providing a user identifier for analytics

If you’re planning to use our user based API features, we recommend using Full user context instead.

As mentioned above, backend service integrations happen without the end-user context, but for analytics and billing purposes it may be required to provide an id that will uniquely identify users (even if their true identities remain anonymous to Boclips).

To achieve this, you can manually add a user id to any requests you send to us by including a header:

Boclips-User-Id: [your user id]

Full user context

This feature is still in beta and could potentially change.

Typically the client_credentials flow does not contain a user context due to its machine to machine nature. However, Boclips offers a way for integrations to give this context, which will enable the use of features such as individual user’s collections. This works by generating a unique access token for each user. To achieve this, you can manually add a user id when requesting a token via the client_credentials flow by including a header:

Boclips-User-Id: [your user id]

[your user id] length must be no longer than 64 characters.

That will provide you with access token personalised for the user identified by header. It means you can use this token for all requests that need this user’s context, without any additional headers.

When accessing the API on behalf of another user, you must generate a new token for that user. The user id passed to us must be unique across all of your users.

Using your platform as SSO

You may want to integrate your existing user base with Boclips. If you authenticate your users via an OpenID Connect identity provider (IdP), Boclips API will provide a seamless SSO experience.

Any authenticated user coming from your system will be able to execute calls against Boclips API without having to go through any additional authentication/authorization steps, as Boclips' IdP will query your IdP behind the scenes to verify user identity.

Configuring Identity Federation

This mechanism of different IdPs talking to each other to authenticate users is called identity federation. Setting it up is a matter providing your IdP’s configuration to Boclips authentication server.

Luckily, this information is provided in a well known format that can be easily retrieved and processed by us.

OIDC

OIDC IdPs by convention expose their configuration via a .well-known/openid-configuration endpoint, this mechanism is called OpenID Connect Discovery.

Here you can see how this information looks like for Boclips.

Configuring an OIDC Client

The second configuration step is OIDC client information. We need a list of redirect URIs to know where your users can be securely redirected to after we confirm their identity.

After the client is registered on our side we can share a client_id with you.

Retrieving an Access Token

Once setup is done and access credentials have been exchanged with you, you’ll need to perform an authorization code grant flow to retrieve a Boclips API access token.

This authentication flow works slightly differently depending on whether your application is a server-side application, or a single-page application. Either way, it works roughly as outlined below:

  1. The user’s browser visits your application. The application notices the user is not logged in, so it redirects the browser to our server to be authenticated. The application passes along a callback URL (a redirect URL) as a query parameter in this browser redirect that our server will use when it finishes authentication. Then:

    1. if the user has a session in your domain — we’ll move to the next point,

    2. if the user has no session in your domain we’ll send them to your login page (this needs to be configured on our end).

  2. Given your IdP acknowledges your user, our server authenticates the user and creates a one-time temporary code. Our server redirects back to the application using the callback URL provided earlier and additionally adds this temporary code as a query parameter in the callback URL.

  3. Your application extracts the temporary code and makes a background HTTP request to our authentication server to exchange the code for an identity, access and refresh token. Once this temporary code has been used to obtain the tokens, it can never be used again. This prevents potential replay attacks.

Authenticating mobile applications

Authenticating mobile applications is possible with both options described above.

When working with a backend service integration, your mobile app will simply be calling your backend services which, having access to client secret, will handle authentication themselves.

In the case of an SSO integration, mobile apps can’t guarantee the confidentiality of a client secret and therefore will be using a public client. That implies a flow analogous to the one web applications go through, with some additional security considerations.

We recommend going through this official guide on developing mobile apps authentication with OAuth 2.

Mobile browser usage

The nature of authenticating using a public OAuth client implies the user will have to visit IdP server’s login/authorization page. Mobile apps give you the option of displaying that page either in a custom embedded view, or using a mobile platform’s native browser.

The official security recommendation is to always use the native browser. This allows the user to verify that the page they’re visiting is valid and they will also benefit from shared system cookies.

Proof for Key Code Exchange

If your IdP supports PKCE, it’s worth using it to benefit from an additional layer of security. PKCE protects users from authentication traffic interception attacks.

Sample Requests

Obtaining an Authorization Code:

HTTP request

GET /v1/authorize?response_type=code&client_id=***&redirect_uri=*** HTTP/1.1
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/authorize?response_type=code&client_id=***&redirect_uri=***' -i -X GET

Request parameters

Parameter Type Optional Description

response_type

String - Constant

false

The response type for this flow must always be code

client_id

String

false

The client ID that you’ve been issued with

redirect_uri

URL

false

The URL your user should be redirected to once we managed to authorize her. Typically the root of your webapp. We need to whitelist valid redirect URLs on our end, please let us know where your app will be hosted.

Obtaining an Access Token:

HTTP request

POST /v1/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1
Host: api.boclips.com

grant_type=authorization_code&client_id=***&code=***&redirect_uri=exact-same-url-used-to-request-code

Example request

$ curl 'https://api.boclips.com/v1/token' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1' \
    -d 'grant_type=authorization_code&client_id=***&code=***&redirect_uri=exact-same-url-used-to-request-code'

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be authorization_code

client_id

String

false

The client ID that you’ve been issued with

code

String

false

The client secret that was Boclips issued to you

redirect_uri

String

false

The exact same redirect_uri that was used when requesting the code. Including path and/or params if any.

Refreshing an Access Token

The refresh token enables you to renew an access token periodically without having to authenticate again. The refresh token has an expiration attached to it, but its lifetime is longer than that of an access token.

In order to renew a token using a refresh_token flow you should:

HTTP request

POST /v1/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1
Host: api.boclips.com

grant_type=refresh_token&client_id=***&refresh_token=***

Example request

$ curl 'https://api.boclips.com/v1/token' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded; charset=ISO-8859-1' \
    -d 'grant_type=refresh_token&client_id=***&refresh_token=***'

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be refresh_token

client_id

String

false

The client ID that you’ve been issued with

refresh_token

String

false

The refresh_token that was obtained before

Assuming all the parameters are correct, you will get a valid token response back.

Resources

Boclips API revolves around REST resources that can be accessed and interacted with via hypermedia links.

Index

The index provides the entry point into the service. It returns a set of links that describe which actions are available to you as the API user.

The lists of links that are returned depend on your API subscription tier, so not all of the features described below may be available to you. They’re also dependant on resource states.

The best way to handle the API integration is by assuming that links may come and go and disabling/enabling features as necessary.

Accessing the index

A GET request is used to access the index.

HTTP request

GET /v1/ HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 1b39cf4891beefa6
Vary: Origin
Vary: Accept-Encoding
Content-Type: application/hal+json
content-encoding: gzip
Via: 1.1 google
Alt-Svc: clear
Content-Length: 4495

{
  "_links" : {
    "subjects" : {
      "href" : "https://api.boclips.com/v1/subjects",
      "templated" : false
    },
    "video" : {
      "href" : "https://api.boclips.com/v1/videos/{id}{?referer,shareCode}",
      "templated" : true
    },
    "searchVideos" : {
      "href" : "https://api.boclips.com/v1/videos{?query,id,sort_by,duration,duration_facets,duration_min,duration_max,released_date_from,released_date_to,source,age_range_min,age_range_max,age_range,age_range_facets,size,page,subject,subjects_set_manually,promoted,content_partner,type,channel,resource_types,resource_type_facets,include_channel_facets,prices,category_code}",
      "templated" : true
    },
    "getMetadata" : {
      "href" : "https://api.boclips.com/v1/videos/metadata",
      "templated" : false
    },
    "videoTypes" : {
      "href" : "https://api.boclips.com/v1/video-types",
      "templated" : false
    },
    "discoverCollections" : {
      "href" : "https://api.boclips.com/v1/collections?projection=list&discoverable=true&page=0&size=30{&query,subject,sort_by}",
      "templated" : true
    },
    "promotedCollections" : {
      "href" : "https://api.boclips.com/v1/collections?projection=list&promoted=true&discoverable=true&page=0&size=30",
      "templated" : false
    },
    "searchCollections" : {
      "href" : "https://api.boclips.com/v1/collections{?query,subject,discoverable,projection,page,size,age_range_min,age_range_max,age_range,resource_types,sort_by}",
      "templated" : true
    },
    "collection" : {
      "href" : "https://api.boclips.com/v1/collections/{id}{?referer,shareCode}",
      "templated" : true
    },
    "myCollections" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0/collections?bookmarked=false{&projection,page,size,sort_by}",
      "templated" : true
    },
    "mySavedCollections" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0/collections{?projection,page,size,sort_by}",
      "templated" : true
    },
    "createCollection" : {
      "href" : "https://api.boclips.com/v1/collections",
      "templated" : false
    },
    "createPlaybackEvents" : {
      "href" : "https://api.boclips.com/v1/events/playback/batch",
      "templated" : false
    },
    "createSearchQueryCompletionsSuggestedEvent" : {
      "href" : "https://api.boclips.com/v1/events/suggested-search-completions",
      "templated" : false
    },
    "disciplines" : {
      "href" : "https://api.boclips.com/v1/disciplines",
      "templated" : false
    },
    "tags" : {
      "href" : "https://api.boclips.com/v1/tags",
      "templated" : false
    },
    "suggestions" : {
      "href" : "https://api.boclips.com/v1/suggestions?query={query}",
      "templated" : true
    },
    "videoFeed" : {
      "href" : "https://api.boclips.com/v1/feed/videos{?size}",
      "templated" : true
    },
    "channel" : {
      "href" : "https://api.boclips.com/v1/channels/{id}",
      "templated" : true
    },
    "channels" : {
      "href" : "https://api.boclips.com/v1/channels{?name,projection,sort_by,page,size,categories,ingestType*}",
      "templated" : true
    },
    "contractLegalRestrictions" : {
      "href" : "https://api.boclips.com/v1/contract-legal-restrictions",
      "templated" : false
    },
    "contentCategories" : {
      "href" : "https://api.boclips.com/v1/content-categories",
      "templated" : false
    },
    "activate" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0",
      "templated" : false
    },
    "profile" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0",
      "templated" : false
    },
    "currentUser" : {
      "href" : "https://api.boclips.com/v1/users/_self",
      "templated" : false
    },
    "countries" : {
      "href" : "https://api.boclips.com/v1/countries",
      "templated" : false
    },
    "trackPageRendered" : {
      "href" : "https://api.boclips.com/v1/events/page-render",
      "templated" : false
    },
    "trackPlatformInteractedWith" : {
      "href" : "https://api.boclips.com/v1/events/platform-interaction{?subtype,anonymous}",
      "templated" : true
    },
    "validateShareCode" : {
      "href" : "https://api.boclips.com/v1/users/{id}/shareCode/{shareCode}",
      "templated" : true
    },
    "isUserActive" : {
      "href" : "https://api.boclips.com/v1/users/{id}/active",
      "templated" : true
    }
  }
}
Relation Description

trackPageRendered

POST endpoint for tracking pageRendered event

trackPlatformInteractedWith

POST endpoint for tracking a platform interaction event

createPlaybackEvents

Sending batches of playback events from the past

createSearchQueryCompletionsSuggestedEvent

POST endpoint for tracking search completions suggested event

activate

A PUT request against this link allows to pass profile information and activate a new user

profile

Templated link to get user profile information

currentUser

Get the current user’s profile

video

The video resource, templated link to retrieve an individual video

searchVideos

Templated link to perform video search

videoFeed

A feed of videos for deep pagination

videoTypes

Lists types of videos available in the system. These can be later used when searching

tags

List of tags that can be attached to videos

createCollection

Link to create a new video collection

myCollections

Collections created by the current user

mySavedCollections

Collections created or bookmarked by the current user

discoverCollections

Collections that have been curated by Boclips and are considered a great starting point for exploration.

promotedCollections

Collections that are promoted, e.g. on a homepage.

searchCollections

Search all collections

collection

The collection resource, templated link to retrieve an individual video collection

subjects

List of subjects available

disciplines

List of disciplines available in the system (e.g. arts, humanities…​)

countries

List of countries

channel

Retrieve a specific channel

channels

Retrieve all channels

contentCategories

Retrieve a list of content categories

validateShareCode

Validate a share code for a given user

isUserActive

Check whether given user is active

Events

Boclips API supports events. They can be published using standard REST calls and are later used for analytics and reporting purposes.

Playback events

The most important type of Boclips events are playback events as they allow us to track video usage for billing purposes.

Sending single playback event

If you’re using our web player, it will publish these events for you automatically, no extra work required.

If, however, you need to use a custom player, then you’ll need to publish those events yourself. Each video playback contains a createPlaybackEvent link that you can use to POST data to our events endpoint.

To accommodate for cases where user closes the app before a playback event can be submitted, playback events can be split into smaller chunks and uploaded one by one.

Request fields
Path Type Optional Description

videoId

String

false

ID of the video

segmentStartSeconds

Number

false

Second the video started its playback

segmentEndSeconds

Number

false

Second the video ended its playback

userId

String

true

ID of the user who initiated the playback
HTTP request
POST /v1/events/playback HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json; charset=UTF-8
Host: api.boclips.com
Content-Length: 153

{
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "userId" : "f0e8d794-1d7e-4944-9705-e16946c7b694"
}
Example request
$ curl 'https://api.boclips.com/v1/events/playback' -i -X POST \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "userId" : "f0e8d794-1d7e-4944-9705-e16946c7b694"
}'
Example response
HTTP/1.1 201 Created
X-Boclips-Trace-ID: fb59cdba3b86832c
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: clear

Sending a batch of playback events

If you’re using a custom video player, and you prefer to send a batch of playback events you can do so with the correct permissions.

The batch events endpoint can be found under the createPlaybackEvents link of the API index.

As the batch upload of events happens in retrospect, you must include the captureTime of video property in POST request. This property describes when the event occurred (not when the batch upload is issued). Also note that the limit on the number of playback events per request is 500, but there is no limit on the number of batches you can send.

The captureTime represents an ISO 8601 formatted string including year, month, day, hour, second, nanosecond and time zone. For example: 1997-07-16T19:20:30.45+01:00.

Request fields
Path Type Optional Description

[*].videoId

String

false

ID of the video

[*].segmentStartSeconds

Number

false

Second the video started its playback

[*].segmentEndSeconds

Number

false

Second the video ended its playback

[*].captureTime

ISO-8601 (YYYY-MM-DDThh:mm:ss.sTZD)

false

Time when playback event was fired

[*].userId

String

true

ID of the user who initiated the playback
HTTP request
POST /v1/events/playback/batch HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json; charset=UTF-8
Host: api.boclips.com
Content-Length: 412

[ {
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "captureTime" : "1997-07-16T19:20:30.45+01:00",
  "userId" : "05c4b56f-1ca2-42ac-b992-2b254584ea29"
}, {
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "captureTime" : "1997-07-16T19:20:30.45+01:00",
  "userId" : "b51a69eb-6977-4766-9f76-7b1b7dc0b953"
} ]
Example request
$ curl 'https://api.boclips.com/v1/events/playback/batch' -i -X POST \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '[ {
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "captureTime" : "1997-07-16T19:20:30.45+01:00",
  "userId" : "05c4b56f-1ca2-42ac-b992-2b254584ea29"
}, {
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "captureTime" : "1997-07-16T19:20:30.45+01:00",
  "userId" : "b51a69eb-6977-4766-9f76-7b1b7dc0b953"
} ]'
Example response
HTTP/1.1 201 Created
X-Boclips-Trace-ID: b941fdd6fc5320bd
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: clear

Users

The user resource describes a user of the API. Specifically, the user profile can be interacted with, and that user profile contains metadata about the user.

User profile

A user profile contains metadata about the user of the API, and can be both inspected (with a GET request) and edited (with a PUT request).

Search results customization

One of the properties that are stored on the user profile are their subjects. Videos that match user’s subjects will have higher score, therefore will be listed higher in search results than videos that don’t.

Fetching

User profile can be fetched by profile hypermedia link.

HTTP request
GET /v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3' -i -X GET \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 200 OK
X-Boclips-Trace-ID: ff52418ce7042455
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 461

{
  "id" : "0690f7ee-d38f-48c5-863c-ea39bfdbc5d3",
  "firstName" : "John",
  "lastName" : "Smith",
  "ages" : [ 7, 8, 9 ],
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454b"
  } ],
  "email" : "updatable@user.com",
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3"
    },
    "profile" : {
      "href" : "https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3"
    }
  }
}
Response fields
Path Type Description

id

String

The ID of the user

firstName

String

The first name of the user

lastName

String

The user’s last name

ages

Array

The student ages taught by the user

subjects

Array

Ids of teaching subjects relevant for this user. They influence search results

email

String

The email of the user

_links

Object

HAL links related to this collection

Updating

User profile can be updated by profile hypermedia link.

HTTP request
PUT /v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3 HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json; charset=UTF-8
Host: api.boclips.com
Content-Length: 160

{
  "firstName" : "John",
  "lastName" : "Smith",
  "subjects" : [ "5cb499c9fd5beb428189454b" ],
  "ages" : [ 7, 8, 9 ],
  "country" : "USA",
  "state" : "AZ"
}
Example request
$ curl 'https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3' -i -X PUT \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "firstName" : "John",
  "lastName" : "Smith",
  "subjects" : [ "5cb499c9fd5beb428189454b" ],
  "ages" : [ 7, 8, 9 ],
  "country" : "USA",
  "state" : "AZ"
}'
Request fields
Path Type Optional Description

firstName

String

true

The first name of the user

lastName

String

true

The user’s last name

subjects

Array

true

Ids of teaching subjects relevant for this user. They influence search results

ages

Array

true

The student ages taught by the user

country

String

true

The country of the user (3-letter ISO Country Code)

state

String

true

The US state of the user (2-letter ISO Code)
Example response
HTTP/1.1 200 OK
X-Boclips-Trace-ID: 7c7f9bdfc672ecfe
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 461

{
  "id" : "0690f7ee-d38f-48c5-863c-ea39bfdbc5d3",
  "firstName" : "John",
  "lastName" : "Smith",
  "ages" : [ 7, 8, 9 ],
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454b"
  } ],
  "email" : "updatable@user.com",
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3"
    },
    "profile" : {
      "href" : "https://api.boclips.com/v1/users/0690f7ee-d38f-48c5-863c-ea39bfdbc5d3"
    }
  }
}

Videos

The videos resource contains metadata about a Boclips video asset. This includes basic metadata as well as streaming details.

Accessing a single video

A GET request against the video link will return an individual video as long as its id is interpolated following the provided template under links.

Path parameters

Table 1. /v1/videos/{id}
Parameter Description

id

The ID of the video asset

HTTP request

GET /v1/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 1d548af73bc0789
Vary: Origin
Vary: Accept-Encoding
Vary: origin,access-control-request-method,access-control-request-headers,accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 2960

{
  "id" : "5c542abf5438cdbcb56df0bf",
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "additionalDescription" : null,
  "releasedOn" : "2017-05-30",
  "updatedAt" : "2021-11-23T13:32:24.250858Z",
  "playback" : {
    "type" : "STREAM",
    "id" : "1_e72xmbcb",
    "duration" : "PT1M14S",
    "_links" : {
      "createPlaybackEvent" : {
        "href" : "https://api.boclips.com/v1/events/playback",
        "templated" : false
      },
      "createPlayerInteractedWithEvent" : {
        "href" : "https://api.boclips.com/v1/events/player-interaction",
        "templated" : false
      },
      "thumbnail" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
        "templated" : true
      },
      "videoPreview" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
        "templated" : true
      },
      "hlsStream" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
        "templated" : false
      }
    }
  },
  "subjects" : [ {
    "id" : "5e70ae4b7cdd5a3b586cb8ea",
    "name" : "Art"
  } ],
  "badges" : [ "ad-free" ],
  "legalRestrictions" : "",
  "ageRange" : {
    "min" : 12,
    "max" : 12,
    "label" : "12-12"
  },
  "rating" : 2.0,
  "yourRating" : null,
  "bestFor" : [ ],
  "createdBy" : "Natcom Global",
  "promoted" : false,
  "language" : {
    "code" : "eng",
    "displayName" : "English"
  },
  "attachments" : [ ],
  "contentWarnings" : [ ],
  "keywords" : [ "screen", "genetic testing", "HD_111314_EN", "asked", "patient", "assess", "doctor", "readers", "risk", "genetics DNA", "family history", "recommend", "cancer", "potential", "doctors", "case", "asymptomatic", "news" ],
  "type" : "INSTRUCTIONAL",
  "availability" : {
    "availableUntil" : "2022-01-31"
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf",
      "templated" : false
    },
    "logInteraction" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
      "templated" : true
    },
    "rate" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
      "templated" : true
    },
    "tag" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/tags",
      "templated" : false
    },
    "transcript" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

id

String

The unique identifier for this video, can be interpolated in templated links

title

String

Human readable title for this video

description

String

Description detailing what this video talks about

additionalDescription

Null

Deprecated we are planning to drop support for this field. Additional information to help improve the metadata

releasedOn

String

Date on which the video was originally released as stated by the content producer

updatedAt

String

Date when the most recent update occured

subjects

Array

Tagged Subject resources for this video. See subject resource for payload details

badges

Array

Tagged badges for this video. E.g. ad-free or Youtube

rating

Number

Deprecated we are planning to drop support for this field. Score of this video based on user rating. From 0 to 5

yourRating

Null

Deprecated we are planning to drop support for this field. Score you gave to this video. From 0 to 5

bestFor

Array

Most appropriate use for this video

promoted

Boolean

Promoted status of this video

type

String

Content type of this video

playback

Object

Video Playback resource. See playback for payload details

attachments

Array

List of resources attached to the video to help use the video in the classroom

legalRestrictions

String

Legal restrictions for this particular video if any

contentWarnings

Array

Content warnings for this particular video if any

ageRange.label

String

Age range in a human readable format

ageRange.min

Number

Minimum of age range for this video

ageRange.max

Number

Maximum of age range for this video

language.code

String

The language of the video in the format of the ISO 639-2 standard

language.displayName

String

The language of the video in a human readable format (e.g English)

createdBy

String

Who provided the video

availability.availableUntil

ISO-8601 (YYYY-MM-DD)

If provided, the video will be only available until this date.

_links

Object

HAL links for this resource

Response fields-playback

Path Type Description

type

String

Playback type, i.e. STREAM or YOUTUBE

id

String

Id of this playback, useful for YOUTUBE type

duration

String

Duration of this particular video in ISO-8601

_links.createPlaybackEvent.href

String

POST endpoint for a createPlaybackEvent. See more on events here

_links.createPlayerInteractedWithEvent.href

String

POST endpoint for a createPlayerInteractedWithEvent

_links.thumbnail.href

String

Thumbnail URL for the video. May be templated with thumbnailWidth

_links.thumbnail.templated

Boolean

Tells whether the thumbnail link is templated

_links.videoPreview.href

String

VideoPreview URL for the video. Templated with thumbnailWidth, and thumbnailCount

_links.hlsStream.href

String

URL for the Apple HLS stream
Relation Description

self

The video resource that was just retrieved

logInteraction

POST request to this URL will log user’s interaction with this video

rate

PATCH request to this URL will give this video a rating

tag

PATCH request to this URL will tag this video

transcript

GET to fetch transcripts of video

A GET request against the search link will return a collection of videos. Videos can be filtered using the criteria provided under the templated search link.

If the API user has subjects associated with their account, i.e. "Mathematics", the search will be weighted to prefer videos with those same subjects.

Request parameters

Parameter Type Optional Description

size

Number

true

The number of videos per page, 100 by default

page

Number

true

Zero-index based page number, first page by default

query

String

true

The text search query

duration

Range of ISO-8601 (PT6M5S)

true

Filters on the video duration property. Provide duration ranges in the form min[-max], ie PT1M-PT6M. These ranges are inclusive. This property supersedes the duration_min and duration_max properties.

duration_min

ISO-8601 (PT6M5S)

true

Filters on the video duration property, this range is inclusive

duration_max

ISO-8601 (PT30S)

true

Filters on the video duration property, this range is inclusive

released_date_from

ISO-8601 (YYYY-MM-DD)

true

Filters on the video releasedOn property, this range is inclusive

released_date_to

ISO-8601 (YYYY-MM-DD)

true

Filters on the video releasedOn property, this range is inclusive

updated_as_of

ISO-8601 (YYYY-MM-DD)

true

Filters on the video updatedAt property, this range is inclusive

source

YOUTUBE, BOCLIPS

true

Filter by video source, e.g youtube or boclips

subject

Subject Id (e.g. '5cb499c9fd5beb428189454b')

true

Filter by subject id - from the list of subjects

age_range_min

Number

true

Minimum age to filter from - it filters on the video age range property, and is inclusive. See filter by age for more details.

age_range_max

Number

true

Maximum age to filter to - it filters on the video age range property, and is inclusive. See filter by age for more details.

age_range

String

true

Filter videos which cover at least 2 ages from a range in the video age range property. Provide age ranges in the form lowerAge-upperAge, ie 5-7. See filter by age for more details.

duration_facets

Range of ISO-8601 (PT6M5S), e.g. PT0S-PT5M.

true

Override default facets for durations, see search facets.

age_range_facets

String, e.g. 3-5

true

Override default facets for age ranges, see search facets.

promoted

Boolean

true

Filter by promoted videos only

content_partner

String (e.g. 'Bloomberg')

true

Deprecated in favour of channel. Filter by content partner, which is the provider of the video content. Use multiple times to search for multiple values, e.g. 'content_partner=first&content_partner=second'.

channel

String (e.g. '5d77b49698cfe500017e9856')

true

Filter by channel IDs (channel is the provider of the video content). Use multiple times to search for multiple values, e.g. 'channel=5d5432448256f68bdcf75d53&channel=5d77b49698cfe500017e9856'. Deprecated: filtering by channel names (it is still available, but will be removed anytime soon).

type

Enum

true

Filter responses by video type

best_for

List of strings (e.g 'explainer')

true

Filter responses by tag labels, exact matches when specifying multiple tags

sort_by

RELEASE_DATE, RATING

true

A key to sort the results by, currently only release_date and rating are supported. This only sorts in a descending direction

id

Video ID (e.g '5cd9627d6c2905689d1c150c'

true

Filter by video ids, this can be a comma separated list of video ids

HTTP request

GET /v1/videos?query=genetic&sort_by=RELEASE_DATE&duration_min=PT1M&duration_max=PT3M&released_date_from=2018-01-01&released_date_to=2019-06-01&source=boclips&size=1&page=0&type=NEWS&channel=5cf140c4c1475c47f7178679 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/videos?query=genetic&sort_by=RELEASE_DATE&duration_min=PT1M&duration_max=PT3M&released_date_from=2018-01-01&released_date_to=2019-06-01&source=boclips&size=1&page=0&type=NEWS&channel=5cf140c4c1475c47f7178679' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 170078d7dc45697a
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 5415

{
  "_embedded" : {
    "videos" : [ {
      "id" : "5cb4c9e4fd5beb42818945a2",
      "title" : "Twins study explores space and genetic frontier",
      "description" : "RESTRICTION SUMMARY: AP CLIENTS ONLY",
      "additionalDescription" : null,
      "releasedOn" : "2019-04-12",
      "updatedAt" : "2021-11-26T18:12:17.422917Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_9kry7wp3",
        "duration" : "PT2M11S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_9kry7wp3/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_9kry7wp3/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_9kry7wp3/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189455d",
        "name" : "Fine Art"
      }, {
        "id" : "5cb499c9fd5beb428189454c",
        "name" : "3Arabic"
      }, {
        "id" : "5cb499c9fd5beb428189454f",
        "name" : "Design"
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Colorado", "United States government", "Science", "Medical research", "Continent", "Aerospace and defense industry", "POLITICIAN", "North America", "PERSON", "Health", "Space exploration", "Nation", "City", "Space industry", "Genomics", "United States", "National Aeronautics and Space Administration", "Fort Collins", "State", "Scott J. Kelly", "Mark Kelly", "Barack Obama", "Biology", "Industrial products and services", "Business", "Colorado State University", "NEWSMAKER", "Genetics" ],
      "type" : "NEWS",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/5cb4c9e4fd5beb42818945a2",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/5cb4c9e4fd5beb42818945a2/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/5cb4c9e4fd5beb42818945a2?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/5cb4c9e4fd5beb42818945a2/tags",
          "templated" : false
        }
      }
    } ],
    "facets" : {
      "subjects" : {
        "5cb499c9fd5beb428189454c" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454c",
          "name" : "3Arabic"
        },
        "5cb499c9fd5beb428189454f" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454f",
          "name" : "Design"
        },
        "5cb499c9fd5beb428189455d" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189455d",
          "name" : "Fine Art"
        }
      },
      "ageRanges" : {
        "3-5" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        },
        "5-9" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        },
        "9-11" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        },
        "11-14" : {
          "hits" : 10,
          "id" : null,
          "name" : null
        },
        "14-16" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        },
        "16-99" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        }
      },
      "durations" : {
        "PT0S-PT2M" : {
          "hits" : 3,
          "id" : null,
          "name" : null
        },
        "PT2M-PT5M" : {
          "hits" : 14,
          "id" : null,
          "name" : null
        },
        "PT5M-PT10M" : {
          "hits" : 2,
          "id" : null,
          "name" : null
        },
        "PT10M-PT20M" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        },
        "PT20M-PT24H" : {
          "hits" : 0,
          "id" : null,
          "name" : null
        }
      },
      "resourceTypes" : { },
      "videoTypes" : {
        "NEWS" : {
          "hits" : 10,
          "id" : null,
          "name" : null
        }
      },
      "channels" : { },
      "prices" : { }
    }
  },
  "page" : {
    "size" : 1,
    "totalElements" : 10,
    "totalPages" : 10,
    "number" : 0
  }
}

Response fields

Path Type Description

_embedded.videos

Array

Video resources array. See video for payload details

_embedded.facets

Object

Search facets for age ranges, durations and subjects

page.size

Number

Amount of resources in the current page

page.totalElements

Number

Total amount of resources for this search query across pages

page.totalPages

Number

Total amount of pages for this search query

page.number

Number

Number of the current page. Zero-index based

Filtering by ages

We provide two ways of filtering videos by ages.

  1. Using age_range_min and age_range_max you apply a strict filter. We return videos which are only suitable to ages ≥ age_range_min and ≤ age_range_max.

  2. Using age_range you can apply a relaxed filter, where we return all videos which are suitable for at least 2 ages from the provided age_range.

Video age range Search with filter: age_range_min=3&age_range_max=5 Search with filter: age_range=3-5

3 - 16

no match, has age > max 5

match

3-5

match

match

2 - 3

no match, has age < min

no match, only matches age 3, we need at least two matching ages

2 - 15

no match, has age < min and age > max

match

Search facets

This is a BETA feature. Whilst we don’t anticipate major changes, we cannot guarantee backward compatibility at this stage.

Search facets expose hit counts for specific "buckets", namely subjects, age ranges and durations. Facets can substantially improve the search experience of users.

We provide default search facets out of the box. By setting the age_range_facets and duration_facets parameters, you can adapt the facets to meet your needs.

Age Range Defaults (in years): 3-5, 5-9, 9-11, 11-14, 14-16, 16-99

Age Range buckets will show the counts for videos which are suitable for at least 2 ages in that range. For example a video which has ageRange: {min: 4, max: 10} would be counted in these buckets: 3-5, 5-9, 9-11.

Durations Defaults (in seconds): 0-120, 120-300, 300-600, 600-1200, 1200-86400

Video types

Video types available in the system can be listed using the videoTypes link.

HTTP request

GET /v1/video-types HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/video-types' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: c4e76924ccb33fc7
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 81

{
  "_embedded" : {
    "videoTypes" : [ "INSTRUCTIONAL", "NEWS", "STOCK" ]
  }
}

Response fields

Path Type Description

_embedded.videoTypes

Array

Video types available in the system

Video Feed

This is a BETA feature. Whilst we don’t anticipate major changes, we cannot guarantee backward compatibility at this stage.

Sometimes you may want to ingest all videos in the Boclips offering to enrich with your own metadata. Currently, video search is optimised for quick reads and limits the maximum window, so you can’t request a page deeper than 10000 results. A GET request to videoFeed will allow you to page through all the videos.

Request parameters

Parameter Type Optional Description

size

Number

true

The number of videos per page, 1000 by default and is also the max size

cursor_id

String

true

This is set explicitly in the next link and you should never have to set it

updated_as_of

ISO-8601 (YYYY-MM-DD)

true

Filters on the video updatedAt property, this range is inclusive

HTTP request

GET /v1/feed/videos?size=10 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/feed/videos?size=10' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 36f4c62ad4a3c184
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 40092

{
  "_embedded" : {
    "videos" : [ {
      "id" : "619a2b6b1baa1f68c5a6fca6",
      "title" : "تعليم اسماء الخضروات للأطفال مع ليلى | مطبخ ليلى تعلم اسماء الخضر باللغة العربية مطبخ الأطفال",
      "description" : "هيا نتعلم معا أسماء الخضروات مع ليلى بطريقة ممتعة وفريدة من نوعها.\n\nسنتعلم أسماء الخضروات التالية:\nخَسّ\nجَزَر\nفِلفِل\nبَاذِنْجَان\nطَمَاطِم\nبَطَاطَا\nذُرَة\nبرُوكلِي\nبَصَل\nبَازِيلاَء\nيَقْطِين\nلِفْت\nخِيَار\nفِجْل\nفِطْر\nثَوْم\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-11-21",
      "updatedAt" : "2021-11-21T11:20:11.668704Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "Xv7CM_Va3Fc",
        "duration" : "PT4M48S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/Xv7CM_Va3Fc/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "Xv7CM_Va3Fc",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/619a2b6b1baa1f68c5a6fca6",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/619a2b6b1baa1f68c5a6fca6/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/619a2b6b1baa1f68c5a6fca6?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/619a2b6b1baa1f68c5a6fca6/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6197d1334af60a3fd81a3e10",
      "title" : "mp3 test 2",
      "description" : "mp3 test 2",
      "additionalDescription" : null,
      "releasedOn" : "2021-11-19",
      "updatedAt" : "2021-11-19T16:30:43.897135Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_uvciuo74",
        "duration" : "PT4M13S",
        "referenceId" : "a97d27d5-c4ce-440e-b423-7a349724f5a2",
        "maxResolutionAvailable" : true,
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_uvciuo74/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_uvciuo74/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_uvciuo74/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 14,
        "max" : null,
        "label" : "14+"
      },
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Audio Productions",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "mp3 test 2" ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Audio Productions",
      "channelId" : "5cfea84d8ce44c52e6e33e5a",
      "channelVideoId" : "mp3 test 2",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6197d1334af60a3fd81a3e10",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6197d1334af60a3fd81a3e10/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6197d1334af60a3fd81a3e10?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6197d1334af60a3fd81a3e10/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6197bd074af60a3fd81a3e00",
      "title" : "mp3 test",
      "description" : "mp3 test",
      "additionalDescription" : null,
      "releasedOn" : "2021-11-19",
      "updatedAt" : "2021-11-19T15:04:39.405965Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_5xfwpy7d",
        "duration" : "PT12M9S",
        "referenceId" : "45d44651-b69a-4b7e-9fc5-6f812b7df695",
        "maxResolutionAvailable" : true,
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_5xfwpy7d/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_5xfwpy7d/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_5xfwpy7d/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 14,
        "max" : null,
        "label" : "14+"
      },
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Audio Productions",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "mp3 test" ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Audio Productions",
      "channelId" : "5cfea84d8ce44c52e6e33e5a",
      "channelVideoId" : "mp3 test",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6197bd074af60a3fd81a3e00",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6197bd074af60a3fd81a3e00/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6197bd074af60a3fd81a3e00?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6197bd074af60a3fd81a3e00/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6190f0fa8d13ba39edf14864",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ٨) - الألوان | تعلم أفراد الأسرة باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال أفراد الأسرة  بطريقة ممتعة.\n\nموضوع اليوم: الألوان \n\nسيتعلم الأطفال الكلمات أو اسماء الألوان  التالية:\nبُرْتُقَالِي\nأخْضَر\nأزْرَق\nأسْوَد\nأَحْمَر\nأبْيَض\nبُنِّي\nأصْفَر\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-11-14",
      "updatedAt" : "2021-11-21T00:06:51.394355Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "osmM2YAf4UQ",
        "duration" : "PT3M23S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/osmM2YAf4UQ/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "osmM2YAf4UQ",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6190f0fa8d13ba39edf14864",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6190f0fa8d13ba39edf14864/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6190f0fa8d13ba39edf14864?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6190f0fa8d13ba39edf14864/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6187b68747c59f7a9e400a0e",
      "title" : "لعبة الذاكرة (الحلقة ١٤)  - ألوان السيارات، لعبة البطاقات لكل العائلة – تعلم مع زكريا",
      "description" : "هيا نلعب معا لعبة الذاكرة (لعبة البطاقات) مع هذا الكرتون، الذي سوف يحفز ذاكرة الأطفال بطريقة ممتعة.\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-11-07",
      "updatedAt" : "2021-11-21T00:06:51.362377Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "RfoE2d807V4",
        "duration" : "PT3M30S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/RfoE2d807V4/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "RfoE2d807V4",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6187b68747c59f7a9e400a0e",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6187b68747c59f7a9e400a0e/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6187b68747c59f7a9e400a0e?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6187b68747c59f7a9e400a0e/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6175418203662614cc95d4ab",
      "title" : "كيفية تحضير عصير الفراولة | مطبخ ليلى الحلقة (١) - تعلم الطبخ للأطفال مع ليلى وزكريا",
      "description" : "هيا نتعلم معا كيفية تحضير عصير الفراولة مع ليلى وزكريا بطريقة ممتعة وفريدة من نوعها.\n\nبدون مزيد من الإنتظار، دعونا نتعرف على المكونات التي نحتاجها لوصفة اليوم:\n٤٠٠غ من الفراولة\n١/٢ كوب من حليب اللوز\nكوب من اليوغرت\nملعقة واحدة من العسل\nملعقتان من مستخلص الفانيلا\n٤ مكعبات ثلج\n\nطريقة التحضير:\nأولا، نضع الفراولة داخل الخلاط الكهربائي.\nنأخذ كوب اليوغرت ونضيفه إلى الخليط\nثم نضيف ملعقة واحدة… من العسل\nبعدها نضيف ١/٢ كوب من حليب اللوز الشهي والصحي\nلاننسى إضافة ملعقتان... من مستخلص الفانيلا\nوأخيرا… نضيف ٤ مكعبات ثلج للخليط بهذه الطريقة\nقبل استعمال الأجهزة الكهربائية وغيرها من الأجهزة التي تشكل خطرا على الأطفال، نطلب المساعدة من أمي أو آبي!\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-10-24",
      "updatedAt" : "2021-11-21T00:06:51.335736Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "ful4kfeq9J8",
        "duration" : "PT2M54S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/ful4kfeq9J8/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "ful4kfeq9J8",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6175418203662614cc95d4ab",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6175418203662614cc95d4ab/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6175418203662614cc95d4ab?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6175418203662614cc95d4ab/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "616c06f5a4ee5e60bf5fd34c",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ٧) - أفراد الأسرة | تعلم أفراد الأسرة باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال أفراد الأسرة  بطريقة ممتعة.\n\nموضوع اليوم: أفراد العائلة \n\nسيتعلم الأطفال الكلمات أو اسماء أفراد الأسرة  التالية:\nأبي\nآمّي\nأخي\nأختي\nجدّي\nجدّتي\nعمّي\nعمّتي\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-10-17",
      "updatedAt" : "2021-11-21T00:06:51.31086Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "ir1n9rqYp3U",
        "duration" : "PT3M23S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/ir1n9rqYp3U/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "ir1n9rqYp3U",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/616c06f5a4ee5e60bf5fd34c",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/616c06f5a4ee5e60bf5fd34c/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/616c06f5a4ee5e60bf5fd34c?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/616c06f5a4ee5e60bf5fd34c/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "615991f6eb5b906d8b0abdb1",
      "title" : "لعبة الذاكرة (الحلقة ١٣)  - في المطبخ، لعبة البطاقات لكل العائلة – تعلم مع زكريا",
      "description" : "هيا نلعب معا لعبة الذاكرة (لعبة البطاقات) مع هذا الكرتون، الذي سوف يحفز ذاكرة الأطفال بطريقة ممتعة.\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-10-03",
      "updatedAt" : "2021-11-21T00:06:51.274663Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "opvOPryvXqc",
        "duration" : "PT3M30S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/opvOPryvXqc/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "opvOPryvXqc",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/615991f6eb5b906d8b0abdb1",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/615991f6eb5b906d8b0abdb1/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/615991f6eb5b906d8b0abdb1?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/615991f6eb5b906d8b0abdb1/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "6150579d5280f51deecfa1b2",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ٦)  - حيوانات البحر، تعلم الكلمات باللغة العربية – تعلم مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سوف يحفز ذاكرة الأطفال بطريقة ممتعة.\n\nموضوع اليوم: حيوانات البحر\n\nسيتعلم الأطفال الكلمات أو اسماء الحيوانات التالية:\nسَرَطَانُ البَحْر\nدَلْفِين\nنَجْمَةُ البَحْر\nأخْطُبُوط\nسُلَحْفَاةُ البَحْر\nحِصَانُ البَحْر\nقِرْش\nحُوت\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-09-26",
      "updatedAt" : "2021-11-21T00:06:51.242777Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "xCpl5iquXvU",
        "duration" : "PT3M23S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/xCpl5iquXvU/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "xCpl5iquXvU",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6150579d5280f51deecfa1b2",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6150579d5280f51deecfa1b2/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6150579d5280f51deecfa1b2?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/6150579d5280f51deecfa1b2/tags",
          "templated" : false
        }
      }
    }, {
      "id" : "61471ce7d4b7da18b32aff98",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ٥)  - الأدوات المدرسية، تعلم أسماء الخضر الكلمات باللغة العربية",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سوف يحفز ذاكرة الأطفال بطريقة ممتعة.\n\nموضوع اليوم: الأدوات المدرسية\n\nسيتعلم الأطفال الكلمات أو اسماء الحيوانات التالية:\nقَلَمُ رَصَاص\nمِسْطَرَة\nدَفْتَر\nمِمْحَاة\nحَقِيبَةٌ مَدْرَسِيَّة\nمِقَصّ\nكُرَّاس\nقَلَمُ حِبْر\nمِقْلَمَة\nكِتَاب\nكُوس\nمِبْرَاة\nسَبُّورَة\nفُرْشَاةُ رَسْم\nمِنْقَلَة\nمِدْوَر\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2021-09-19",
      "updatedAt" : "2021-11-21T00:06:51.214162Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "h-MExv917e8",
        "duration" : "PT5M30S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/h-MExv917e8/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "price" : null,
      "channel" : "Learn with Zakaria - تعلم مع زكريا",
      "channelId" : "5fb698eb92a64c0e7b324d44",
      "channelVideoId" : "h-MExv917e8",
      "types" : [ {
        "id" : 3,
        "name" : "Instructional Clips"
      } ],
      "captionStatus" : null,
      "isVoiced" : null,
      "taxonomy" : {
        "channel" : {
          "categories" : [ ]
        },
        "manual" : {
          "categories" : [ ]
        }
      },
      "transcriptRequested" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/61471ce7d4b7da18b32aff98",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/61471ce7d4b7da18b32aff98/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/61471ce7d4b7da18b32aff98?rating={rating}",
          "templated" : true
        },
        "tag" : {
          "href" : "https://api.boclips.com/v1/videos/61471ce7d4b7da18b32aff98/tags",
          "templated" : false
        }
      }
    } ]
  },
  "_links" : {
    "next" : {
      "href" : "https://api.boclips.com/v1/feed/videos?cursor_id=FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZldGNoBRRaNDF6WFgwQnFrdU5rQUNxSy1NSgAAAAAAAdcnFk1nc2hJQXdxUS1TS2xyOHV2cDJJaFEUZnZaelhYMEJZeXN4TXZSMEtfNEsAAAAAAAHW7BZ0MGJ0ZWs0MVRTeVgyTElBaWdVbmR3FGFJMXpYWDBCcWt1TmtBQ3FLLU1KAAAAAAAB1ygWTWdzaElBd3FRLVNLbHI4dXZwMkloURRmX1p6WFgwQll5c3hNdlIwS180SwAAAAAAAdbtFnQwYnRlazQxVFN5WDJMSUFpZ1VuZHcUYVkxelhYMEJxa3VOa0FDcUstTUoAAAAAAAHXKRZNZ3NoSUF3cVEtU0tscjh1dnAySWhR&size=10",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

_embedded.videos

Array

Video resources array. See video for payload details

_links

Object

HAL links related to this collection
Relation Description

next

The link to the next page of videos. This will only be valid for 5 minutes, also this will not be present once you have got to the end of results.

Caveats

  • The maximum page size is 1000 results. Any larger will result in a 400 returned.

  • We keep the context of the feed request alive for 5 minutes, which is reset after any request with the same cursor_id. This means after a request you have 5 minutes to make another request to fetch the next page of results or the context will timeout and a 400 is returned

  • The end of results is given by returning an empty list of videos and no next link is returned

  • Making the request twice with the same cursor_id is essentially the same as following the next link

Collections

Collections enable grouping related videos together and have some additional metadata that describes their content. They are searchable, can be edited and bookmarked.

Creating a collection

Collections can be created by issuing a POST request to createCollection link. Input parameters are provided via a JSON payload.

Upon success, the API will respond with a 201 status and provide a link to the newly created collection under a Location response header.

Request fields

Path Type Optional Description

title

String

false

Collection’s title

description

String

true

Collection’s description

videos

Array

true

A list of IDs of videos that should belong to this collection

subjects

Array

true

A list of IDs of subjects that should belong to this collection

HTTP request

POST /v1/collections HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json; charset=UTF-8
Host: api.boclips.com
Content-Length: 386

{
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "videos" : [ "5c542abf5438cdbcb56df0bf", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454e" ],
  "discoverable" : true
}

Example request

$ curl 'https://api.boclips.com/v1/collections' -i -X POST \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "videos" : [ "5c542abf5438cdbcb56df0bf", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454e" ],
  "discoverable" : true
}'

Example response

HTTP/1.1 201 Created
X-Boclips-Trace-ID: 5a1ea3e219bf53cd
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
Location: https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 7488

{
  "id" : "61a1238cfa44197e97de9186",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "title" : "Genetic Screening Debate",
  "videos" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "title" : "Genetic Screening Debate",
    "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
    "additionalDescription" : null,
    "releasedOn" : "2017-05-30",
    "updatedAt" : "2021-11-23T13:32:24.250858Z",
    "playback" : {
      "type" : "STREAM",
      "id" : "1_e72xmbcb",
      "duration" : "PT1M14S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
          "templated" : true
        },
        "videoPreview" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
          "templated" : true
        },
        "hlsStream" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5e70ae4b7cdd5a3b586cb8ea",
      "name" : "Art"
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "rating" : 2.0,
    "yourRating" : null,
    "bestFor" : [ ],
    "createdBy" : "Natcom Global",
    "promoted" : false,
    "language" : {
      "code" : "eng",
      "displayName" : "English"
    },
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ "screen", "genetic testing", "HD_111314_EN", "asked", "patient", "assess", "doctor", "readers", "risk", "genetics DNA", "family history", "recommend", "cancer", "potential", "doctors", "case", "asymptomatic", "news" ],
    "type" : "INSTRUCTIONAL",
    "availability" : {
      "availableUntil" : "2022-01-31"
    },
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
        "templated" : true
      },
      "tag" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/tags",
        "templated" : false
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  }, {
    "id" : "5cf15aaece7c2c4e212747d3",
    "title" : "The Lonely Howl of Tamayo’s Last Dog",
    "description" : "Experience the raw emotion of Rufino Tamayo’s Perro Aullando a La Luna, the only dog from his Animal series left in private hands. In this evocative piece from 1942, he combines European Modernism with his Zapotec heritage to reveal the anguish of a world at war.  Perro Aullando a La Luna will be offered in our Impressionist & Modern Art Evening Sale on 14 May.\n\nLearn More: http://www.sothebys.com/en/auctions/ecatalogue/2018/impressionist-modern-art-evening-sale-n09860/lot.25.html\n\nDownload The Sotheby’s App:https://itunes.apple.com/us/app/sothebys/id1061156465?mt=8\n\nFOR MORE NEWS FROM SOTHEBY’S\nInstagram: https://www.instagram.com/sothebys/\nFacebook: https://www.facebook.com/sothebys \nTwitter: https://twitter.com/sothebys \nPinterest: https://www.pinterest.com/ \nWeibo: www.weibo.com/sothebyshongkong \nWeChat: sothebyshongkong \nSnapchat: Sothebys",
    "additionalDescription" : null,
    "releasedOn" : "2019-04-26",
    "updatedAt" : "2021-11-26T18:12:23.012065Z",
    "playback" : {
      "type" : "YOUTUBE",
      "id" : "8Y5J5xCwHrQ",
      "duration" : "PT3M13S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://i.ytimg.com/vi/8Y5J5xCwHrQ/hqdefault.jpg",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189455d",
      "name" : "Fine Art"
    }, {
      "id" : "5cb499c9fd5beb428189454c",
      "name" : "3Arabic"
    }, {
      "id" : "5cb499c9fd5beb428189454f",
      "name" : "Design"
    } ],
    "badges" : [ "youtube" ],
    "legalRestrictions" : "",
    "ageRange" : null,
    "rating" : 4.0,
    "yourRating" : null,
    "bestFor" : [ {
      "label" : "Experiment"
    } ],
    "createdBy" : "Sotheby's",
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ ],
    "type" : "INSTRUCTIONAL",
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3?rating={rating}",
        "templated" : true
      }
    }
  } ],
  "updatedAt" : "2021-11-26T18:12:28.5Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "attachments" : [ ],
  "subCollections" : [ ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/61a1238cfa44197e97de9186/events",
      "templated" : false
    }
  }
}

Retrieving a collection

You can retrieve collections by sending a GET request to collection link. It’s a templated link with a collection id path parameter.

Alternatively you can of course use an absolute link to a specific collection that you have, e.g. when it’s extracted from a Location header after creating.

Path parameters

Table 1. /v1/collections/{id}
Parameter Description

id

The ID of the collection

HTTP request

GET /v1/collections/61a12384fd9787473fb546e0 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: a221778b2ea62fa1
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 2825

{
  "id" : "61a12384fd9787473fb546e0",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "title" : "Genetic Screening Debate",
  "videos" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "title" : null,
    "description" : null,
    "additionalDescription" : null,
    "releasedOn" : null,
    "updatedAt" : null,
    "playback" : null,
    "subjects" : [ ],
    "badges" : [ ],
    "legalRestrictions" : null,
    "ageRange" : null,
    "rating" : null,
    "yourRating" : null,
    "bestFor" : null,
    "createdBy" : null,
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ ],
    "type" : null,
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
        "templated" : true
      }
    }
  } ],
  "updatedAt" : "2021-11-26T18:12:21.362Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "attachments" : [ {
    "id" : "61a12385fa44197e97de9184",
    "type" : "LESSON_PLAN",
    "description" : "1.Solving Problems with The Scientific Method: We Do it Everyday! 1.Plan A Science Fair Project",
    "_links" : {
      "download" : {
        "href" : "https://docs.google.com/document/d/1SBf26k2PEPsChg2X4yv6F71uqp8bECcYFtAFSmTDN10/edit?usp=sharing",
        "templated" : false
      }
    }
  } ],
  "subCollections" : [ ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/61a12384fd9787473fb546e0/events",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

id

String

The ID of the collection

owner

String

The ID of the collection’s owner

title

String

Collection’s title

description

String

Collection’s description

videos

Array

A list of videos in the collection. Shallow video details are returned by default

subjects

Array

A list of subjects assigned to this collection. See subjects for payload details

updatedAt

String

A timestamp of collection’s last update

discoverable

Boolean

Discoverable collections are discoverable through searching and browsing.

promoted

Boolean

Whether the collection is promoted

mine

Boolean

Whether the collection belongs to me

createdBy

String

Name of collection’s creator

subjects

Array

A list of teaching subjects this collection relates to

ageRange

Null

Tells which ages videos in this collection are suitable for

attachments

Array

A list of attachments linked to this collection

_links

Object

HAL links related to this collection
Relation Description

self

Points to this collection

edit

PATCH requests can be sent to this URL to update the collection

remove

DELETE request can be sent to this URL to remove the collection (videos remain in the system)

addVideo

PUT requests to this URL allow to add more videos to this collection

removeVideo

DELETE requests to this URL allow to remove videos from this collection

interactedWith

POST requests to this URL to track collection interaction events

Attachments

Attachments allow linking additional resources to video collections. The only type of attachments currently supported are lesson plans, which are in form of a hyperlink to an external document that can be accessed by collection’s viewer. Additionally, an attachment can have a description.

Response fields-attachments
Path Type Description

id

String

ID of the attachment

type

Enum String

The type of the attachment: LESSON_PLAN ACTIVITY

description

String

Text that describes the attachment

_links.download.href

String

A link that points to attachment’s actual content

Projections

The API supports two projections — list and details. They are used to control how sub-resources will be returned from the collection API call:

  • list will return only the id on returned video sub-resources.

  • details will return all fields of video sub-resources.

Projection can be specified via a query parameter and defaults to list:

HTTP request
GET /v1/collections/61a1236bfa44197e97de9180?projection=details HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example response
HTTP/1.1 200 OK
X-Boclips-Trace-ID: 73f02dadda98d3d7
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 5101

{
  "id" : "61a1236bfa44197e97de9180",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "title" : "Genetic Screening Debate",
  "videos" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "title" : "Genetic Screening Debate",
    "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
    "additionalDescription" : null,
    "releasedOn" : "2017-05-30",
    "updatedAt" : "2021-11-23T13:32:24.250858Z",
    "playback" : {
      "type" : "STREAM",
      "id" : "1_e72xmbcb",
      "duration" : "PT1M14S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
          "templated" : true
        },
        "videoPreview" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
          "templated" : true
        },
        "hlsStream" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5e70ae4b7cdd5a3b586cb8ea",
      "name" : "Art"
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "rating" : 2.0,
    "yourRating" : null,
    "bestFor" : [ ],
    "createdBy" : "Natcom Global",
    "promoted" : false,
    "language" : {
      "code" : "eng",
      "displayName" : "English"
    },
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ "screen", "genetic testing", "HD_111314_EN", "asked", "patient", "assess", "doctor", "readers", "risk", "genetics DNA", "family history", "recommend", "cancer", "potential", "doctors", "case", "asymptomatic", "news" ],
    "type" : "INSTRUCTIONAL",
    "availability" : {
      "availableUntil" : "2022-01-31"
    },
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?projection=details",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
        "templated" : true
      },
      "tag" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/tags",
        "templated" : false
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  } ],
  "updatedAt" : "2021-11-26T18:11:57.204Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "attachments" : [ {
    "id" : "61a1236dfd9787473fb546d8",
    "type" : "LESSON_PLAN",
    "description" : "1.Solving Problems with The Scientific Method: We Do it Everyday! 1.Plan A Science Fair Project",
    "_links" : {
      "download" : {
        "href" : "https://docs.google.com/document/d/1SBf26k2PEPsChg2X4yv6F71uqp8bECcYFtAFSmTDN10/edit?usp=sharing",
        "templated" : false
      }
    }
  } ],
  "subCollections" : [ ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/61a1236bfa44197e97de9180/events",
      "templated" : false
    }
  }
}

Boclips API allows searching through collections via searchCollections.

Collection search results are pageable — you can control both the page number and page size.

You can filter collections by lesson plans. If you include has_lesson_plans flag in your query, you’ll be given list of collection that will only have lesson plan attachments.

Request parameters

Parameter Type Optional Description

query

String

true

A phrase you want to search by. Filters through collection titles

discoverable

Boolean

true

By default only discoverable collections appear in search. To retrieve all collections use this property.

promoted

Boolean

true

Whether you want to search through promoted collections only or not

subject

List of subject IDs

true

Allows to limit search results to specific subjects only

age_range_min

Number

true

Minimum age to filter from - it filters on the collection age range property, and is inclusive

age_range_max

Number

true

Maximum age to filter to - it filters on the collection age range property, and is inclusive

age_range

String

true

Filters on the video age ranges. Provide age ranges in the form minAge-maxAge, ie 5-7. These ranges are inclusive.

has_lesson_plans

Boolean

true

Allows to limit search results to collection with lesson plan attachment only

page

Integer

true

Index of search results page to retrieve

size

Integer

true

Collection page size

projection

Integer

true

Controls how sub-resources are fetched. Allowed values are list for shallow details and details for full sub-resource information. See here for more details

sort_by

UPDATED_AT, IS_DEFAULT, HAS_ATTACHMENT

true

Sort collections by UPDATED_AT (last updated collections appear first), IS_DEFAULT (Watch later collections appear first), HAS_ATTACHMENT (collections with attachments appear first)

HTTP request

GET /v1/collections?query=collection&projection=list&page=0&size=1 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/collections?query=collection&projection=list&page=0&size=1' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 667f012450aedd51
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 1779

{
  "_embedded" : {
    "collections" : [ {
      "id" : "5e0333ef9c0f1946c296f123",
      "owner" : "332eadf7-0b69-4fad-a919-2b210b8325c4",
      "title" : "A title",
      "videos" : [ ],
      "updatedAt" : "2019-12-25T10:03:27.441Z",
      "public" : true,
      "discoverable" : true,
      "promoted" : false,
      "mine" : false,
      "createdBy" : "Boclips",
      "subjects" : [ ],
      "ageRange" : null,
      "description" : "Description of collection",
      "attachments" : [ ],
      "subCollections" : [ ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/collections/5e0333ef9c0f1946c296f123",
          "templated" : false
        },
        "bookmark" : {
          "href" : "https://api.boclips.com/v1/collections/5e0333ef9c0f1946c296f123?bookmarked=true",
          "templated" : false
        },
        "interactedWith" : {
          "href" : "https://api.boclips.com/v1/collections/5e0333ef9c0f1946c296f123/events",
          "templated" : false
        }
      }
    } ]
  },
  "page" : {
    "size" : 1,
    "totalElements" : 10000,
    "totalPages" : 10000,
    "number" : 0
  },
  "_links" : {
    "list" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&page=0&size=1&projection=list",
      "templated" : false
    },
    "details" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&page=0&size=1&projection=details",
      "templated" : false
    },
    "self" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&projection=list&page=0&size=1",
      "templated" : false
    },
    "next" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&projection=list&size=1&page=1",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

_embedded.collections

Array

Collection resources array. See collection for payload details

page.size

Number

Amount of resources in the current page

page.totalElements

Number

Total amount of resources for this search query across pages

page.totalPages

Number

Total amount of pages for this search query

page.number

Number

Number of the current page. Zero-index based

_links

Object

HAL links for the collection resource
Relation Description

self

Points to this exact search query

next

Points to next page of collections

details

Points to this search query with details projection

list

Points to this search query with list projection

Editing collections

Updating selected fields

A collection can be edited by sending a PATCH request to its edit link. Input parameters are provided via a JSON payload. You can update only specific fields of a given collection, you don’t need to always submit full details.

Upon success, the API will respond with a 204 status.

Example below shows all possible values, but subsets can be submitted as well.

Request fields
Path Type Optional Description

title

String

true

Collection’s title

description

String

true

Collection’s description

videos

Array

true

A list of IDs of videos that should belong to this collection. Will replace existing videos

subjects

Array

true

A list of IDs of subjects that should belong to this collection. Will replace existing subjects

discoverable

Boolean

true

Whether the new collection is visible in search and has been vetted by Boclips

ageRange.min

Number

true

The lower bound of age range this collection of videos is suitable for

ageRange.max

Number

true

The upper bound of age range this collection of videos is suitable for

attachment

Object

true

An optional attachment that can be added to this collection
Request fields-attachment
Path Type Optional Description

linkToResource

String

false

A link that points to attachment’s actual content

type

Enum String

false

The type of the attachment. Currently we support LESSON_PLAN only

description

String

true

Text that describes the attachment
HTTP request
PATCH /v1/collections/61a1238ffa44197e97de9187 HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json; charset=UTF-8
Host: api.boclips.com
Content-Length: 731

{
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "videos" : [ "5c542abf5438cdbcb56df0bf", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454e" ],
  "discoverable" : true,
  "ageRange" : {
    "min" : 8,
    "max" : 12
  },
  "attachment" : {
    "linkToResource" : "https://api.boclips.com/document/d/1SBf26k2PEPsChg2X4yv6F71uqp8bECcYFtAFSmTDN10/edit?usp=sharing",
    "description" : "1.Solving Problems with The Scientific Method: We Do it Everyday! 1.Plan A Science Fair Project",
    "type" : "LESSON_PLAN"
  }
}
Example request
$ curl 'https://api.boclips.com/v1/collections/61a1238ffa44197e97de9187' -i -X PATCH \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json; charset=UTF-8' \
    -d '{
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "videos" : [ "5c542abf5438cdbcb56df0bf", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454e" ],
  "discoverable" : true,
  "ageRange" : {
    "min" : 8,
    "max" : 12
  },
  "attachment" : {
    "linkToResource" : "https://api.boclips.com/document/d/1SBf26k2PEPsChg2X4yv6F71uqp8bECcYFtAFSmTDN10/edit?usp=sharing",
    "description" : "1.Solving Problems with The Scientific Method: We Do it Everyday! 1.Plan A Science Fair Project",
    "type" : "LESSON_PLAN"
  }
}'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 37d66e052da7f43a
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: clear

Adding videos to a collection

A video can be added to a collection by sending a PUT request to the addVideo link. It’s a templated link with a video_id path parameter.

Upon success, the API will respond with a 204 status.

Path parameters
Table 1. /collections/61a12371fa44197e97de9182/videos/{video_id}
Parameter Description

video_id

The ID of the video
HTTP request
PUT /v1/collections/61a12371fa44197e97de9182/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/61a12371fa44197e97de9182/videos/5c542abf5438cdbcb56df0bf' -i -X PUT \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 4c8b80feea3b423a
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: clear

Removing videos from a collection

A video can be removed from a collection by sending a DELETE request to the removeVideo link. It’s a templated link with a video_id path parameter.

Upon success, the API will respond with a 204 status.

Path parameters
Table 1. /collections/61a12364fa44197e97de917e/videos/{video_id}
Parameter Description

video_id

The ID of the video
HTTP request
DELETE /v1/collections/61a12364fa44197e97de917e/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/61a12364fa44197e97de917e/videos/5c542abf5438cdbcb56df0bf' -i -X DELETE \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 35cf38bbdb1ed9aa
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: clear

Bookmarking collections

Collections you haven’t created yourself can be bookmarked. This means that they will be returned from a query executed by following the bookmarkedCollections link.

In order to bookmark a collection you should follow its bookmark link. Analogously, a unbookmark link will be available for collections that you’ve already bookmarked.

Upon successful (un)bookmarking, the API will respond with a 200 response and return the updated resource.

HTTP request

PATCH /v1/collections/61a1237ffd9787473fb546df?bookmarked=true HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/collections/61a1237ffd9787473fb546df?bookmarked=true' -i -X PATCH \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 874680d7af1a51e2
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 1049

{
  "id" : "61a1237ffd9787473fb546df",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "title" : "Discoverable Boclips Collection",
  "videos" : [ ],
  "updatedAt" : "2021-11-26T18:12:15.109Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : false,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "This content is accessible by everyone",
  "attachments" : [ ],
  "subCollections" : [ ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/61a1237ffd9787473fb546df",
      "templated" : false
    },
    "unbookmark" : {
      "href" : "https://api.boclips.com/v1/collections/61a1237ffd9787473fb546df?bookmarked=false",
      "templated" : false
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/61a1237ffd9787473fb546df/events",
      "templated" : false
    }
  }
}

Disciplines

The discipline resource groups subjects together. Each discipline will contain a list of subjects.

Retrieving all disciplines

HTTP request

GET /v1/disciplines HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/disciplines' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: a318b5c20706cdc7
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 4183

{
  "_embedded" : {
    "disciplines" : [ {
      "id" : "5d0921accbb0371877b252d1",
      "name" : "Humanities",
      "code" : "arts",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189455d",
        "name" : "Fine Art"
      }, {
        "id" : "5cb499c9fd5beb428189454f",
        "name" : "Design"
      }, {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History"
      }, {
        "id" : "5cdd6f06123e93799efe8ad0",
        "name" : "Photography and Film"
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921accbb0371877b252d1"
        }
      }
    }, {
      "id" : "5d0921adcbb0371877b252d2",
      "name" : "Social Sciences",
      "code" : "social-studies",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History"
      }, {
        "id" : "5e73821c9bbfd47e6e7533a4",
        "name" : "Ancient History"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921adcbb0371877b252d2"
        }
      }
    }, {
      "id" : "619f6860d999e37fa3b4f66c",
      "name" : "Health and Medicine",
      "code" : "health-and-medicine",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189455c",
        "name" : "Reading, Writing, and Literacy"
      }, {
        "id" : "5cdd6f05123e93799efe8acd",
        "name" : "Classics and Mythology"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/619f6860d999e37fa3b4f66c"
        }
      }
    }, {
      "id" : "5d0921b0cbb0371877b252d3",
      "name" : "Mathematics",
      "code" : "mathematics",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894559",
        "name" : "General Mathematics"
      }, {
        "id" : "5cb499c9fd5beb4281894555",
        "name" : "Biology and Environmental Science"
      }, {
        "id" : "5cb499c9fd5beb4281894558",
        "name" : "Physics"
      }, {
        "id" : "5cdd6f07123e93799efe8ad1",
        "name" : "Agriculture and Horticulture"
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry"
      }, {
        "id" : "5cb499c9fd5beb4281894551",
        "name" : "Technology and Computer Science"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921b0cbb0371877b252d3"
        }
      }
    }, {
      "id" : "5d0921b4cbb0371877b252d6",
      "name" : "Life Sciences",
      "code" : "life-sciences",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish"
      }, {
        "id" : "5e70ae4b7cdd5a3b586cb8e8",
        "name" : "Arabic"
      }, {
        "id" : "5cb499c9fd5beb428189455e",
        "name" : "French"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921b4cbb0371877b252d6"
        }
      }
    }, {
      "id" : "5d0921b1cbb0371877b252d4",
      "name" : "Physical Sciences",
      "code" : "physical-sciences",
      "subjects" : [ {
        "id" : "5cdd6f07123e93799efe8ad2",
        "name" : "Personal Health and Wellness"
      }, {
        "id" : "5cb499c9fd5beb4281894565",
        "name" : "Social Emotional Learning"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921b1cbb0371877b252d4"
        }
      }
    }, {
      "id" : "5e70aff21609f9555a8e701b",
      "name" : "Business",
      "code" : "business",
      "subjects" : [ {
        "id" : "5e70ae4b7cdd5a3b586cb8ed",
        "name" : "Biology"
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5e70aff21609f9555a8e701b"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "rel" : "self",
      "href" : "https://api.boclips.com/v1/disciplines"
    }
  }
}

Response fields

Path Type Description

_embedded.disciplines[].id

String

Id of the discipline

_embedded.disciplines[].name

String

Name of the discipline

_embedded.disciplines[].code

String

kebab-case version of the name

_embedded.disciplines[]._links

Object

HAL links for the individual disciplines

_embedded.disciplines[].subjects

Array

A list of subjects associated to this discipline

_links

Object

HAL links for the discipline collection resource

Links

Relation Description

self

The discipline resource that was just retrieved

Subjects

The subject resource lists all available subjects that Boclips offers to tag videos or other relevant resources. This resource can also be used to filter by subject.

HTTP request

GET /v1/subjects HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/subjects' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 76e151ade048bd89
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json;charset=UTF-8
Via: 1.1 google
Alt-Svc: clear
Content-Length: 18928

{
  "_embedded" : {
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454b",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454e",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454d",
      "name" : "History",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454d",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454f",
      "name" : "Design",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454f",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454c",
      "name" : "3Arabic",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454c",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894555",
      "name" : "Biology and Environmental Science",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894555",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894556",
      "name" : "Geography and Earth Science",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894556",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894552",
      "name" : "Food and Health",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894552",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894550",
      "name" : "Philosophy and World Religions",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894550",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894554",
      "name" : "Theatre and Performing Arts",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894554",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894551",
      "name" : "Technology and Computer Science",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894551",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894553",
      "name" : "Art History",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894553",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894557",
      "name" : "Science",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894557",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894558",
      "name" : "Physics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894558",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894559",
      "name" : "General Mathematics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894559",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455b",
      "name" : "Psychology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455b",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455a",
      "name" : "Special Education",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455a",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455c",
      "name" : "Reading, Writing, and Literacy",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455c",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455d",
      "name" : "Fine Art",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455d",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455e",
      "name" : "French",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455e",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455f",
      "name" : "Early Childhood",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455f",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894561",
      "name" : "German",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894561",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894560",
      "name" : "Mandarin",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894560",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894562",
      "name" : "Civics and Government",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894562",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894565",
      "name" : "Social Emotional Learning",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894565",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894564",
      "name" : "Economics and Business",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894564",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894563",
      "name" : "Teacher Training",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894563",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894567",
      "name" : "Social Studies",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894567",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894566",
      "name" : "Literature",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894566",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f05123e93799efe8acc",
      "name" : "Career Preparation",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f05123e93799efe8acc",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f05123e93799efe8acd",
      "name" : "Classics and Mythology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f05123e93799efe8acd",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f06123e93799efe8ace",
      "name" : "Engineering",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f06123e93799efe8ace",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f06123e93799efe8acf",
      "name" : "English as a Second Language",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f06123e93799efe8acf",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f06123e93799efe8ad0",
      "name" : "Photography and Film",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f06123e93799efe8ad0",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f07123e93799efe8ad1",
      "name" : "Agriculture and Horticulture",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f07123e93799efe8ad1",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f07123e93799efe8ad2",
      "name" : "Personal Health and Wellness",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f07123e93799efe8ad2",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f07123e93799efe8ad3",
      "name" : "Law",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f07123e93799efe8ad3",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f08123e93799efe8ad4",
      "name" : "Other Languages",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f08123e93799efe8ad4",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f08123e93799efe8ad5",
      "name" : "Theatre Tech",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f08123e93799efe8ad5",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f08123e93799efe8ad6",
      "name" : "Public Health and Welfare",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f08123e93799efe8ad6",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f08123e93799efe8ad7",
      "name" : "Physical Education",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f08123e93799efe8ad7",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f09123e93799efe8ad8",
      "name" : "Tourism",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f09123e93799efe8ad8",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f09123e93799efe8ad9",
      "name" : "Music",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f09123e93799efe8ad9",
          "templated" : false
        }
      }
    }, {
      "id" : "5d25ec36269a9f20c9a88b08",
      "name" : "Physical Health and Nutrition",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5d25ec36269a9f20c9a88b08",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e5",
      "name" : "General Science",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e5",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e4",
      "name" : "Sociology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e4",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e6",
      "name" : "Reading and writing",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e6",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e7",
      "name" : "Philosophy and Religions",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e7",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b1609f9555a8e6fc4",
      "name" : "Business and Economics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b1609f9555a8e6fc4",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e8",
      "name" : "Arabic",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e8",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8ea",
      "name" : "Art",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8ea",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e9",
      "name" : "Design and technology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e9",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8eb",
      "name" : "SEN",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8eb",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b1609f9555a8e6fc5",
      "name" : "Geography",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b1609f9555a8e6fc5",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8ec",
      "name" : "Government and Politics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8ec",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8ed",
      "name" : "Biology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8ed",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73514ca56410512f083c59",
      "name" : "Writing",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73514ca56410512f083c59",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7380499bbfd47e6e753341",
      "name" : "Public Speaking",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7380499bbfd47e6e753341",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7382089bbfd47e6e75339c",
      "name" : "Language and Linguistics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7382089bbfd47e6e75339c",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7382099bbfd47e6e75339d",
      "name" : "Journalism and Media Studies",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7382099bbfd47e6e75339d",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73820a9bbfd47e6e75339e",
      "name" : "Children's Literature",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73820a9bbfd47e6e75339e",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73820b9bbfd47e6e75339f",
      "name" : "U.S. History",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73820b9bbfd47e6e75339f",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73821c9bbfd47e6e7533a4",
      "name" : "Ancient History",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73821c9bbfd47e6e7533a4",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7382239bbfd47e6e7533a7",
      "name" : "World History",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7382239bbfd47e6e7533a7",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7382259bbfd47e6e7533a8",
      "name" : "Global Studies",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7382259bbfd47e6e7533a8",
          "templated" : false
        }
      }
    }, {
      "id" : "5e7382279bbfd47e6e7533a9",
      "name" : "Fashion and Cosmetology",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e7382279bbfd47e6e7533a9",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73822a9bbfd47e6e7533aa",
      "name" : "Basic Number Skills",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73822a9bbfd47e6e7533aa",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73822c9bbfd47e6e7533ac",
      "name" : "Statistics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73822c9bbfd47e6e7533ac",
          "templated" : false
        }
      }
    }, {
      "id" : "5e73822f9bbfd47e6e7533ae",
      "name" : "Personal Finance",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e73822f9bbfd47e6e7533ae",
          "templated" : false
        }
      }
    }, {
      "id" : "619d157bd999e37fa3686473",
      "name" : "Applied Mathematics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/619d157bd999e37fa3686473",
          "templated" : false
        }
      }
    }, {
      "id" : "619d157cd999e37fa3686483",
      "name" : "Geometry",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/619d157cd999e37fa3686483",
          "templated" : false
        }
      }
    }, {
      "id" : "619d157cd999e37fa3686497",
      "name" : "Statistics",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/619d157cd999e37fa3686497",
          "templated" : false
        }
      }
    }, {
      "id" : "619d157cd999e37fa36864a8",
      "name" : "Calculus",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/619d157cd999e37fa36864a8",
          "templated" : false
        }
      }
    }, {
      "id" : "619d157cd999e37fa36864b6",
      "name" : "Algebra",
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/619d157cd999e37fa36864b6",
          "templated" : false
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/subjects",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

_embedded.subjects[].id

String

Id of the subject, can be used for filtering

_embedded.subjects[].name

String

Human readable subject name

_embedded.subjects[]._links

Object

HAL links for the subject resource

_links

Object

HAL links for the subject collection resource
Relation Description

self

The subject collection resource that was just retrieved

Tags

The tag resource lists all available tags that Boclips offers. Tags describe what the video can be best used for.

HTTP request

GET /v1/tags HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/tags' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 3ae50d75f4313b2f
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 1984

{
  "_embedded" : {
    "tags" : [ {
      "id" : "5d3ac0175b3f3b7ba335e103",
      "label" : "Brain break",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0175b3f3b7ba335e103"
        }
      }
    }, {
      "id" : "5d3ac0175b3f3b7ba335e104",
      "label" : "Context builder",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0175b3f3b7ba335e104"
        }
      }
    }, {
      "id" : "5d3ac0185b3f3b7ba335e105",
      "label" : "Experiment",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0185b3f3b7ba335e105"
        }
      }
    }, {
      "id" : "5d3ac0185b3f3b7ba335e106",
      "label" : "Explainer",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0185b3f3b7ba335e106"
        }
      }
    }, {
      "id" : "5d3ac0185b3f3b7ba335e107",
      "label" : "Hook",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0185b3f3b7ba335e107"
        }
      }
    }, {
      "id" : "5d3ac0185b3f3b7ba335e108",
      "label" : "Review",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0185b3f3b7ba335e108"
        }
      }
    }, {
      "id" : "5d3ac0195b3f3b7ba335e109",
      "label" : "Other",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0195b3f3b7ba335e109"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "rel" : "self",
      "href" : "https://api.boclips.com/v1/tags"
    }
  }
}

Response fields

Path Type Description

_embedded.tags[].id

String

ID of the tag

_embedded.tags[].label

String

Human readable tag label, this can be used for filtering videos

_embedded.tags[].userId

Null

The ID of the user that tagged the video with the given tag

_embedded.tags[]._links

Object

HAL links for the tag resource

_links

Object

HAL links for the tag collection resource
Relation Description

self

The tag collection resource that was just retrieved

Content Partners

This is now deprecated in favour of channels

Channels

The channel resource describes a provider of video content to the Boclips platform.

Retrieving one channel

HTTP request

GET /v1/channels/5cfea7cd8ce44c52e6e33b15 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/channels/5cfea7cd8ce44c52e6e33b15' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: e4a03efa2cb8498a
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 861

{
  "id" : "5cfea7cd8ce44c52e6e33b15",
  "name" : "2veritaserum",
  "legalRestriction" : {
    "id" : "5d976e55ed1c74690e0f025f",
    "text" : "No restrictions",
    "_links" : {
      "self" : {
        "rel" : "self",
        "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e55ed1c74690e0f025f"
      }
    }
  },
  "description" : "desc",
  "contentCategories" : [ {
    "key" : "INSPIRATION_FOR_LESSONS",
    "label" : "Inspiration for lessons"
  }, {
    "key" : "EDUCATIONAL_SONGS",
    "label" : "Educational songs"
  } ],
  "language" : {
    "code" : "abk",
    "name" : "Abkhazian"
  },
  "notes" : "nono",
  "contentTypes" : [ "STOCK" ],
  "contentType" : "STOCK",
  "oneLineDescription" : null,
  "_links" : {
    "self" : {
      "rel" : "self",
      "href" : "https://api.boclips.com/v1/channels/5cfea7cd8ce44c52e6e33b15"
    }
  }
}

Response fields

Path Type Description

id

String

The ID of the channel

name

String

The name of the channel

legalRestriction

Object

Text demonstrating the legal restrictions involved in using this channel’s content

description

String

Text describing this channel’s content

contentCategories[*].label

String

Content category label

language.code

String

Language in 3 letter ISO-639-2 code format

language.name

String

Name of the channel language

_links

Object

HAL links related to this collection

contentTypes

Array

Deprecated in favour of contentType

contentType

String

The type of content the channel produces

notes

String

Custom notes about the channel

oneLineDescription

Null

A snappy, high-energy description of the channel

Retrieving many channels

HTTP request

GET /v1/channels HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/channels' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 1c7d95f884108c80
Vary: Origin
Vary: Accept-Encoding
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: clear
Content-Length: 129713

{
  "_embedded" : {
    "channels" : [ {
      "id" : "5cfea7cd8ce44c52e6e33b15",
      "name" : "2veritaserum",
      "legalRestriction" : {
        "id" : "5d976e55ed1c74690e0f025f",
        "text" : "No restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e55ed1c74690e0f025f"
          }
        }
      },
      "description" : "desc",
      "contentCategories" : [ {
        "key" : "INSPIRATION_FOR_LESSONS",
        "label" : "Inspiration for lessons"
      }, {
        "key" : "EDUCATIONAL_SONGS",
        "label" : "Educational songs"
      } ],
      "language" : {
        "code" : "abk",
        "name" : "Abkhazian"
      },
      "notes" : "nono",
      "contentTypes" : [ "STOCK" ],
      "contentType" : "STOCK",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cd8ce44c52e6e33b15"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b3c",
      "name" : "Abe Davis's Research",
      "legalRestriction" : {
        "id" : "5d976e9c138a17514040baca",
        "text" : "Some dummy restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e9c138a17514040baca"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d18ce44c52e6e33b3c"
        }
      }
    }, {
      "id" : "5cfea8a18ce44c52e6e34074",
      "name" : "Actualized.org",
      "legalRestriction" : {
        "id" : "5db32455c7c734094f53d1f9",
        "text" : "Viewer discretion is advised. Content may not be suitable for people of 12 years or younger. Please contact boclips for editing permissions.",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5db32455c7c734094f53d1f9"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8a18ce44c52e6e34074"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b40",
      "name" : "Adam Westbrook",
      "legalRestriction" : {
        "id" : "5d976e9c138a17514040baca",
        "text" : "Some dummy restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e9c138a17514040baca"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d18ce44c52e6e33b40"
        }
      }
    }, {
      "id" : "5cfea84e8ce44c52e6e33e5e",
      "name" : "Almeida Theatre",
      "legalRestriction" : null,
      "description" : "hello",
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84e8ce44c52e6e33e5e"
        }
      }
    }, {
      "id" : "5cfe8b09336c6d2d0aa7c669",
      "name" : "American Museum of Natural History",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b09336c6d2d0aa7c669"
        }
      }
    }, {
      "id" : "5cfea7b88ce44c52e6e33a7f",
      "name" : "Ann & Robert H. Lurie Childreen's Hospital of Chicago",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "oneLineDescription" : "3 kids, 1 minute, 180 works of art to discover in this sassy series of interstitials where these characters never mince their words!",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b88ce44c52e6e33a7f"
        }
      }
    }, {
      "id" : "5cfea9968ce44c52e6e34641",
      "name" : "Ann & Robert H. Lurie Childreen's Hospital of Chicago1",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "EARLY_CHILDHOOD",
        "label" : "Early childhood"
      } ],
      "language" : {
        "code" : "deu",
        "name" : "deu"
      },
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9968ce44c52e6e34641"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178679",
      "name" : "AP",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : {
        "code" : "eng",
        "name" : "English"
      },
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178679"
        }
      }
    }, {
      "id" : "5cfea8338ce44c52e6e33dae",
      "name" : "AQA",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8338ce44c52e6e33dae"
        }
      }
    }, {
      "id" : "5cfea8988ce44c52e6e34037",
      "name" : "Ashmolean Museum",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8988ce44c52e6e34037"
        }
      }
    }, {
      "id" : "5cfea84d8ce44c52e6e33e5a",
      "name" : "Audio Productions",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84d8ce44c52e6e33e5a"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e3461f",
      "name" : "Austin Evans",
      "legalRestriction" : {
        "id" : "5d976e9c138a17514040baca",
        "text" : "Usage Notice: Please be advised that this video is available to use in streaming access products only and is not available for download licensing. Please save to Playlist or Cart and Contact Us to request streaming usage.",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e9c138a17514040baca"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e3461f"
        }
      }
    }, {
      "id" : "5cfea89a8ce44c52e6e34049",
      "name" : "Barristan Selmy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89a8ce44c52e6e34049"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f09",
      "name" : "BBC",
      "legalRestriction" : null,
      "description" : "tedst",
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86a8ce44c52e6e33f09"
        }
      }
    }, {
      "id" : "5cfe8ba0336c6d2d0aa7c9aa",
      "name" : "BBC Earth",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8ba0336c6d2d0aa7c9aa"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b1d",
      "name" : "BBC Earth Lab",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b1d"
        }
      }
    }, {
      "id" : "5cfea88f8ce44c52e6e33ff4",
      "name" : "BBC Ideas",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea88f8ce44c52e6e33ff4"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f0c",
      "name" : "BBC News",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86a8ce44c52e6e33f0c"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f0f",
      "name" : "BBC Newsnight",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86a8ce44c52e6e33f0f"
        }
      }
    }, {
      "id" : "5cfea88f8ce44c52e6e33ff6",
      "name" : "BBC Radio 4 !",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea88f8ce44c52e6e33ff6"
        }
      }
    }, {
      "id" : "5cfea9318ce44c52e6e343cd",
      "name" : "BBC Studios",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9318ce44c52e6e343cd"
        }
      }
    }, {
      "id" : "5cfe8ab3336c6d2d0aa7c47b",
      "name" : "BBC Teach",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8ab3336c6d2d0aa7c47b"
        }
      }
    }, {
      "id" : "5e26db31215aaa478ed515e9",
      "name" : "better name",
      "legalRestriction" : {
        "id" : "5d976e55ed1c74690e0f025f",
        "text" : "No restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e55ed1c74690e0f025f"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : "This is a description for 123",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e26db31215aaa478ed515e9"
        }
      }
    }, {
      "id" : "5cfea86c8ce44c52e6e33f1d",
      "name" : "BFI",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86c8ce44c52e6e33f1d"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33b02",
      "name" : "Biographics",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33b02"
        }
      }
    }, {
      "id" : "5cfea8088ce44c52e6e33c93",
      "name" : "Biography",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8088ce44c52e6e33c93"
        }
      }
    }, {
      "id" : "5cfea8338ce44c52e6e33db1",
      "name" : "Blank on Blank",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8338ce44c52e6e33db1"
        }
      }
    }, {
      "id" : "5d4402be2b79777a3ac9dfc4",
      "name" : "Bridgeman Arts",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d4402be2b79777a3ac9dfc4"
        }
      }
    }, {
      "id" : "5cfea7b68ce44c52e6e33a71",
      "name" : "British Dyslexia Association",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b68ce44c52e6e33a71"
        }
      }
    }, {
      "id" : "5cfea89d8ce44c52e6e34064",
      "name" : "Broadwaycom",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89d8ce44c52e6e34064"
        }
      }
    }, {
      "id" : "5cfea99b8ce44c52e6e3467c",
      "name" : "Bustle",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99b8ce44c52e6e3467c"
        }
      }
    }, {
      "id" : "5cfea8088ce44c52e6e33c9c",
      "name" : "Button Poetry",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8088ce44c52e6e33c9c"
        }
      }
    }, {
      "id" : "5cfea9998ce44c52e6e34661",
      "name" : "C-SPAN",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9998ce44c52e6e34661"
        }
      }
    }, {
      "id" : "5cfea7d28ce44c52e6e33b4e",
      "name" : "Cambridge University",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d28ce44c52e6e33b4e"
        }
      }
    }, {
      "id" : "5cfea7ca8ce44c52e6e33af6",
      "name" : "Canon Europe",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ca8ce44c52e6e33af6"
        }
      }
    }, {
      "id" : "5cfea7ec8ce44c52e6e33bed",
      "name" : "CBBC",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ec8ce44c52e6e33bed"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33afc",
      "name" : "CBS Sunday Morning",
      "legalRestriction" : null,
      "description" : "zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz",
      "contentCategories" : [ ],
      "language" : null,
      "notes" : "ggggggggggggggggggg",
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : "jjjjjjjjjjjjjjjjjjjj",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33afc"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f717867b",
      "name" : "Challenger Center",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f717867b"
        }
      }
    }, {
      "id" : "5cfea4528ce44c52e6e32702",
      "name" : "Challenger Center",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea4528ce44c52e6e32702"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e34638",
      "name" : "Chungdahm Learning",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e34638"
        }
      }
    }, {
      "id" : "5cfea7b88ce44c52e6e33a7b",
      "name" : "Cincinnati Children's",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b88ce44c52e6e33a7b"
        }
      }
    }, {
      "id" : "5cfe8c0a336c6d2d0aa7cbf3",
      "name" : "Code.org",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8c0a336c6d2d0aa7cbf3"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34625",
      "name" : "ColdFusion",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e34625"
        }
      }
    }, {
      "id" : "5cfea7d58ce44c52e6e33b64",
      "name" : "columbusmuseum",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d58ce44c52e6e33b64"
        }
      }
    }, {
      "id" : "5cfea89e8ce44c52e6e3406a",
      "name" : "CrashCourse",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89e8ce44c52e6e3406a"
        }
      }
    }, {
      "id" : "5cfea7d38ce44c52e6e33b55",
      "name" : "Creators",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d38ce44c52e6e33b55"
        }
      }
    }, {
      "id" : "5cfea8428ce44c52e6e33e12",
      "name" : "Cult of Pedagogy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8428ce44c52e6e33e12"
        }
      }
    }, {
      "id" : "5cfea89a8ce44c52e6e34044",
      "name" : "DE4AL7",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89a8ce44c52e6e34044"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b27",
      "name" : "Deep Look",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b27"
        }
      }
    }, {
      "id" : "61927b0a32472e78bfc46a76",
      "name" : "demo channel",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "spa",
        "name" : "Spanish"
      },
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/61927b0a32472e78bfc46a76"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b2d",
      "name" : "Design Science",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b2d"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b19",
      "name" : "Devon Contract Waste",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b19"
        }
      }
    }, {
      "id" : "5cfea8978ce44c52e6e34029",
      "name" : "Discover Ireland",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8978ce44c52e6e34029"
        }
      }
    }, {
      "id" : "5cfea9988ce44c52e6e34654",
      "name" : "Discovery UK",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9988ce44c52e6e34654"
        }
      }
    }, {
      "id" : "5cfea7cd8ce44c52e6e33b13",
      "name" : "Disney Educational Productions",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cd8ce44c52e6e33b13"
        }
      }
    }, {
      "id" : "5cfea9988ce44c52e6e3465a",
      "name" : "Domain of Science",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9988ce44c52e6e3465a"
        }
      }
    }, {
      "id" : "5d5d61220726b741db534ba8",
      "name" : "Dow Jones",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d5d61220726b741db534ba8"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33dee",
      "name" : "Duke Learning Innovation",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33dee"
        }
      }
    }, {
      "id" : "5cfe89c8336c6d2d0aa7bf92",
      "name" : "Easy German",
      "legalRestriction" : {
        "id" : "5d976e55ed1c74690e0f025f",
        "text" : "No restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e55ed1c74690e0f025f"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ ],
      "language" : {
        "code" : "deu",
        "name" : "deu"
      },
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe89c8336c6d2d0aa7bf92"
        }
      }
    }, {
      "id" : "5cfe89e4336c6d2d0aa7c00d",
      "name" : "Easy Languages",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : {
        "code" : "deu",
        "name" : "deu"
      },
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe89e4336c6d2d0aa7c00d"
        }
      }
    }, {
      "id" : "5cfe8a62336c6d2d0aa7c2be",
      "name" : "Easy Spanish",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8a62336c6d2d0aa7c2be"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33df4",
      "name" : "EDCHAT®",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33df4"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178680",
      "name" : "Eddie Woo",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178680"
        }
      }
    }, {
      "id" : "5cfe8ab1336c6d2d0aa7c470",
      "name" : "Eddie Woo",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8ab1336c6d2d0aa7c470"
        }
      }
    }, {
      "id" : "5cfea7ed8ce44c52e6e33bf1",
      "name" : "Educated Minds with Miss Cole",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ed8ce44c52e6e33bf1"
        }
      }
    }, {
      "id" : "5cfea8628ce44c52e6e33ed5",
      "name" : "Edutopia",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8628ce44c52e6e33ed5"
        }
      }
    }, {
      "id" : "5cfea9988ce44c52e6e34658",
      "name" : "Eli the Computer Guy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9988ce44c52e6e34658"
        }
      }
    }, {
      "id" : "5cfea83e8ce44c52e6e33df6",
      "name" : "Elite Facts",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83e8ce44c52e6e33df6"
        }
      }
    }, {
      "id" : "5cfea8048ce44c52e6e33c7e",
      "name" : "Entertain The Elk 2211",
      "legalRestriction" : null,
      "description" : "test",
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8048ce44c52e6e33c7e"
        }
      }
    }, {
      "id" : "5cfea9978ce44c52e6e3464d",
      "name" : "Epic Wildlife",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9978ce44c52e6e3464d"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33b06",
      "name" : "Eric Buffington",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33b06"
        }
      }
    }, {
      "id" : "5cfea99e8ce44c52e6e34694",
      "name" : "Every Think",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99e8ce44c52e6e34694"
        }
      }
    }, {
      "id" : "5cfea7d58ce44c52e6e33b60",
      "name" : "Experiments with Google",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d58ce44c52e6e33b60"
        }
      }
    }, {
      "id" : "5cfe8cb0336c6d2d0aa7cf81",
      "name" : "Extra Credits",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8cb0336c6d2d0aa7cf81"
        }
      }
    }, {
      "id" : "5d3f000d7ec37565dca27cac",
      "name" : "Extra English Practise",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d3f000d7ec37565dca27cac"
        }
      }
    }, {
      "id" : "5cfea7cc8ce44c52e6e33b0a",
      "name" : "FantasticPhonics",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cc8ce44c52e6e33b0a"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b45",
      "name" : "Fig. 1 by University of California",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d18ce44c52e6e33b45"
        }
      }
    }, {
      "id" : "5cfe8b46336c6d2d0aa7c7c6",
      "name" : "Film Riot",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b46336c6d2d0aa7c7c6"
        }
      }
    }, {
      "id" : "5cfea9978ce44c52e6e34652",
      "name" : "Finger Monkey Channel",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9978ce44c52e6e34652"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33b04",
      "name" : "FIRST LEGO League",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33b04"
        }
      }
    }, {
      "id" : "5cfea99d8ce44c52e6e3468f",
      "name" : "Freethink",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99d8ce44c52e6e3468f"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b1b",
      "name" : "Future Earth",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b1b"
        }
      }
    }, {
      "id" : "5cfea8988ce44c52e6e34032",
      "name" : "FutureLearn",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8988ce44c52e6e34032"
        }
      }
    }, {
      "id" : "5cfea7d48ce44c52e6e33b5a",
      "name" : "GatesFoundation",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d48ce44c52e6e33b5a"
        }
      }
    }, {
      "id" : "5cfea8138ce44c52e6e33ce1",
      "name" : "Geethanjali Kids - Rhymes and Stories",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8138ce44c52e6e33ce1"
        }
      }
    }, {
      "id" : "5cfea89b8ce44c52e6e34050",
      "name" : "Gil Manor",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89b8ce44c52e6e34050"
        }
      }
    }, {
      "id" : "5cfea99a8ce44c52e6e3466b",
      "name" : "Glamour",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99a8ce44c52e6e3466b"
        }
      }
    }, {
      "id" : "5cfe8abc336c6d2d0aa7c4b0",
      "name" : "Grammaropolis",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8abc336c6d2d0aa7c4b0"
        }
      }
    }, {
      "id" : "5cfe8b62336c6d2d0aa7c864",
      "name" : "Great Big Story",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b62336c6d2d0aa7c864"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33df0",
      "name" : "Gresham College",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33df0"
        }
      }
    }, {
      "id" : "5cfea8088ce44c52e6e33c97",
      "name" : "Guardian Culture",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8088ce44c52e6e33c97"
        }
      }
    }, {
      "id" : "5cfea90b8ce44c52e6e342ec",
      "name" : "Guardian News",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea90b8ce44c52e6e342ec"
        }
      }
    }, {
      "id" : "5cfea99d8ce44c52e6e3468b",
      "name" : "Happify",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99d8ce44c52e6e3468b"
        }
      }
    }, {
      "id" : "5cfea89b8ce44c52e6e34052",
      "name" : "harpercollins11",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89b8ce44c52e6e34052"
        }
      }
    }, {
      "id" : "5cfea8178ce44c52e6e33cfe",
      "name" : "HarvardX",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8178ce44c52e6e33cfe"
        }
      }
    }, {
      "id" : "5cfea8088ce44c52e6e33c99",
      "name" : "Hay Levels",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8088ce44c52e6e33c99"
        }
      }
    }, {
      "id" : "5cfea8998ce44c52e6e3403d",
      "name" : "Hillsdale College",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8998ce44c52e6e3403d"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33df2",
      "name" : "Hillsdale College Online Courses",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33df2"
        }
      }
    }, {
      "id" : "5cfea7bc8ce44c52e6e33a9c",
      "name" : "HISTORY",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7bc8ce44c52e6e33a9c"
        }
      }
    }, {
      "id" : "5cfe8d1d336c6d2d0aa7d1d4",
      "name" : "History Bombs",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8d1d336c6d2d0aa7d1d4"
        }
      }
    }, {
      "id" : "5cfea7d38ce44c52e6e33b50",
      "name" : "IBM",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d38ce44c52e6e33b50"
        }
      }
    }, {
      "id" : "5cfea99c8ce44c52e6e3467f",
      "name" : "IFLScience Official",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99c8ce44c52e6e3467f"
        }
      }
    }, {
      "id" : "5cfea9988ce44c52e6e3465c",
      "name" : "Improvement Pill",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9988ce44c52e6e3465c"
        }
      }
    }, {
      "id" : "5cfea7ba8ce44c52e6e33a8f",
      "name" : "insideadhd",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ba8ce44c52e6e33a8f"
        }
      }
    }, {
      "id" : "618cf3510d19964e4328b4d6",
      "name" : "Institute of Human Anatomy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/618cf3510d19964e4328b4d6"
        }
      }
    }, {
      "id" : "5cfea99e8ce44c52e6e34691",
      "name" : "Iris",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99e8ce44c52e6e34691"
        }
      }
    }, {
      "id" : "5cfea89a8ce44c52e6e34046",
      "name" : "Is This Just Fantasy?",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89a8ce44c52e6e34046"
        }
      }
    }, {
      "id" : "5cfea9998ce44c52e6e3465f",
      "name" : "IT'S HISTORY",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9998ce44c52e6e3465f"
        }
      }
    }, {
      "id" : "5cfea7cd8ce44c52e6e33b17",
      "name" : "It's Okay To Be Smart",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cd8ce44c52e6e33b17"
        }
      }
    }, {
      "id" : "5cfea7cc8ce44c52e6e33b08",
      "name" : "Jeremy Thompson",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cc8ce44c52e6e33b08"
        }
      }
    }, {
      "id" : "5cfea8428ce44c52e6e33e14",
      "name" : "Jimmy Thatcher",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8428ce44c52e6e33e14"
        }
      }
    }, {
      "id" : "5cfe8a98336c6d2d0aa7c3e6",
      "name" : "Juan Coronado",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8a98336c6d2d0aa7c3e6"
        }
      }
    }, {
      "id" : "5fb698eb92a64c0e7b324d44",
      "name" : "Learn with Zakaria - تعلم مع زكريا",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5fb698eb92a64c0e7b324d44"
        }
      }
    }, {
      "id" : "5cfea9968ce44c52e6e34645",
      "name" : "Life Noggin",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9968ce44c52e6e34645"
        }
      }
    }, {
      "id" : "5cfea89c8ce44c52e6e3405d",
      "name" : "lindsayjskinner",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89c8ce44c52e6e3405d"
        }
      }
    }, {
      "id" : "5cfea99b8ce44c52e6e3467a",
      "name" : "LinkedIn",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99b8ce44c52e6e3467a"
        }
      }
    }, {
      "id" : "5cfea9978ce44c52e6e34649",
      "name" : "list25",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9978ce44c52e6e34649"
        }
      }
    }, {
      "id" : "5cfea83c8ce44c52e6e33de4",
      "name" : "Loughborough University",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83c8ce44c52e6e33de4"
        }
      }
    }, {
      "id" : "5cfea99b8ce44c52e6e34676",
      "name" : "MacGillivray Freeman",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99b8ce44c52e6e34676"
        }
      }
    }, {
      "id" : "5cfea9988ce44c52e6e34656",
      "name" : "MajorPrep",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9988ce44c52e6e34656"
        }
      }
    }, {
      "id" : "5db02e010ac78d5d2fd69c86",
      "name" : "Make N' Create",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5db02e010ac78d5d2fd69c86"
        }
      }
    }, {
      "id" : "5cfea9998ce44c52e6e34667",
      "name" : "MAKERS",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9998ce44c52e6e34667"
        }
      }
    }, {
      "id" : "5cfea89b8ce44c52e6e34056",
      "name" : "Maria Quevedo",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89b8ce44c52e6e34056"
        }
      }
    }, {
      "id" : "5cfea84e8ce44c52e6e33e5c",
      "name" : "Mark Daniels",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84e8ce44c52e6e33e5c"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34621",
      "name" : "Marques Brownlee",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e34621"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e3463a",
      "name" : "Mashable Watercooler",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e3463a"
        }
      }
    }, {
      "id" : "5cfea99a8ce44c52e6e34670",
      "name" : "mathantics",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99a8ce44c52e6e34670"
        }
      }
    }, {
      "id" : "5d499aa03334ad77d5796690",
      "name" : "Matt Jones",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d499aa03334ad77d5796690"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178681",
      "name" : "Matt Jones",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178681"
        }
      }
    }, {
      "id" : "5cfe8c0c336c6d2d0aa7cc02",
      "name" : "MindYourDecisions",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8c0c336c6d2d0aa7cc02"
        }
      }
    }, {
      "id" : "5cfe8d21336c6d2d0aa7d1eb",
      "name" : "MITCSAIL",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8d21336c6d2d0aa7d1eb"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34623",
      "name" : "MITK12Videos",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e34623"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b30",
      "name" : "Monterey Bay Aquarium Research Institute (MBARI)",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b30"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b1f",
      "name" : "Motherboard",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b1f"
        }
      }
    }, {
      "id" : "5cfea8428ce44c52e6e33e16",
      "name" : "Movieclips",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8428ce44c52e6e33e16"
        }
      }
    }, {
      "id" : "5cfea7ec8ce44c52e6e33bef",
      "name" : "mrbruff",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ec8ce44c52e6e33bef"
        }
      }
    }, {
      "id" : "5cfea9998ce44c52e6e34665",
      "name" : "MSNBC",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9998ce44c52e6e34665"
        }
      }
    }, {
      "id" : "6053788ce18d692bfbd63c77",
      "name" : "Name",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/6053788ce18d692bfbd63c77"
        }
      }
    }, {
      "id" : "5cfea7d08ce44c52e6e33b32",
      "name" : "NASA Goddard",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d08ce44c52e6e33b32"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f717867d",
      "name" : "NASA Jet Propulsion Laboratory",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f717867d"
        }
      }
    }, {
      "id" : "5cfea4528ce44c52e6e32704",
      "name" : "NASA Jet Propulsion Laboratory",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea4528ce44c52e6e32704"
        }
      }
    }, {
      "id" : "5cfea9978ce44c52e6e3464b",
      "name" : "Nat Geo WILD",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9978ce44c52e6e3464b"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f717867a",
      "name" : "Natcom Global",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f717867a"
        }
      }
    }, {
      "id" : "5cfea8328ce44c52e6e33da4",
      "name" : "National Centre for Writing",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8328ce44c52e6e33da4"
        }
      }
    }, {
      "id" : "5d2855a97e173c570e69c376",
      "name" : "National Geographic",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d2855a97e173c570e69c376"
        }
      }
    }, {
      "id" : "5cfea81b8ce44c52e6e33d16",
      "name" : "National Theatre",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea81b8ce44c52e6e33d16"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b29",
      "name" : "nature video",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b29"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b3e",
      "name" : "NPR",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d18ce44c52e6e33b3e"
        }
      }
    }, {
      "id" : "5cfe8d01336c6d2d0aa7d131",
      "name" : "Numberphile",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8d01336c6d2d0aa7d131"
        }
      }
    }, {
      "id" : "5cfe8d0b336c6d2d0aa7d16e",
      "name" : "Numberphile2",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8d0b336c6d2d0aa7d16e"
        }
      }
    }, {
      "id" : "5d80ea217c518c39fe980301",
      "name" : "Odd Quartet",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d80ea217c518c39fe980301"
        }
      }
    }, {
      "id" : "5cfea8088ce44c52e6e33c95",
      "name" : "OpenLearn from The Open University",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8088ce44c52e6e33c95"
        }
      }
    }, {
      "id" : "5cfea8188ce44c52e6e33d00",
      "name" : "Opus Arte",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8188ce44c52e6e33d00"
        }
      }
    }, {
      "id" : "5cfea99c8ce44c52e6e34687",
      "name" : "Origin Of Everything",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99c8ce44c52e6e34687"
        }
      }
    }, {
      "id" : "5cfe8cae336c6d2d0aa7cf78",
      "name" : "OverSimplified",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8cae336c6d2d0aa7cf78"
        }
      }
    }, {
      "id" : "5cfea84e8ce44c52e6e33e65",
      "name" : "Oxford Online English",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84e8ce44c52e6e33e65"
        }
      }
    }, {
      "id" : "5cfe8af8336c6d2d0aa7c608",
      "name" : "patrickJMT",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8af8336c6d2d0aa7c608"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f717867c",
      "name" : "PBS NewsHour",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f717867c"
        }
      }
    }, {
      "id" : "5cfea9948ce44c52e6e3462b",
      "name" : "PBS Space Time",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9948ce44c52e6e3462b"
        }
      }
    }, {
      "id" : "5cfea7b98ce44c52e6e33a85",
      "name" : "Pediatric Occupational Therapy Services",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b98ce44c52e6e33a85"
        }
      }
    }, {
      "id" : "5cfea8918ce44c52e6e34002",
      "name" : "Penguin Books UK",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8918ce44c52e6e34002"
        }
      }
    }, {
      "id" : "5cfe8b49336c6d2d0aa7c7d3",
      "name" : "Philosophy Tube",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b49336c6d2d0aa7c7d3"
        }
      }
    }, {
      "id" : "5cfe8bf3336c6d2d0aa7cb78",
      "name" : "Physics Girl",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8bf3336c6d2d0aa7cb78"
        }
      }
    }, {
      "id" : "5cfea8208ce44c52e6e33d37",
      "name" : "Please go to our new YouTube Channel below",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8208ce44c52e6e33d37"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178682",
      "name" : "Press Association",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178682"
        }
      }
    }, {
      "id" : "5cfea7d58ce44c52e6e33b66",
      "name" : "Prime Coaching Sport",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d58ce44c52e6e33b66"
        }
      }
    }, {
      "id" : "5cfea7ba8ce44c52e6e33a8d",
      "name" : "Psych2Go",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ba8ce44c52e6e33a8d"
        }
      }
    }, {
      "id" : "5cfea7b88ce44c52e6e33a7d",
      "name" : "Reaching Families",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b88ce44c52e6e33a7d"
        }
      }
    }, {
      "id" : "5cfea7d08ce44c52e6e33b39",
      "name" : "Reactions",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d08ce44c52e6e33b39"
        }
      }
    }, {
      "id" : "5cfea9948ce44c52e6e3462f",
      "name" : "Real Engineering",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9948ce44c52e6e3462f"
        }
      }
    }, {
      "id" : "5d80f382acc1e027eef62fd4",
      "name" : "Redesign My Brain",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d80f382acc1e027eef62fd4"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178683",
      "name" : "Reuters Archive",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178683"
        }
      }
    }, {
      "id" : "5cfea94e8ce44c52e6e34481",
      "name" : "Roald Dahl",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea94e8ce44c52e6e34481"
        }
      }
    }, {
      "id" : "5d4b11a19082e01934ecbbd9",
      "name" : "rockentry",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d4b11a19082e01934ecbbd9"
        }
      }
    }, {
      "id" : "5cfea7d28ce44c52e6e33b4c",
      "name" : "Royal Botanic Gardens, Kew",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d28ce44c52e6e33b4c"
        }
      }
    }, {
      "id" : "5cfe8b58336c6d2d0aa7c82d",
      "name" : "Royal Shakespeare Company",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b58336c6d2d0aa7c82d"
        }
      }
    }, {
      "id" : "5cfea7d38ce44c52e6e33b53",
      "name" : "Royal Society Of Chemistry",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d38ce44c52e6e33b53"
        }
      }
    }, {
      "id" : "5cfe8b4c336c6d2d0aa7c7e6",
      "name" : "RSC Shakespeare Learning Zone",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b4c336c6d2d0aa7c7e6"
        }
      }
    }, {
      "id" : "5cfea99c8ce44c52e6e34685",
      "name" : "SciFri",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99c8ce44c52e6e34685"
        }
      }
    }, {
      "id" : "5cfea9928ce44c52e6e3461b",
      "name" : "Seeker",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9928ce44c52e6e3461b"
        }
      }
    }, {
      "id" : "5cfea81b8ce44c52e6e33d14",
      "name" : "Shakespeare's Globe",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea81b8ce44c52e6e33d14"
        }
      }
    }, {
      "id" : "5cfea89a8ce44c52e6e3404b",
      "name" : "Shia Syndicate",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89a8ce44c52e6e3404b"
        }
      }
    }, {
      "id" : "5cfea99a8ce44c52e6e3466e",
      "name" : "Simon Clark",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99a8ce44c52e6e3466e"
        }
      }
    }, {
      "id" : "5cfea83e8ce44c52e6e33df8",
      "name" : "SingSongAlong",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83e8ce44c52e6e33df8"
        }
      }
    }, {
      "id" : "5cfe8b26336c6d2d0aa7c714",
      "name" : "Smithsonian Channel",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b26336c6d2d0aa7c714"
        }
      }
    }, {
      "id" : "5cfea9508ce44c52e6e3448f",
      "name" : "Sotheby's",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9508ce44c52e6e3448f"
        }
      }
    }, {
      "id" : "5cfe8b59336c6d2d0aa7c830",
      "name" : "Space Videos",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b59336c6d2d0aa7c830"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33dec",
      "name" : "SpokenVerse",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33dec"
        }
      }
    }, {
      "id" : "5cfea7b78ce44c52e6e33a79",
      "name" : "St. Joseph's Health Centre, Toronto",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b78ce44c52e6e33a79"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b23",
      "name" : "Stanford",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b23"
        }
      }
    }, {
      "id" : "5cfe8ab2336c6d2d0aa7c479",
      "name" : "stanfordonline",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8ab2336c6d2d0aa7c479"
        }
      }
    }, {
      "id" : "5cfea86b8ce44c52e6e33f13",
      "name" : "Stonewall | Acceptance Without Exception",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86b8ce44c52e6e33f13"
        }
      }
    }, {
      "id" : "5cfea7ba8ce44c52e6e33a91",
      "name" : "storybooth",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ba8ce44c52e6e33a91"
        }
      }
    }, {
      "id" : "5cfe8cf8336c6d2d0aa7d107",
      "name" : "StoryCorps",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8cf8336c6d2d0aa7d107"
        }
      }
    }, {
      "id" : "5d5c231dd6c49b7f5a740fbc",
      "name" : "StorylineOnline",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d5c231dd6c49b7f5a740fbc"
        }
      }
    }, {
      "id" : "5cfea8998ce44c52e6e3403b",
      "name" : "Tate",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8998ce44c52e6e3403b"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33b00",
      "name" : "TeacherHub English",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33b00"
        }
      }
    }, {
      "id" : "5cfea9948ce44c52e6e3462d",
      "name" : "Tech Insider",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9948ce44c52e6e3462d"
        }
      }
    }, {
      "id" : "5e303555b281e424e1195b50",
      "name" : "TED",
      "legalRestriction" : {
        "id" : "5d976e55ed1c74690e0f025f",
        "text" : "No restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e55ed1c74690e0f025f"
          }
        }
      },
      "description" : "with descriptionnnnn",
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e303555b281e424e1195b50"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178678",
      "name" : "TED",
      "legalRestriction" : {
        "id" : "5d976e9c138a17514040baca",
        "text" : "Usage Notice: Please be advised that this video is available to use in streaming access products only and is not available for download licensing. Please save to Playlist or Cart and Contact Us to request streaming usage.",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e9c138a17514040baca"
          }
        }
      },
      "description" : "PACT CONTENT PARTNER - DO NOT CHANGE",
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      }, {
        "key" : "DOCUMENTARY_SHORTS",
        "label" : "Documentary shorts"
      }, {
        "key" : "EARLY_CHILDHOOD",
        "label" : "Early childhood"
      }, {
        "key" : "EDUCATIONAL_SONGS",
        "label" : "Educational songs"
      } ],
      "language" : {
        "code" : "afr",
        "name" : "Afrikaans"
      },
      "notes" : "3",
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : "One line description",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178678"
        }
      }
    }, {
      "id" : "5e0f6fa404d95551584b3f5c",
      "name" : "TED-Ed",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e0f6fa404d95551584b3f5c"
        }
      }
    }, {
      "id" : "5cfea99b8ce44c52e6e34678",
      "name" : "Tennessee Department of Agriculture",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99b8ce44c52e6e34678"
        }
      }
    }, {
      "id" : "5cfea7b28ce44c52e6e33a58",
      "name" : "The Art Assignment",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b28ce44c52e6e33a58"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33afa",
      "name" : "The Art of Photography",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33afa"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b43",
      "name" : "The Atlantic",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d18ce44c52e6e33b43"
        }
      }
    }, {
      "id" : "5e1deaca885cfd10e8098134",
      "name" : "The Bazillions",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e1deaca885cfd10e8098134"
        }
      }
    }, {
      "id" : "5cfea7cb8ce44c52e6e33afe",
      "name" : "The Book Tutor",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cb8ce44c52e6e33afe"
        }
      }
    }, {
      "id" : "5cfea8988ce44c52e6e34039",
      "name" : "The British Library",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8988ce44c52e6e34039"
        }
      }
    }, {
      "id" : "5cfea90b8ce44c52e6e342ee",
      "name" : "The British Museum",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea90b8ce44c52e6e342ee"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e34636",
      "name" : "The Cogito",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e34636"
        }
      }
    }, {
      "id" : "5cfea9978ce44c52e6e34650",
      "name" : "The Dodo",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9978ce44c52e6e34650"
        }
      }
    }, {
      "id" : "5cfea7d28ce44c52e6e33b49",
      "name" : "The Guardian",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d28ce44c52e6e33b49"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e3463e",
      "name" : "The Infographics Show",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e3463e"
        }
      }
    }, {
      "id" : "5cfea7d08ce44c52e6e33b37",
      "name" : "The New York Times",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d08ce44c52e6e33b37"
        }
      }
    }, {
      "id" : "5e9739ee3470ce3af1f44331",
      "name" : "The Office",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e9739ee3470ce3af1f44331"
        }
      }
    }, {
      "id" : "5cfe8abc336c6d2d0aa7c4ae",
      "name" : "The Royal Institution",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8abc336c6d2d0aa7c4ae"
        }
      }
    }, {
      "id" : "5cfe8b22336c6d2d0aa7c6fe",
      "name" : "The RSA",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b22336c6d2d0aa7c6fe"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e3463c",
      "name" : "The Specialist",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e3463c"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e34634",
      "name" : "The Take",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9958ce44c52e6e34634"
        }
      }
    }, {
      "id" : "5cfea7d08ce44c52e6e33b35",
      "name" : "The Telegraph",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d08ce44c52e6e33b35"
        }
      }
    }, {
      "id" : "5cfea89d8ce44c52e6e34060",
      "name" : "The Tony Awards",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89d8ce44c52e6e34060"
        }
      }
    }, {
      "id" : "5cfea8148ce44c52e6e33ce4",
      "name" : "The Touring Teacher",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8148ce44c52e6e33ce4"
        }
      }
    }, {
      "id" : "5cfea8988ce44c52e6e34030",
      "name" : "The University of Chicago",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8988ce44c52e6e34030"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b2b",
      "name" : "The Verge",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b2b"
        }
      }
    }, {
      "id" : "5cfea8988ce44c52e6e34035",
      "name" : "The Wordsworth Trust",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8988ce44c52e6e34035"
        }
      }
    }, {
      "id" : "5cfe8b29336c6d2d0aa7c723",
      "name" : "thebrainscoop",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8b29336c6d2d0aa7c723"
        }
      }
    }, {
      "id" : "5cfea84e8ce44c52e6e33e60",
      "name" : "TheDepressedLobster",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84e8ce44c52e6e33e60"
        }
      }
    }, {
      "id" : "5cfea8a18ce44c52e6e34072",
      "name" : "Then & Now",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8a18ce44c52e6e34072"
        }
      }
    }, {
      "id" : "5cfea7b88ce44c52e6e33a81",
      "name" : "therapyideas",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b88ce44c52e6e33a81"
        }
      }
    }, {
      "id" : "5cfea9928ce44c52e6e34619",
      "name" : "TheSpanglerEffect",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9928ce44c52e6e34619"
        }
      }
    }, {
      "id" : "5e1deac9885cfd10e8098133",
      "name" : "This is a new provider",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5e1deac9885cfd10e8098133"
        }
      }
    }, {
      "id" : "5cfea7ca8ce44c52e6e33af8",
      "name" : "Thomson Reuters Foundation",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ca8ce44c52e6e33af8"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34629",
      "name" : "Thought Café",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e34629"
        }
      }
    }, {
      "id" : "5cfea99a8ce44c52e6e34669",
      "name" : "TIME",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99a8ce44c52e6e34669"
        }
      }
    }, {
      "id" : "5cfea89e8ce44c52e6e3406d",
      "name" : "Timeless Classic Movies",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89e8ce44c52e6e3406d"
        }
      }
    }, {
      "id" : "5cfea8168ce44c52e6e33cf7",
      "name" : "Timeline - World History Documentaries",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8168ce44c52e6e33cf7"
        }
      }
    }, {
      "id" : "5d4806d07e667847ff94f694",
      "name" : "Tom Nicholas",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d4806d07e667847ff94f694"
        }
      }
    }, {
      "id" : "5cfea83d8ce44c52e6e33dea",
      "name" : "Tom Robinson",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea83d8ce44c52e6e33dea"
        }
      }
    }, {
      "id" : "5cfea8698ce44c52e6e33f05",
      "name" : "Tom Scott",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8698ce44c52e6e33f05"
        }
      }
    }, {
      "id" : "5cfea84e8ce44c52e6e33e62",
      "name" : "UCL Film & TV Society",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea84e8ce44c52e6e33e62"
        }
      }
    }, {
      "id" : "5cfea7ba8ce44c52e6e33a93",
      "name" : "UK Parliament",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ba8ce44c52e6e33a93"
        }
      }
    }, {
      "id" : "5fb68bb29ab5452e1d2a11bc",
      "name" : "Um Abdullah",
      "legalRestriction" : null,
      "description" : "Um Abdullah Test",
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5fb68bb29ab5452e1d2a11bc"
        }
      }
    }, {
      "id" : "5cfea9928ce44c52e6e3461d",
      "name" : "Unbox Therapy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9928ce44c52e6e3461d"
        }
      }
    }, {
      "id" : "5cfea7e78ce44c52e6e33bd2",
      "name" : "Understood",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7e78ce44c52e6e33bd2"
        }
      }
    }, {
      "id" : "5cfea8978ce44c52e6e3402b",
      "name" : "University of Warwick",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8978ce44c52e6e3402b"
        }
      }
    }, {
      "id" : "5cfea8338ce44c52e6e33dab",
      "name" : "Vanity Fair",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8338ce44c52e6e33dab"
        }
      }
    }, {
      "id" : "5cfea99a8ce44c52e6e34673",
      "name" : "Verge Science",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99a8ce44c52e6e34673"
        }
      }
    }, {
      "id" : "5cfea7cf8ce44c52e6e33b25",
      "name" : "Veritasium",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7cf8ce44c52e6e33b25"
        }
      }
    }, {
      "id" : "5cfea8998ce44c52e6e3403f",
      "name" : "VideoSparkNotes",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8998ce44c52e6e3403f"
        }
      }
    }, {
      "id" : "5cfe8c9b336c6d2d0aa7cf0d",
      "name" : "Vihart",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8c9b336c6d2d0aa7cf0d"
        }
      }
    }, {
      "id" : "5cfea99c8ce44c52e6e34682",
      "name" : "Vintage Space",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea99c8ce44c52e6e34682"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f07",
      "name" : "Viralmente",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea86a8ce44c52e6e33f07"
        }
      }
    }, {
      "id" : "5cfea7ce8ce44c52e6e33b21",
      "name" : "Vox",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7ce8ce44c52e6e33b21"
        }
      }
    }, {
      "id" : "5cfea7b88ce44c52e6e33a83",
      "name" : "Wall Street Journal",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7b88ce44c52e6e33a83"
        }
      }
    }, {
      "id" : "5cfea8a18ce44c52e6e34070",
      "name" : "Watts Gallery - Artists' Village",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8a18ce44c52e6e34070"
        }
      }
    }, {
      "id" : "5cfea89d8ce44c52e6e34062",
      "name" : "WhatsOnStage",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89d8ce44c52e6e34062"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34627",
      "name" : "WIRED",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e34627"
        }
      }
    }, {
      "id" : "5cfea8968ce44c52e6e34024",
      "name" : "WNYC",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8968ce44c52e6e34024"
        }
      }
    }, {
      "id" : "5d8e24039a425065b67a6a92",
      "name" : "Xinhua News Agency",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d8e24039a425065b67a6a92"
        }
      }
    } ]
  }
}

Response fields

Path Type Description

_embedded.channels

Array

Channels resources array. See the channel resource for payload details