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.

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

reasons

Null

The list of reasons which caused 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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 233

{
  "path" : "/v1/videos",
  "status" : 400,
  "timestamp" : "2024-12-09T11:23:16.111561639Z",
  "error" : "Invalid request",
  "message" : "not-quite-a-number is not a valid ISO 8601 duration. Example is PT5S.",
  "reasons" : null
}

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" : "604800",
  "refresh_token" : "***",
  "token_type" : "Bearer",
  "not-before-policy" : "1691658383",
  "session_state" : "9dd26837-d035-4a79-8e99-476d396abee3",
  "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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/hal+json
X-XSS-Protection: 0
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 7029

{
  "_links" : {
    "ngssCodes" : {
      "href" : "https://api.boclips.com/v1/curriculum/ngss/codes",
      "templated" : false
    },
    "ngssGrades" : {
      "href" : "https://api.boclips.com/v1/curriculum/ngss/grades",
      "templated" : false
    },
    "getThemesByIds" : {
      "href" : "https://api.boclips.com/v1/alignments/themes{?id}",
      "templated" : true
    },
    "getThemesByProvider" : {
      "href" : "https://api.boclips.com/v1/alignments/{provider}/themes",
      "templated" : true
    },
    "getThemesByProviderAndId" : {
      "href" : "https://api.boclips.com/v1/alignments/{provider}/themes/{id}",
      "templated" : true
    },
    "getAllProviders" : {
      "href" : "https://api.boclips.com/v1/alignments/providers",
      "templated" : false
    },
    "subjects" : {
      "href" : "https://api.boclips.com/v1/subjects",
      "templated" : false
    },
    "allSubjects" : {
      "href" : "https://api.boclips.com/v1/subjects?visibility=all",
      "templated" : false
    },
    "marketSegmentSubjects" : {
      "href" : "https://api.boclips.com/v1/subjects{?marketSegment}",
      "templated" : true
    },
    "disciplines" : {
      "href" : "https://api.boclips.com/v1/disciplines",
      "templated" : false
    },
    "allDisciplines" : {
      "href" : "https://api.boclips.com/v1/disciplines?visibility=all",
      "templated" : false
    },
    "video" : {
      "href" : "https://api.boclips.com/v1/videos/{id}{?referer}",
      "templated" : true
    },
    "searchVideos" : {
      "href" : "https://api.boclips.com/v1/videos{?query,sort_by,best_for,duration_min,duration_max,duration,duration_facets,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,channel,include_channel_facets,include_education_level_facets,include_topic_facets,type,id,resource_types,category_code,updated_as_of,language,education_level,content_package,topics,cefr_level,include_cefr_level_facets,subtype}",
      "templated" : true
    },
    "getMetadata" : {
      "href" : "https://api.boclips.com/v1/videos/metadata",
      "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
    },
    "promotedForCollections" : {
      "href" : "https://api.boclips.com/v1/collections?projection=list&discoverable=true&page=0&size=30{&promotedFor}",
      "templated" : true
    },
    "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}{?projection,referer}",
      "templated" : true
    },
    "myCollections" : {
      "href" : "https://api.boclips.com/v1/users/f2e3064c-9085-4f50-ab44-6b78c760ecd0/collections?bookmarked=false&types=OWNED{&query,partial_title_match,projection,page,size,sort_by}",
      "templated" : true
    },
    "mySavedCollections" : {
      "href" : "https://api.boclips.com/v1/users/f2e3064c-9085-4f50-ab44-6b78c760ecd0/collections{?query,partial_title_match,projection,page,size,sort_by,can_edit}",
      "templated" : true
    },
    "boclipsSharedCollections" : {
      "href" : "https://api.boclips.com/v1/users/f2e3064c-9085-4f50-ab44-6b78c760ecd0/collections?types=BOCLIPS_SHARED{&query,partial_title_match,projection,page,size,sort_by,can_edit}",
      "templated" : true
    },
    "userSharedBookmarkedCollections" : {
      "href" : "https://api.boclips.com/v1/users/f2e3064c-9085-4f50-ab44-6b78c760ecd0/collections?types=USER_SHARED{&query,partial_title_match,projection,page,size,sort_by,can_edit}",
      "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
    },
    "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,education_levels*}",
      "templated" : true
    },
    "contractLegalRestrictions" : {
      "href" : "https://api.boclips.com/v1/contract-legal-restrictions",
      "templated" : false
    },
    "educationLevels" : {
      "href" : "https://api.boclips.com/v1/education-levels",
      "templated" : false
    },
    "boclipsWebAppAccess" : {
      "href" : "https://api.boclips.com/v1/users/_self",
      "templated" : false
    },
    "profile" : {
      "href" : "https://api.boclips.com/v1/users/f2e3064c-9085-4f50-ab44-6b78c760ecd0",
      "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
    },
    "isUserActive" : {
      "href" : "https://api.boclips.com/v1/users/{id}/active",
      "templated" : true
    },
    "searchSchools" : {
      "href" : "https://api.boclips.com/v1/schools?countryCode=USA{&query,state}",
      "templated" : true
    },
    "learningOutcomes" : {
      "href" : "https://api.boclips.com/v1/videos/{videoId}/learning-outcomes",
      "templated" : true
    },
    "assessmentQuestions" : {
      "href" : "https://api.boclips.com/v1/videos/{videoId}/assessment-questions",
      "templated" : true
    },
    "getHighlights" : {
      "href" : "https://api.boclips.com/v1/highlights{?threshold,size,query,education_level,max_overlap,hyper_relevance,channel,subtype}",
      "templated" : true
    },
    "getHighlight" : {
      "href" : "https://api.boclips.com/v1/highlights/{highlightId}",
      "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

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 that will return videos

allSubjects

List of all subjects available in the system

educationLevels

List of available education levels

disciplines

List of disciplines that will return videos (e.g. arts, humanities…​)

allDisciplines

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

ngssCodes

List of all NGSS codes available

ngssGrades

List of all NGSS grades available

channel

Retrieve a specific channel

channels

Retrieve all channels

contentCategories

Retrieve a list of content categories

isUserActive

Check whether given user is active

getAllProviders

List all providers and their types

getThemesByProvider

List all available themes for a specific provider

Relation Description

learningOutcomes

Retrieve learning outcomes of a video

assessmentQuestions

Retrieve assessment questions of a video

getHighlight

Retrieve a highlight by ID

getHighlights

Retrieve all highlights with filters

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
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' \
    -d '{
  "videoId" : "5c542abf5438cdbcb56df0bf",
  "segmentStartSeconds" : 1,
  "segmentEndSeconds" : 3,
  "userId" : "f0e8d794-1d7e-4944-9705-e16946c7b694"
}'
Example response
HTTP/1.1 201 Created
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

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
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' \
    -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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: origin,access-control-request-method,access-control-request-headers,accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 4122

{
  "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" : "2024-04-18T17:00:52.041501664Z",
  "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/ks/djJ8MjM5NDE2Mny3R_GTan3CSSTLi2lCJ1Aup1C0l0YlO2EGKJrDucz8fedk8n172n11ehDvcP3YRvTHaCIZs4_RfeBmhHoRU7ynjAhK9fSW7vJU4Svb9cCOcfDD8X61ZNbagGq16dVp5P0TVVHsIuvwX-PktoQf3VQw86rbIhSSOgEoDVMANaaNrw%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
        "templated" : false
      }
    }
  },
  "subjects" : [ {
    "id" : "5cb499c9fd5beb4281894553",
    "name" : "Art History",
    "categories" : null
  }, {
    "id" : "5cdd6f08123e93799efe8ad5",
    "name" : "Theatre Tech",
    "categories" : null
  }, {
    "id" : "5cb499c9fd5beb428189454d",
    "name" : "History",
    "categories" : null
  }, {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry",
    "categories" : null
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish",
    "categories" : null
  } ],
  "badges" : [ "ad-free" ],
  "legalRestrictions" : "",
  "ageRange" : {
    "min" : 12,
    "max" : 12,
    "label" : "12-12"
  },
  "bestFor" : [ {
    "label" : "Application"
  }, {
    "label" : "Explainer"
  } ],
  "createdBy" : "Natcom Global",
  "promoted" : false,
  "language" : {
    "code" : "spa",
    "displayName" : "Spanish"
  },
  "attachments" : [ ],
  "contentWarnings" : [ {
    "id" : "5ebeb463cb699d30b550e59b",
    "label" : "Discusses drug or alcohol use",
    "_links" : {
      "self" : {
        "rel" : "self",
        "href" : "https://api.boclips.com/v1/content-warnings/5ebeb463cb699d30b550e59b"
      }
    }
  } ],
  "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"
  },
  "educationLevels" : [ {
    "code" : "4CD1",
    "label" : "Lower Primary"
  }, {
    "code" : "4CA",
    "label" : "Pre-school"
  } ],
  "cefrLevel" : "B1",
  "maxLicenseDurationYears" : 25,
  "contentCategories" : [ "ANIMATION" ],
  "restrictions" : {
    "video" : null,
    "editing" : {
      "permission" : null,
      "editingInfo" : "No editing permitted, other than removing front credits"
    },
    "territory" : {
      "type" : "NO_RESTRICTIONS",
      "territories" : null,
      "additionalTerritoryInfo" : ""
    }
  },
  "_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
    },
    "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

bestFor

Array

List of best for labels. See bestFor for payload details

promoted

Boolean

Promoted status of this video

type

String

Content type of this video

playback

Object

Video Playback resource. See playback for payload details

playback.type

String

Playback type, i.e. STREAM or YOUTUBE

playback.id

String

Id of this playback, useful for YOUTUBE type

playback.duration

String

Duration of this particular video in ISO-8601

playback._links.createPlaybackEvent.href

String

POST endpoint for a createPlaybackEvent. See more on events here

playback._links.createPlayerInteractedWithEvent.href

String

POST endpoint for a createPlayerInteractedWithEvent

playback._links.thumbnail.href

String

Thumbnail URL for the video. May be templated with thumbnailWidth

playback._links.thumbnail.templated

Boolean

Tells whether the thumbnail link is templated

playback._links.videoPreview.href

String

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

playback._links.hlsStream.href

String

URL for the Apple HLS stream. Please note this has a lifespan of 48 hours, beyond this the video will need to be retrieved again

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

bestFor.label

String

A tag label, to describe the video’s learning objective

contentWarnings

Array

Content warnings for this particular video if any. See contentWarnings for payload details

contentWarnings.id

String

ID of the content warning

contentWarnings.label

String

Label describing the content warning

educationLevels

Array

Education levels this video is suitable for. See education levels resource for more details

ageRange.label

String

Deprecated in favour of educationLevels. Age range in a human readable format

ageRange.min

Number

Deprecated in favour of educationLevels. Minimum of age range for this video

ageRange.max

Number

Deprecated in favour of educationLevels. 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)

cefrLevel

String

The CEFR level of the video (e.g C1)

contentCategories

Array

Tagged subtypes for this video (e.g Animation)

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

Relation Description

self

The video resource that was just retrieved

logInteraction

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

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

education_level

String

true

Filter by education level. Multiple values can be specified (comma separated, or by repeating the parameter). See possible values at education levels resource

age_range_min

Number

true

Deprecated in favour of education_level. Minimum age to filter from - it filters on the video age range property, and is inclusive.

age_range_max

Number

true

Deprecated in favour of education_level. Maximum age to filter to - it filters on the video age range property, and is inclusive

age_range

String

true

Deprecated in favour of education_level. Filter videos which cover at least 2 ages from a range in the video age range property.

cefr_level

String

true

Filter by CEFR level. Multiple values can be specified (comma separated, or by repeating the parameter). Possible values are: [A1, A2, B1, B2, C1, C2]

duration_facets

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

true

Override default facets for durations, see search facets.

include_education_level_facets

Boolean

true

Indicates whether to include education level facets into search results.

age_range_facets

String, e.g. 3-5

true

Deprecated. 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).

include_channel_facets

Boolean

true

Indicates whether to include channel facets into search results.

type

Enum

true

Filter responses by video type

best_for

List of strings (e.g 'explainer')

true

Filter responses by tag labels

sort_by

RELEASE_DATE

true

A key to sort the results by, currently only release_date is 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

language

String (e.g 'eng')

true

Filter by language codes (ISO 639-2 language code). Use multiple times to search for multiple values, e.g. 'language=eng&language=spa'.

ngss_code

String (eg. 'LS4')

true

Filter by NGSS code. Multiple values can be specified (comma separated, or by repeating the parameter). See possible values at retrieving all NGSS codes

ngss_grade

String (eg. 'K-2')

true

Filter by NGSS grade. Multiple values can be specified (comma separated, or by repeating the parameter). See possible values at retrieving all NGSS grades

subtype

String (eg. 'ANIMATION')

true

Filter by video subtype. Multiple values can be specified (comma separated, or by repeating the parameter). Possible values are: ['ANIMATION', 'CHALK_AND_TALK_PRESENTATION', 'DEMONSTRATION', 'DOCUMENTARY', 'HISTORICAL_ARCHIVE', 'INTERVIEW', 'LIVE_ARTS_PERFORMANCES', 'TALKING_HEAD']

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&channel=5cf140c4c1475c47f7178679&type=HISTORICAL_NEWS_ARCHIVE 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&channel=5cf140c4c1475c47f7178679&type=HISTORICAL_NEWS_ARCHIVE' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 7630

{
  "_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" : "2024-09-13T07:32:54.542638112Z",
      "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/ks/djJ8MjM5NDE2Mnz2ZY1RQXimtFHDM4FlG39TLq9SFMjCiocQxO50rxYkfGKnvvWtzKI9KLvrPash8m7JBJ8GEd-_rvbrQ8z4eJV_COq2zLFd9tvkhzDXe77OKKWRAYORjoVbZTGzDJtVjiRYUxjo6JMqim4CB1EBiBcOCT1pgFWRFkHZvGtOFdTFSg%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : null,
      "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" : "HISTORICAL_NEWS_ARCHIVE",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 3,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : "ALLOWED",
          "editingInfo" : ""
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "United States", "United Arab Emirates" ],
          "additionalTerritoryInfo" : null
        }
      },
      "_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
        }
      }
    } ],
    "facets" : {
      "subjects" : {
        "5cb499c9fd5beb428189454b" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454b",
          "name" : "Spanish",
          "score" : null
        },
        "5cb499c9fd5beb428189454d" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454d",
          "name" : "History",
          "score" : null
        },
        "5cb499c9fd5beb428189454e" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454e",
          "name" : "Chemistry",
          "score" : null
        },
        "5cb499c9fd5beb4281894553" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb4281894553",
          "name" : "Art History",
          "score" : null
        },
        "5cdd6f08123e93799efe8ad5" : {
          "hits" : 10,
          "id" : "5cdd6f08123e93799efe8ad5",
          "name" : "Theatre Tech",
          "score" : null
        }
      },
      "ageRanges" : {
        "3-5" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "5-9" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "9-11" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "11-14" : {
          "hits" : 10,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "14-16" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "16-99" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        }
      },
      "bestForTags" : {
        "Discovery" : {
          "hits" : 10,
          "id" : null,
          "name" : "Discovery",
          "score" : null
        },
        "Experience" : {
          "hits" : 10,
          "id" : null,
          "name" : "Experience",
          "score" : null
        }
      },
      "durations" : {
        "PT0S-PT2M" : {
          "hits" : 3,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "PT2M-PT5M" : {
          "hits" : 14,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "PT5M-PT10M" : {
          "hits" : 2,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "PT10M-PT20M" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        },
        "PT20M-PT24H" : {
          "hits" : 0,
          "id" : null,
          "name" : null,
          "score" : null
        }
      },
      "resourceTypes" : { },
      "videoTypes" : {
        "HISTORICAL_NEWS_ARCHIVE" : {
          "hits" : 10,
          "id" : null,
          "name" : null,
          "score" : null
        }
      },
      "channels" : { },
      "educationLevels" : { },
      "topics" : { },
      "languages" : {
        "eng" : {
          "hits" : 10,
          "id" : "eng",
          "name" : "English",
          "score" : null
        }
      },
      "cefrLevels" : { },
      "videoSubtypes" : {
        "ANIMATION" : {
          "hits" : 10,
          "id" : "ANIMATION",
          "name" : "Animation",
          "score" : null
        }
      }
    }
  },
  "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 durations, subjects and education levels

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

Search facets

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

We provide default search facets out of the box. By setting the duration_facets parameter, you can adapt this facet to meet your needs.

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 119

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

Response fields

Path Type Description

_embedded.videoTypes

Array

Video types available in the system

Video Feed

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 35189

{
  "_embedded" : {
    "videos" : [ {
      "id" : "6729f894046620578bca1a17",
      "title" : "Classroom Tutorial",
      "description" : "Classroom tutorial video",
      "additionalDescription" : null,
      "releasedOn" : "2024-11-05",
      "updatedAt" : "2024-11-05T10:55:53.751017936Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_5j85fsah",
        "duration" : "PT1M3S",
        "_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_5j85fsah/width/{thumbnailWidth}",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_5j85fsah/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_5j85fsah/format/applehttp/ks/djJ8MjM5NDE2MnxTzVFWJKR1tUX-_sDJBDd2CV0-YMVB3cuwxE5eM0jeuVNIZ8AuEX6aWsTwkELMoWodwxXFxBg1r3mr-YJZL0rjFrI3_OWV3D1ZoNmLNK8OZpweDaDdet-I__LC9yCCEw-eqD1111QyHQCX8ORrNCr2cLdHENukH9wz5KYU3mI0iA%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 10,
        "max" : 12,
        "label" : "10-12"
      },
      "bestFor" : [ ],
      "createdBy" : "CBS Sunday Morning",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "classroom", "tutorial" ],
      "type" : "NEWS",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 10,
      "contentCategories" : null,
      "restrictions" : {
        "video" : "Do not watch this video!",
        "editing" : {
          "permission" : "ALLOWED_WITH_RESTRICTIONS",
          "editingInfo" : "editing restriction 2"
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "USA" ],
          "additionalTerritoryInfo" : "territory restriction 2"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6729f894046620578bca1a17",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6729f894046620578bca1a17/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "64e72cd4e9f4585636a79795",
      "title" : "A Sense of the Numinous",
      "description" : "Rabbi Emeritus David J. Goldberg relates the irrational side of the human condition, how he has more in common with moderates of other religions than he does with extremists of his own, and the constant tensions between particularism and universalism.",
      "additionalDescription" : null,
      "releasedOn" : "2023-08-08",
      "updatedAt" : "2024-02-21T14:38:23.398420069Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_a3iv0c4t",
        "duration" : "PT4M43S",
        "_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_a3iv0c4t/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_a3iv0c4t/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_a3iv0c4t/format/applehttp/ks/djJ8MjM5NDE2MnzqcLJY8FX8uw75OLAO06SShj8Xkcu9zWABr1RI0-cO5dk2z6Xymz5EKvlmGFhtzCqF_vCGSbBCZQZaZBl6deEHM5XtqdD6oYHV-5iJO3L_LntB7RYDftGbl2yotHRnjoxcJ95yrmKf5DfMfUVFnlOROqL_bge-JvguvV4cMuVWRw%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Religious Studies", " Philosophy", " Social Studies" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 3,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : "ALLOWED",
          "editingInfo" : ""
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "United States", "United Arab Emirates" ],
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/64e72cd4e9f4585636a79795",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/64e72cd4e9f4585636a79795/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/64e72cd4e9f4585636a79795/transcript",
          "templated" : false
        }
      }
    }, {
      "id" : "64e72c30851d617a0a8c523a",
      "title" : "A Matter of Character",
      "description" : "Chinese scholar and literary translator Michael Berry (UCLA) describes differences between simplified and traditional Chinese characters and the politics associated with both.",
      "additionalDescription" : null,
      "releasedOn" : "2023-08-08",
      "updatedAt" : "2024-03-08T17:23:45.681155477Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_24cbgik6",
        "duration" : "PT3M35S",
        "_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_24cbgik6/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_24cbgik6/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_24cbgik6/format/applehttp/ks/djJ8MjM5NDE2Mnz4A6r5vk8o659jDBk9kjILF5cU1NxIGtXIkQp8tQeW_cw9_4CGgKEHpIPZiE3097DtzzkByJ_AtzLTqXliTc9Q941lXP9kAmZ7Ce_6CP8eNiXMDz7jI_h8oe5duGMOm1OrvtX0b7L1CPqttCqOlUR-9oiO_RsvZUMaLBsnS5ZAmQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Asian Studies", " Social Studies" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 3,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : "ALLOWED",
          "editingInfo" : ""
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "United States", "United Arab Emirates" ],
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/64e72c30851d617a0a8c523a",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/64e72c30851d617a0a8c523a/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "64e72baa41806223aec25e9c",
      "title" : "Arfaz test",
      "description" : "Linguist Carol Padden (UC San Diego) describes her experience as a hard of hearing child being placed in a local public school and the effect that it had on her.",
      "additionalDescription" : null,
      "releasedOn" : "2023-08-08",
      "updatedAt" : "2024-11-22T04:22:12.828068628Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_9ug1tq52",
        "duration" : "PT2M15S",
        "_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_9ug1tq52/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_9ug1tq52/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_9ug1tq52/format/applehttp/ks/djJ8MjM5NDE2MnwgMzplBWdKHD5yRQJq74TBqYX_2J6l_uCnpVq5N_fbombt1SN5HHN7PCuFmWulUhpXixQTYeuGKZzCli2bEAvk9wGoKPxB3wtsMOhyQYpRC2b3pXdOhMYmEF9ptiN7-1nmn7p8rzFCO4XKRImR2nJG2nQiHW-Y4sRA4edXDyQjfw%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Social Studies", " Education" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 3,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : "ALLOWED",
          "editingInfo" : ""
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "United States", "United Arab Emirates" ],
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/64e72baa41806223aec25e9c",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/64e72baa41806223aec25e9c/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/64e72baa41806223aec25e9c/transcript",
          "templated" : false
        }
      }
    }, {
      "id" : "64e72b06851d617a0a8c5238",
      "title" : "A Mainstream Tale",
      "description" : "Linguist Carol Padden (UC San Diego) describes her experience as a hard of hearing child being placed in a local public school and the effect that it had on her.",
      "additionalDescription" : null,
      "releasedOn" : "2023-08-08",
      "updatedAt" : "2024-02-21T08:54:00.048797746Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_fqnavi7a",
        "duration" : "PT2M15S",
        "_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_fqnavi7a/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_fqnavi7a/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_fqnavi7a/format/applehttp/ks/djJ8MjM5NDE2MnwvyaGE2j5F6LPrat6bE-3zeumee9ANprRVQa53NrKiFp1e4-tl1kZWgNcqin3AATYB5iVE78hvmrskPDxEPFKxw4sKihCk6JNqDqLHybx_bwSDMNlxKo9zbbrpG9YugxrBvBgUzaFQs0Xpql8MdKuCI_FyXrPL-3PUG5HQrkt2dg%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Social Studies", " Education" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 3,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : "ALLOWED",
          "editingInfo" : ""
        },
        "territory" : {
          "type" : "RESTRICTED",
          "territories" : [ "United States", "United Arab Emirates" ],
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/64e72b06851d617a0a8c5238",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/64e72b06851d617a0a8c5238/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "63639cc02b2c9f2fe586d904",
      "title" : "‎NASA's Curious Universe - sample",
      "description" : "Our universe is a wild and wonderful place. Join NASA astronauts, scientists and engineers on a new adventure each week — all you need is your curiosity. First-time space explorers welcome.",
      "additionalDescription" : null,
      "releasedOn" : "2020-03-31",
      "updatedAt" : "2023-11-03T16:44:32.356737991Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_5lwv33c1",
        "duration" : "PT15S",
        "_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_5lwv33c1/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_5lwv33c1/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_5lwv33c1/format/applehttp/ks/djJ8MjM5NDE2Mnwso-gFpeH7Fq9ZcbqpA8QuQDH1APq9AAEJjqbegxB7K7uSIXqOPTLRHpoQbsdXExdiE5vNDZ3F82xR9WYLf2GpHLzELLGi5_yGFFxq8PVz9fC6H23PveJmesIbCK6W6CVBbrQScNCwtOSsBTAqam-9y3JB3HgA5MflDmHYIT9zAA%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "bestFor" : [ ],
      "createdBy" : "Podcasts from NASA",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Listen", " Introducing NASA’s Curious Universe", " NASA's Curious Universe" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 5,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63639cc02b2c9f2fe586d904",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63639cc02b2c9f2fe586d904/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "6362776b2fa2665da01b2e55",
      "title" : "NASA's Curious Universe: Introducing NASA’s Curious Universe (Future Version)",
      "description" : "Our universe is a wild and wonderful place. Join NASA astronauts, scientists and engineers on a new adventure each week — all you need is your curiosity. First-time space explorers welcome.",
      "additionalDescription" : null,
      "releasedOn" : "2020-03-31",
      "updatedAt" : "2023-11-03T16:42:18.255777744Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_93homdhk",
        "duration" : "PT1M39S",
        "_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_93homdhk/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_93homdhk/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_93homdhk/format/applehttp/ks/djJ8MjM5NDE2MnyhvALtVq3tBUu3DE6JvOypI5RzsOjz2dXWn0PBRYyNhGg8qmXbgLPxOL8uAdU9k5zCh4f3RQQnAsSdvY9wHtSLrDkWU67t9qwjP69MRW0DBncGFDii531QkyItWrqkikM6DDxImvwCS8SqUQAJPRmvvXOaFxa3PoMCT3aKmrhtAQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "bestFor" : [ ],
      "createdBy" : "Podcasts from NASA",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Listen", " Introducing NASA’s Curious Universe", " NASA's Curious Universe" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 5,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6362776b2fa2665da01b2e55",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6362776b2fa2665da01b2e55/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "636248fb1689c36ea638a9e7",
      "title" : "‎NASA's Curious Universe: Our Laboratory in Space",
      "description" : "Orbiting 250 miles above Earth, astronauts aboard the International Space Station explore farther into our solar system and work on thousands of studies that will help us back here on Earth. Join ESA (European Space Agency) astronaut Samantha Cristoforetti and NASA scientist Sharmila Bhattacharya on…",
      "additionalDescription" : null,
      "releasedOn" : "2020-10-12",
      "updatedAt" : "2024-08-12T11:26:36.281311518Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_0g74elwz",
        "duration" : "PT19M",
        "_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_0g74elwz/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_0g74elwz/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_0g74elwz/format/applehttp/ks/djJ8MjM5NDE2MnzLZEPJog5cnstTgXVXvuio3C7fygOqzRvfqY6sEjQVbn3SauMFnauvyhu_ll9RLaimkBtFDbnRu_k56aaJTXj9e9C_X2X7Yv5bq7Sd7owY2RpZi-y3apE91EvEWmRpqsFcHFKXpPYExIVNvWjub0_Ov6Wpk8reeUf86_R85r-W9w%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "bestFor" : [ ],
      "createdBy" : "Podcasts from NASA",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Listen", " Our Laboratory in Space", " NASA's Curious Universe" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 5,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/636248fb1689c36ea638a9e7",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/636248fb1689c36ea638a9e7/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    }, {
      "id" : "636248fbcb42106895ebf78f",
      "title" : "‎NASA's Curious Universe: Introducing NASA’s Curious Universe Season Two",
      "description" : "Our universe is a wild and wonderful place. Join NASA astronauts, scientists and engineers on a new adventure each week — all you need is your curiosity. Go asteroid hunting, explore faraway galaxies, and watch a black hole as it begins to form. First-time space explorers welcome.",
      "additionalDescription" : null,
      "releasedOn" : "2020-10-05",
      "updatedAt" : "2024-02-21T14:38:04.886673359Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_mrxxn6jl",
        "duration" : "PT1M53S",
        "_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_mrxxn6jl/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_mrxxn6jl/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_mrxxn6jl/format/applehttp/ks/djJ8MjM5NDE2MnzBT_dk9U7PX_An4Eu4R95bWrCY93oVrppIqJx_TZYfpNzjWBMsl2bXSbbiy93Hi11eXCx2wB-kwgcxDVOoxUI_hYXvP3fqba3d8RG7qqeCVn8vnR9woQZVxDMgrO7kZeWdT6FkZSDeZYr0rTnz1cbrh5WhdV3yH9tihyY-nqfvwA%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "bestFor" : [ ],
      "createdBy" : "Podcasts from NASA",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Listen", " Introducing NASA’s Curious Universe Season Two", " NASA's Curious Universe" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 5,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78f",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78f/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78f/transcript",
          "templated" : false
        }
      }
    }, {
      "id" : "636248fbcb42106895ebf78e",
      "title" : "‎NASA's Curious Universe: We're Going to Mars!",
      "description" : "In this episode of our Curious Universe podcast, join us on a journey to the Red Planet.",
      "additionalDescription" : null,
      "releasedOn" : "2020-07-21",
      "updatedAt" : "2024-08-12T11:26:36.2682168Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_ig5np654",
        "duration" : "PT19M4S",
        "_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_ig5np654/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_ig5np654/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_ig5np654/format/applehttp/ks/djJ8MjM5NDE2MnxR6HFX3wbFm-iddl5540nxJ_NbpL_IIVnPsPCx8b6BxJkZTB2HMzNcOYR4kyce6cJcCevpSBBeevbfoi6lJFsgfiQb8hZS0aDAWBRaAsrEMW0_7WzcydXMgzJ8fhTbNJ6rgJnjJH4QJazFv7VkRiRwtc0LUEtL8y_75GVMDdEtEg%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "bestFor" : [ ],
      "createdBy" : "Podcasts from NASA",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Listen", " We're Going to Mars!", " NASA's Curious Universe" ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : 5,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : "",
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78e",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78e/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/636248fbcb42106895ebf78e/transcript",
          "templated" : false
        }
      }
    } ]
  },
  "_links" : {
    "next" : {
      "href" : "https://api.boclips.com/v1/feed/videos?cursor_id=FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZldGNoBRZ5NTJNT1dTRVFDS0pFSGhBYTN2d0pnAAAAAABrtn0WcTRpZDU4SWtUV3VINHN6RmVkeVZfdxZ5NTJNT1dTRVFDS0pFSGhBYTN2d0pnAAAAAABrtn4WcTRpZDU4SWtUV3VINHN6RmVkeVZfdxZjRklsclF2TFJWT2RUT2JfVU9uaW9BAAAAAACy6v8WQmxJX01GRnVSdi1SN1RuaGhKYXlqZxZ5NTJNT1dTRVFDS0pFSGhBYTN2d0pnAAAAAABrtn8WcTRpZDU4SWtUV3VINHN6RmVkeVZfdxZjRklsclF2TFJWT2RUT2JfVU9uaW9BAAAAAACy6wAWQmxJX01GRnVSdi1SN1RuaGhKYXlqZw==&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

Learning Outcomes, Assessment Questions

These features are still in beta and could potentially change.

Retrieving learning outcomes

List of key takeaways for the video

Data provided by this endpoint is AI-generated

Read more about our AI policy here

Path parameters

Table 1. /v1/videos/{video_id}/learning-outcomes
Parameter Description

video_id

ID of the video

HTTP request

GET /v1/videos/5c54d67ed8eafeecae2041c2/learning-outcomes HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
content-type: application/json
x-cloud-trace-context: 08bc1034258f755bf4f58353e82d36bd;o=1
date: Mon, 09 Dec 2024 11:23:16 GMT
server: Google Frontend
Content-Length: 613
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google, 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

{
  "learningOutcomes" : [ "Understand the importance of DNA replication in creating identical copies of DNA in cells.", "Describe the cell cycle and the different phases involved in DNA replication in eukaryotic cells.", "Explain the process of DNA replication, including the roles of helicase, DNA polymerase, RNA primase, and DNA ligase.", "Differentiate between the leading and lagging strands in DNA replication and how they are synthesized.", "Describe the differences in DNA replication between prokaryotic and eukaryotic cells, including the presence of multiple origins of replication in eukaryotes." ]
}

Retrieving assessment questions

List of questions that could be asked about the content of the video in an assessment

Data provided by this endpoint is AI-generated

Read more about our AI policy here

Path parameters

Table 1. /v1/videos/{video_id}/assessment-questions
Parameter Description

video_id

ID of the video

HTTP request

GET /v1/videos/5c54d67ed8eafeecae2041c2/assessment-questions HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
content-type: application/json
x-cloud-trace-context: 7edd95b1d6ce4b2aa738320163f02dcf;o=1
date: Mon, 09 Dec 2024 11:23:17 GMT
server: Google Frontend
Content-Length: 208
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google, 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

{
  "assessmentQuestions" : [ "What is DNA replication?", "Why is DNA replication important?", "How does DNA replication occur in eukaryotic cells?", "How does DNA replication occur in prokaryotic cells?" ]
}

Highlights

These features are still in beta and could potentially change.

A highlight is a segment (generally 15s-1m) of a video bit on an individual topic. Highlights are composed of the original video_id, a start_time and an end_time.

Highlights were designed to provide short, targeted intervention or explanation for example in response to getting a multiple choice answer wrong or embedded in generative AI experiences combining text and video. See our generative AI highlights demo for an example https://highlights.boclips.com/login.

To display a highlight using our video player see the "Loading a section of a video" section of the video documentation https://docs.boclips.com/docs/player-guide.html#_loading_a_section_of_a_video.

Accessing a single highlight

You can retrieve a single highlight by making a GET request using its ID. Highlights are searched for semantically, using the meaning rather than keywords of your phrase.

You can specify a version of this endpoint by passing the X-Boclips-Api-Version header in YYYY-MM-DD format. We strongly advise sending this to protect against breaking changes. The current version is 2024-04-24

"X-Boclips-Api-Version": "YYYY-MM-DD"

Path parameters

Table 1. /v1/highlights/{highlightId}
Parameter Description

highlightId

ID of the highlight

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
content-type: application/json
x-cloud-trace-context: 4d4ed7a81a9af83660fc1be30846cc67;o=1
date: Mon, 09 Dec 2024 11:23:21 GMT
server: Google Frontend
X-XSS-Protection: 0
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google, 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 2840

{
  "id" : "CLPOTj69sapco",
  "video_id" : "5f3552583241087e7a18c3d7",
  "title" : "Hydrogen as a Fuel Source",
  "start_time" : 15.0,
  "end_time" : 178.0,
  "duration" : 163.0,
  "caption" : "I It's odorless it's colorless and it's lighter than air it's also the main ingredient in the formation of stars and it contains a lot of energy How much energy try enough to power the sun its energy we want to use to power all sorts of things from cars and houses to laptops and cellphones it's hydrogen and it's the most abundant element on earth I I Well it turns out we are we already use hydrogen to power space shuttles and several car companies have built hydrogen fueled cars some are already on the road there are even hydrogen powered buses boats and airplanes but unlike other fuel sources hydrogen can't be harvested easily because hydrogen gas is very rare and I atmosphere due to its lightweight most of it escapes from earth's gravity so instead we have to make it And that can use a lot of energy One way to make it is by splitting water into hydrogen and oxygen and the setup here is designed specifically to split water into hydrogen and oxygen it's the basic process of what's called electrolysis the name of the game scientifically is how do you do that process with the minimum input of energy so that no energy is wasted while still having the reaction be fast enough so that you get enough hydrogen to use for a day or for whatever application you want the key to that question is how to make the reaction fast without applying more energy And the way to do that is to use a catalyst what a catalyst does is it accelerates the reaction without needing you to apply more additional energy that might be wasted even with the help of a catalyst electrolysis or the splitting of water into hydrogen and oxygen still requires electricity to drive the reaction and unless that electricity is green in the 1st place making hydrogen gas isn't a completely clean process the key to that means taking sunlight Converting it into electrical energy and then using that electrical energy to store in the form of chemical fuel like hydrogen and oxygen and then using those chemical fuels in a fuel cell to convert them back into electrical energy to use when the sun doesn't shine fuel cells are sort of like batteries except that as long as we keep adding hydrogen the cells will never run down or need to be recharged what we're trying to do ultimately is figure out ways to have energy come",
  "createdBy" : "Science360",
  "contentCategories" : null,
  "score" : null,
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/highlights/CLPOTj69sapco",
      "templated" : false
    },
    "video" : {
      "href" : "https://api.boclips.com/v1/videos/5f3552583241087e7a18c3d7",
      "templated" : false
    }
  }
}

A GET request against the highlight link will return a collection of highlights.

You can specify a version of this endpoint by passing the X-Boclips-Api-Version header in YYYY-MM-DD format. We strongly advise sending this to protect against breaking changes. The current version is 2024-04-24

"X-Boclips-Api-Version": "YYYY-MM-DD"

Request parameters

Parameter Type Optional Description

query

String

false

The text search query

threshold

Number

true

Minimum similarity score a clip needs to be returned between 0 and 1. Default is 0.815 which is a good balance between relevency and results. 0 will return the closest matches no matter the (lack of) relevence.

size

Number

true

The number of highlights to return, 100 by default

education_level

String

true

Filter by education level. Multiple values can be specified (comma separated). See possible values at education levels resource

channel

String

true

Filter by channel IDs (channel is the provider of the video content). Multiple values can be specified (comma separated)

subtype

String

true

Filter by video subtype. Multiple values can be specified (comma separated). Possible values are: ['ANIMATION', 'CHALK_AND_TALK_PRESENTATION', 'DEMONSTRATION', 'DOCUMENTARY', 'HISTORICAL_ARCHIVE', 'INTERVIEW', 'LIVE_ARTS_PERFORMANCES', 'TALKING_HEAD']

max_overlap

String

true

If multiple highlights come from the same video, this is the maximum they are allowed to overlap as a % (expressed as a decimal e.g. 0.2 is 20%) of the smallest video. If 1 a highlight can be a full segment of another highlight. If 0 no overlap is allowed.

hyper_relevance

Boolean

true

If true, the highlights will start at the part that is most relevant to your query. Default is false, which will return the full duration of the highlights.

HTTP request

GET /v1/highlights?query=dna HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
content-type: application/json
x-cloud-trace-context: 914b25702ace4641673b9360ede07f87;o=1
date: Mon, 09 Dec 2024 11:23:21 GMT
server: Google Frontend
X-XSS-Protection: 0
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google, 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 9349

{
  "_embedded" : {
    "highlights" : [ {
      "id" : "CLPDhc1ADQMWZ",
      "video_id" : "623187411655cc551d8a4d5d",
      "title" : "Introduction to DNA and its importance",
      "start_time" : 0.0,
      "end_time" : 11.0,
      "duration" : 11.0,
      "caption" : "DNA is central to biology as we know it. On a big level, it shapes species and how they evolve over generations. And on a small level, it's the code that keeps your body going day in and day out.",
      "createdBy" : "SciShow",
      "contentCategories" : [ "TALKING_HEAD" ],
      "score" : 0.852770865,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/highlights/CLPDhc1ADQMWZ",
          "templated" : false
        },
        "video" : {
          "href" : "https://api.boclips.com/v1/videos/623187411655cc551d8a4d5d",
          "templated" : false
        }
      }
    }, {
      "id" : "CLPmiDkL35iC9",
      "video_id" : "646e55e235fbf272f8e15d71",
      "title" : "The Fascinating World of Genetics",
      "start_time" : 3.0,
      "end_time" : 79.0,
      "duration" : 76.0,
      "caption" : "Imagine a world that's so small, so intricate, that it's invisible to the naked eye. Imagine that in this world there's a code, a blueprint, like the blueprint that's made by architects to give plans for designing A magnificent building. But this blueprint, it isn't for a regular building. It's for a masterpiece. This blueprint is weaved into every living being, guiding its growth, its structure, and its function. This world that you imagined is the fascinating world of genetics. You see, our planet is full of life, from the tallest giraffe in the African Savannah to the tiniest bacteria in your backyard. And yet, even you and me, we're all unique, but we're all bound together by a common thread. And that thread. Is DNA deoxyribonucleic acid? DNA is a molecule that carries the genetic instructions for the development, the functioning, the growth and reproduction of all known living organisms, and even many viruses. I'm talking about your eye color, your skin color, the stripes on a zebra, the shape of the leaves on a tree. DNA is like a master architect that designs and guides the building of life.",
      "createdBy" : "Interactive Biology",
      "contentCategories" : [ "TALKING_HEAD" ],
      "score" : 0.851962209,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/highlights/CLPmiDkL35iC9",
          "templated" : false
        },
        "video" : {
          "href" : "https://api.boclips.com/v1/videos/646e55e235fbf272f8e15d71",
          "templated" : false
        }
      }
    }, {
      "id" : "CLPoAf5o4gxw6",
      "video_id" : "645a56c70294dc5a98343156",
      "title" : "Kinetoplast and DNA Mesh",
      "start_time" : 152.0,
      "end_time" : 229.0,
      "duration" : 77.0,
      "caption" : "Mesh quota. But not either. Actual mesh quota. The gordoni 12 are not decorated with metallic bows. What they have is actually something more unique and fascinating. Something that changed the way we see molecules and the processes fundamental to life. The plastid signets are named after this unique chain mesh structure, it's called the kinetoplast and it's found within your mitochondria. The kinetoplast is unique, but its building blocks are not. It's just DNA. You know that double helix found in all of us, that molecule that contains the instructions for how our cells look and behave when scientists finally got to see the kinetoplast under an electron microscope? They realized that the DNA inside him does something kind of funny. It forms thousands and thousands of tiny tiny circles, along with about 25 to 50 larger circles. And these circles of DNA come together, building a structure that in many plastids looks a lot like chain mail.",
      "createdBy" : "Journey to the Microcosmos",
      "contentCategories" : [ "DOCUMENTARY" ],
      "score" : 0.848856,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/highlights/CLPoAf5o4gxw6",
          "templated" : false
        },
        "video" : {
          "href" : "https://api.boclips.com/v1/videos/645a56c70294dc5a98343156",
          "templated" : false
        }
      }
    }, {
      "id" : "CLPJ835ZZNjl6",
      "video_id" : "645a56c70294dc5a98343156",
      "title" : "RNA Editing Process",
      "start_time" : 230.0,
      "end_time" : 378.0,
      "duration" : 148.0,
      "caption" : "Scientists have done all kinds of experiments to learn more about this DNA, but one of the most important things they've learned isn't about DNA, it's about DNA's single-stranded cousin, RNA we said earlier that DNA is like an instruction manual that tells our cells. What to do? But an instruction manual is just a pile of paper. If no one is around. Parallel, therefore, within cells, there is a mechanism for reading this DNA by transcribing into a single-stranded genetic material called RNA. Messenger, you can think of this RNA as someone reading aloud or instruction manual. Then the words of this messenger RNA are translated into action, producing a protein that can serve some function in the cell. This DNA process transcribed into RNA and then translated into protein forms what many of us know as the central dogma of biology. It's beautiful, it's elegant. And it's also too simplistic for the actual appearance of life. This process is more complicated in many ways than we originally said, but we're here for the Cine tô plastids and their strange quota of DNA mesh. One of the unusual things that researchers noticed in the 1980s when studying kinetoplast DNA is that there were genes that almost encoded things that we knew they were supposed to code. In the sequence, they came up with instructions that seemed to produce a specific protein found in these organisms, but something was wrong. The mutations would change the instructions slightly, almost as if they were missing keywords or someone had deleted a step from the instruction manual. But this was in the DNA when they studied the RNA, the instructions were suddenly correct again, almost as if they had been edited to make sense. In fact, that's what researchers would call the RNA editing process. This process reappeared again and again in Cine topla cid 12. Meaningless instructions in DNA would make sense later, thanks to RNA editing, a biological process nudging the person who read the manual to correct its message. Final.",
      "createdBy" : "Journey to the Microcosmos",
      "contentCategories" : [ "DOCUMENTARY" ],
      "score" : 0.847823441,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/highlights/CLPJ835ZZNjl6",
          "templated" : false
        },
        "video" : {
          "href" : "https://api.boclips.com/v1/videos/645a56c70294dc5a98343156",
          "templated" : false
        }
      }
    }, {
      "id" : "CLPzFxmZ8Sg6u",
      "video_id" : "66c769e6591b0c4e5ffc472b",
      "title" : "What is a Virus? Characteristics and Structure",
      "start_time" : 53.0,
      "end_time" : 186.0,
      "duration" : 133.0,
      "caption" : "What is a virus? Viruses are extremely small. No, no, much smaller than that. Viruses are so small they are invisible to your eyes and require powerful electron microscopes to be able to study them. This is a picture of a virus that we will talk more about later. It's the polio virus. A single viral particle, or virin, of polio has a diameter of around 30 nanometers. Compare that to the diameter of a single strand of human hair, which is typically around 80,000 nanometers wide. Because virins are so small, it was really hard for scientists to figure out how to study them. In fact, for a long time, scientists weren't even sure what viruses were. Now that we have the technology to be able to see and study viruses, we have learned to fight them much better. Viruses don't conform to our ideas of living organisms. Viruses can't make more virus particles by themselves. They need living cells of other organisms to do that. Viruses are not made of cells like you and me. Instead, virins can be made of three possible parts, genetic material known as nucleic acid, a protein code called a capsid, and in some viruses, a lipid layer. Let's break that down. The nucleic acid at the center of a virin could be DNA or RNA. You may have heard of DNA before. It's the instruction manual for your body to develop, function, and grow. DNA is how your healthy cells reproduce. DNA is made from 2 long chains of building blocks called nucleotides. These two chains wrap together in a shape known as a double Helix. RNA is similar in that it holds genetic information and is built from a chain of nucleotides. But RNA has a single stranded structure, unlike DN as double Helix. Inside a virus, the core of DNA or RNA is protected by a capsid, a layer of protein.",
      "createdBy" : "Wonderscape",
      "contentCategories" : null,
      "score" : 0.84794569,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/highlights/CLPzFxmZ8Sg6u",
          "templated" : false
        },
        "video" : {
          "href" : "https://api.boclips.com/v1/videos/66c769e6591b0c4e5ffc472b",
          "templated" : false
        }
      }
    } ]
  }
}

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
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", "5c9e4958cbe6e54027116f8f" ],
  "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' \
    -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", "5c9e4958cbe6e54027116f8f" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454e" ],
  "discoverable" : true
}'

Example response

HTTP/1.1 201 Created
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/6756d3130e167476c3876087
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 16733

{
  "id" : "6756d3130e167476c3876087",
  "owner" : "ebd0ea21-0424-46e0-8d35-927419065b52",
  "ownerName" : null,
  "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" : "2024-04-18T17:00:52.041501664Z",
    "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/ks/djJ8MjM5NDE2Mnx488bFpPcKMyqrebJxsqpJ0dEqlh2_VwKPr7jPXA9kX2nQYTQCNdkUK7w_v1y6A-6Z1URJ5hkheqDRfeW_0qib8W2wm0Q2aGRAzYHkjo_hJ2V5dShOO6g95kb7ZGmQFSBy5h6EtHR4M7W_nSmycA95GbSCG0-bYriPVhuxbq_fZw%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5cb499c9fd5beb4281894553",
      "name" : "Art History",
      "categories" : null
    }, {
      "id" : "5cdd6f08123e93799efe8ad5",
      "name" : "Theatre Tech",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454d",
      "name" : "History",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : null
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "bestFor" : [ {
      "label" : "Application"
    }, {
      "label" : "Explainer"
    } ],
    "createdBy" : "Natcom Global",
    "promoted" : false,
    "language" : {
      "code" : "spa",
      "displayName" : "Spanish"
    },
    "attachments" : [ ],
    "contentWarnings" : [ {
      "id" : "5ebeb463cb699d30b550e59b",
      "label" : "Discusses drug or alcohol use",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/content-warnings/5ebeb463cb699d30b550e59b"
        }
      }
    } ],
    "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"
    },
    "educationLevels" : [ {
      "code" : "4CD1",
      "label" : "Lower Primary"
    }, {
      "code" : "4CA",
      "label" : "Pre-school"
    } ],
    "cefrLevel" : "B1",
    "maxLicenseDurationYears" : 25,
    "contentCategories" : [ "ANIMATION" ],
    "restrictions" : {
      "video" : null,
      "editing" : {
        "permission" : null,
        "editingInfo" : "No editing permitted, other than removing front credits"
      },
      "territory" : {
        "type" : "NO_RESTRICTIONS",
        "territories" : null,
        "additionalTerritoryInfo" : ""
      }
    },
    "_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
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  }, {
    "id" : "5c9e4958cbe6e54027116f8f",
    "title" : "Dog show",
    "description" : "Dogs at canine competition",
    "additionalDescription" : null,
    "releasedOn" : "2015-09-10",
    "updatedAt" : "2024-07-23T13:09:57.431484309Z",
    "playback" : {
      "type" : "STREAM",
      "id" : "1_6b1fl1xv",
      "duration" : "PT1M11S",
      "_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_6b1fl1xv/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
          "templated" : true
        },
        "videoPreview" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_6b1fl1xv/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
          "templated" : true
        },
        "hlsStream" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_6b1fl1xv/format/applehttp/ks/djJ8MjM5NDE2MnyMPt0p3ZFfojL8SmUukp4KKbvfDxzbtRkfBFQtig4x7N4MGAIi8AP29bp5IuU10LZy0oxjEDlLIJDS8i9OejUwPLlHEa7uocnuTS55POR1UiM1ufn77-BZ3GuGrOKKPZziVHFHpPSooe8VQuYsylaWfzi9VYIwNA0Wo-6S-9a85Q%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 3,
      "max" : 14,
      "label" : "3-14"
    },
    "bestFor" : [ ],
    "createdBy" : "Reuters Archive",
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : null,
    "keywords" : [ ],
    "type" : "NEWS",
    "educationLevels" : [ ],
    "cefrLevel" : null,
    "maxLicenseDurationYears" : null,
    "contentCategories" : [ "ANIMATION" ],
    "restrictions" : {
      "video" : null,
      "editing" : {
        "permission" : null,
        "editingInfo" : null
      },
      "territory" : {
        "type" : null,
        "territories" : null,
        "additionalTerritoryInfo" : null
      }
    },
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c9e4958cbe6e54027116f8f",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c9e4958cbe6e54027116f8f/events?logVideoInteraction=true&type={type}",
        "templated" : true
      }
    }
  } ],
  "updatedAt" : "2024-12-09T11:22:59.912Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "promotedFor" : [ ],
  "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" : [ ],
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "assets" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "video" : {
      "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" : "2024-04-18T17:00:52.041501664Z",
      "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/ks/djJ8MjM5NDE2MnwTwpSND_Cacpz2Rr39uQbpc_DSTmzVBTJxmdFzI30WgHQW4QY6IDmFwC6hDPvNy7azASwPogmbFUVstZcPWZlPcrqUHhJfE13PCKo9besPnht1wWmAZ7Q3DSrmBB4l97Su2hWcL8h76utYGLOOcZxOaAIBBYPS3JyqcZ7ClJ5cGg%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 12,
        "max" : 12,
        "label" : "12-12"
      },
      "bestFor" : [ {
        "label" : "Application"
      }, {
        "label" : "Explainer"
      } ],
      "createdBy" : "Natcom Global",
      "promoted" : false,
      "language" : {
        "code" : "spa",
        "displayName" : "Spanish"
      },
      "attachments" : [ ],
      "contentWarnings" : [ {
        "id" : "5ebeb463cb699d30b550e59b",
        "label" : "Discusses drug or alcohol use",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/content-warnings/5ebeb463cb699d30b550e59b"
          }
        }
      } ],
      "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"
      },
      "educationLevels" : [ {
        "code" : "4CD1",
        "label" : "Lower Primary"
      }, {
        "code" : "4CA",
        "label" : "Pre-school"
      } ],
      "cefrLevel" : "B1",
      "maxLicenseDurationYears" : 25,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : null,
        "editing" : {
          "permission" : null,
          "editingInfo" : "No editing permitted, other than removing front credits"
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : ""
        }
      },
      "_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
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
          "templated" : false
        }
      }
    },
    "segment" : null,
    "note" : null
  }, {
    "id" : "5c9e4958cbe6e54027116f8f",
    "video" : {
      "id" : "5c9e4958cbe6e54027116f8f",
      "title" : "Dog show",
      "description" : "Dogs at canine competition",
      "additionalDescription" : null,
      "releasedOn" : "2015-09-10",
      "updatedAt" : "2024-07-23T13:09:57.431484309Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_6b1fl1xv",
        "duration" : "PT1M11S",
        "_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_6b1fl1xv/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_6b1fl1xv/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_6b1fl1xv/format/applehttp/ks/djJ8MjM5NDE2MnyB0rEa0uZBNt1_Ps8pSOA8w47mqQX7oj-vKizmB0OVdyCe9r0kzX788RPBOx_OfxU7IBIQALHIkhg3y1FiSr4LWYleQlGay1FglA2ZNRKDpjuvkV5dnVz4_tof-F7PS27OTe_DPAnNao8Tcp7IYgl3zneV0QFgpv5F1Rw_x_Tp2Q%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 3,
        "max" : 14,
        "label" : "3-14"
      },
      "bestFor" : [ ],
      "createdBy" : "Reuters Archive",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : null,
      "keywords" : [ ],
      "type" : "NEWS",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "maxLicenseDurationYears" : null,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : null,
        "editing" : {
          "permission" : null,
          "editingInfo" : null
        },
        "territory" : {
          "type" : null,
          "territories" : null,
          "additionalTerritoryInfo" : null
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/5c9e4958cbe6e54027116f8f",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/5c9e4958cbe6e54027116f8f/events?logVideoInteraction=true&type={type}",
          "templated" : true
        }
      }
    },
    "segment" : null,
    "note" : null
  } ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087?last_updated_at=2024-12-09T11%3A22%3A59.912Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3130e167476c3876087/permissions",
      "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/6756d30c0554245f70f2b9d0 HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 4524

{
  "id" : "6756d30c0554245f70f2b9d0",
  "owner" : "ebd0ea21-0424-46e0-8d35-927419065b52",
  "ownerName" : null,
  "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,
    "bestFor" : null,
    "createdBy" : null,
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ ],
    "type" : null,
    "educationLevels" : null,
    "cefrLevel" : null,
    "maxLicenseDurationYears" : null,
    "contentCategories" : null,
    "restrictions" : 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" : "2024-12-09T11:22:52.912Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "promotedFor" : [ ],
  "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" : "6756d30c0e167476c3876085",
    "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" : [ ],
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "assets" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "video" : {
      "id" : "5c542abf5438cdbcb56df0bf",
      "title" : null,
      "description" : null,
      "additionalDescription" : null,
      "releasedOn" : null,
      "updatedAt" : null,
      "playback" : null,
      "subjects" : [ ],
      "badges" : [ ],
      "legalRestrictions" : null,
      "ageRange" : null,
      "bestFor" : null,
      "createdBy" : null,
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : null,
      "educationLevels" : null,
      "cefrLevel" : null,
      "maxLicenseDurationYears" : null,
      "contentCategories" : null,
      "restrictions" : 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
        }
      }
    },
    "segment" : null,
    "note" : null
  } ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0?last_updated_at=2024-12-09T11%3A22%3A52.912Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/6756d30c0554245f70f2b9d0/permissions",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

id

String

The ID of the collection

owner

String

The ID of the collection’s owner

ownerName

Null

The name 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

attachments[*].id

String

ID of the attachment

attachments[*].type

String

The type of the attachment: LESSON_PLAN ACTIVITY

attachments[*].description

String

Text that describes the attachment

attachments[*]._links.download.href

String

A link that points to attachment’s actual content

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

updatePermissions

PATCH requests to this URL allow to update collection permissions

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.

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/6756d2f30554245f70f2b9cc?projection=details HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 11538

{
  "id" : "6756d2f30554245f70f2b9cc",
  "owner" : "ebd0ea21-0424-46e0-8d35-927419065b52",
  "ownerName" : null,
  "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" : "2024-04-18T17:00:52.041501664Z",
    "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/ks/djJ8MjM5NDE2Mnz2nrFW5ZegaWN625y0ifFJ71H9tk4ECYxbPGCejHEk9VzmqQM_twe6TwCl4f90vPwT5E4mDuYWPrYGg9289HJ-uzIwgOlR4tAVK0ZuSsxEV0xJTrH14rQeHlHDbLfFLODUMryJJ8xsXg8t9rzo3R9yxp_iznp6sgZ3mssE1cItcQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5cb499c9fd5beb4281894553",
      "name" : "Art History",
      "categories" : null
    }, {
      "id" : "5cdd6f08123e93799efe8ad5",
      "name" : "Theatre Tech",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454d",
      "name" : "History",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : null
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "bestFor" : [ {
      "label" : "Application"
    }, {
      "label" : "Explainer"
    } ],
    "createdBy" : "Natcom Global",
    "promoted" : false,
    "language" : {
      "code" : "spa",
      "displayName" : "Spanish"
    },
    "attachments" : [ ],
    "contentWarnings" : [ {
      "id" : "5ebeb463cb699d30b550e59b",
      "label" : "Discusses drug or alcohol use",
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/content-warnings/5ebeb463cb699d30b550e59b"
        }
      }
    } ],
    "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"
    },
    "educationLevels" : [ {
      "code" : "4CD1",
      "label" : "Lower Primary"
    }, {
      "code" : "4CA",
      "label" : "Pre-school"
    } ],
    "cefrLevel" : "B1",
    "maxLicenseDurationYears" : 25,
    "contentCategories" : [ "ANIMATION" ],
    "restrictions" : {
      "video" : null,
      "editing" : {
        "permission" : null,
        "editingInfo" : "No editing permitted, other than removing front credits"
      },
      "territory" : {
        "type" : "NO_RESTRICTIONS",
        "territories" : null,
        "additionalTerritoryInfo" : ""
      }
    },
    "_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
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  } ],
  "updatedAt" : "2024-12-09T11:22:29.719Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "promotedFor" : [ ],
  "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" : "6756d2f50554245f70f2b9cd",
    "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" : [ ],
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "assets" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "video" : {
      "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" : "2024-04-18T17:00:52.041501664Z",
      "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/ks/djJ8MjM5NDE2MnzBhxhIjw8BPCuq2IkkS3rfe5-A4-sYrsbZbE32n0c1FLPdNi48WImILhQfso_9qdGWftzX7xrM_2YhVYQ8yBNWwvIkkpyFTL9fImz7MGRe-EQIs120utvrCIh7tO_qp0yWHhPdnTAw8W_o427c0yznn558AR-li7lJtW9oZnVAPQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : null
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454d",
        "name" : "History",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 12,
        "max" : 12,
        "label" : "12-12"
      },
      "bestFor" : [ {
        "label" : "Application"
      }, {
        "label" : "Explainer"
      } ],
      "createdBy" : "Natcom Global",
      "promoted" : false,
      "language" : {
        "code" : "spa",
        "displayName" : "Spanish"
      },
      "attachments" : [ ],
      "contentWarnings" : [ {
        "id" : "5ebeb463cb699d30b550e59b",
        "label" : "Discusses drug or alcohol use",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/content-warnings/5ebeb463cb699d30b550e59b"
          }
        }
      } ],
      "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"
      },
      "educationLevels" : [ {
        "code" : "4CD1",
        "label" : "Lower Primary"
      }, {
        "code" : "4CA",
        "label" : "Pre-school"
      } ],
      "cefrLevel" : "B1",
      "maxLicenseDurationYears" : 25,
      "contentCategories" : [ "ANIMATION" ],
      "restrictions" : {
        "video" : null,
        "editing" : {
          "permission" : null,
          "editingInfo" : "No editing permitted, other than removing front credits"
        },
        "territory" : {
          "type" : "NO_RESTRICTIONS",
          "territories" : null,
          "additionalTerritoryInfo" : ""
        }
      },
      "_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
        },
        "transcript" : {
          "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
          "templated" : false
        }
      }
    },
    "segment" : null,
    "note" : null
  } ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc?last_updated_at=2024-12-09T11%3A22%3A29.719Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/6756d2f30554245f70f2b9cc/permissions",
      "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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1930

{
  "_embedded" : {
    "collections" : [ {
      "id" : "61f3eac5cb21990f1662e65c",
      "owner" : "6eb42a4f-e868-4ee9-b14e-075a88174cbf",
      "ownerName" : "Contract Tests",
      "title" : "A title",
      "videos" : [ ],
      "updatedAt" : "2022-01-28T13:08:21.242Z",
      "public" : true,
      "discoverable" : true,
      "promoted" : false,
      "promotedFor" : [ ],
      "mine" : false,
      "createdBy" : "Boclips",
      "subjects" : [ ],
      "ageRange" : null,
      "description" : "Description of collection",
      "attachments" : [ ],
      "subCollections" : [ ],
      "permissions" : {
        "anyone" : "VIEW_ONLY"
      },
      "assets" : [ ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/collections/61f3eac5cb21990f1662e65c",
          "templated" : false
        },
        "bookmark" : {
          "href" : "https://api.boclips.com/v1/collections/61f3eac5cb21990f1662e65c?bookmarked=true",
          "templated" : false
        },
        "interactedWith" : {
          "href" : "https://api.boclips.com/v1/collections/61f3eac5cb21990f1662e65c/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

attachment.linkToResource

String

false

A link that points to attachment’s actual content

attachment.type

String

false

The type of the attachment. Currently we support LESSON_PLAN only

attachment.description

String

true

Text that describes the attachment

HTTP request
PATCH /v1/collections/6756d3170554245f70f2b9d4 HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json
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", "5c9e4958cbe6e54027116f8f" ],
  "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/6756d3170554245f70f2b9d4' -i -X PATCH \
    -H 'Authorization: Bearer ***' \
    -H 'Content-Type: application/json' \
    -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", "5c9e4958cbe6e54027116f8f" ],
  "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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

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. /v1/collections/{id}/videos/{video_id}
Parameter Description

id

The ID of the collection

video_id

The ID of the video

HTTP request
PUT /v1/collections/6756d2fa0e167476c387607d/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/6756d2fa0e167476c387607d/videos/5c542abf5438cdbcb56df0bf' -i -X PUT \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

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. /v1/collections/{id}/videos/{video_id}
Parameter Description

id

The ID of the collection

video_id

The ID of the video

HTTP request
DELETE /v1/collections/6756d2ed0e167476c387607a/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/6756d2ed0e167476c387607a/videos/5c542abf5438cdbcb56df0bf' -i -X DELETE \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

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/6756d3070e167476c3876084?bookmarked=true HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1164

{
  "id" : "6756d3070e167476c3876084",
  "owner" : "ebd0ea21-0424-46e0-8d35-927419065b52",
  "ownerName" : null,
  "title" : "Discoverable Boclips Collection",
  "videos" : [ ],
  "updatedAt" : "2024-12-09T11:22:47.447Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "promotedFor" : [ ],
  "mine" : false,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "This content is accessible by everyone",
  "attachments" : [ ],
  "subCollections" : [ ],
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "assets" : [ ],
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3070e167476c3876084",
      "templated" : false
    },
    "unbookmark" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3070e167476c3876084?bookmarked=false",
      "templated" : false
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/6756d3070e167476c3876084/events",
      "templated" : false
    }
  }
}

Disciplines

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

Retrieving user-relevant disciplines

By taking user context into account, only disciplines with subjects that contain non-empty video results will be returned. Subjects with empty video results are skipped, which in turn leads to omitting disciplines with no subjects.

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 2409

{
  "_embedded" : {
    "disciplines" : [ {
      "id" : "5d0921accbb0371877b252d1",
      "name" : "Humanities",
      "code" : "arts",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb4281894553",
        "name" : "Art History",
        "categories" : [ "A" ]
      }, {
        "id" : "5cdd6f08123e93799efe8ad5",
        "name" : "Theatre Tech",
        "categories" : [ "A" ]
      } ],
      "_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",
        "categories" : [ "A" ]
      }, {
        "id" : "5cb499c9fd5beb4281894567",
        "name" : "Social Studies",
        "categories" : [ "F" ]
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921adcbb0371877b252d2"
        }
      }
    }, {
      "id" : "5d0921b0cbb0371877b252d3",
      "name" : "Mathematics",
      "code" : "mathematics",
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : [ "A" ]
      } ],
      "_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",
        "categories" : [ "A", "D" ]
      }, {
        "id" : "5e70ae4b7cdd5a3b586cb8e8",
        "name" : "Your Dad",
        "categories" : [ "C" ]
      }, {
        "id" : "5cb499c9fd5beb428189455e",
        "name" : "French",
        "categories" : [ "C" ]
      }, {
        "id" : "5cb499c9fd5beb4281894561",
        "name" : "German",
        "categories" : [ "C" ]
      } ],
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/disciplines/5d0921b4cbb0371877b252d6"
        }
      }
    } ]
  },
  "_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

Relation Description

self

The discipline resource that was just retrieved

Retrieving all disciplines

All existing disciplines with all their subjects will be returned, regardless of user context.

HTTP request

GET /v1/disciplines?visibility=all HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Subjects

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

Retrieving user-relevant subjects

By taking user context into account, only subjects that contain non-empty video results will be returned. Subjects with empty video results are skipped.

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 2663

{
  "_embedded" : {
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : [ "A", "D" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454b",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454d",
      "name" : "History",
      "categories" : [ "A" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454d",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : [ "A" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454e",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894553",
      "name" : "Art History",
      "categories" : [ "A" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894553",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189455e",
      "name" : "French",
      "categories" : [ "C" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189455e",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894561",
      "name" : "German",
      "categories" : [ "C" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894561",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894567",
      "name" : "Social Studies",
      "categories" : [ "F" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894567",
          "templated" : false
        }
      }
    }, {
      "id" : "5cdd6f08123e93799efe8ad5",
      "name" : "Theatre Tech",
      "categories" : [ "A" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cdd6f08123e93799efe8ad5",
          "templated" : false
        }
      }
    }, {
      "id" : "5e70ae4b7cdd5a3b586cb8e8",
      "name" : "Your Dad",
      "categories" : [ "C" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5e70ae4b7cdd5a3b586cb8e8",
          "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[].categories

Array

Thema subject categories

_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

Retrieving all subjects

All existing subjects will be returned, regardless of user context.

HTTP request

GET /v1/subjects?visibility=all HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

__

Curriculum

We are constantly aligning our content to existing curricula standards.

Next Generation Science Standards (NGSS)

NGSS are K–12 science content standards. Standards set the expectations for what students should know and be able to do. To read more, go to: https://www.nextgenscience.org/

Retrieving all supported NGSS codes

All existing codes with their content area will be returned.

HTTP request
GET /v1/curriculum/ngss/codes HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/curriculum/ngss/codes' -i -X GET \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 3035

{
  "_embedded" : [ {
    "code" : "PS1",
    "contentArea" : "Matter and its Interactions",
    "themaCategories" : {
      "defaults" : [ "PHD", "PN", "YPMP5" ],
      "customByGrade" : {
        "HS" : [ "PHD", "PN" ]
      }
    }
  }, {
    "code" : "PS2",
    "contentArea" : "Motion and Stability: Forces and Interactions",
    "themaCategories" : {
      "defaults" : [ "PHDB", "YPMP5" ],
      "customByGrade" : {
        "HS" : [ "PHDB" ]
      }
    }
  }, {
    "code" : "PS3",
    "contentArea" : "Energy",
    "themaCategories" : {
      "defaults" : [ "PHDY", "PHP", "RNFY", "THV", "YPMP5" ],
      "customByGrade" : {
        "HS" : [ "PHDY", "PHP", "RNFY", "THV" ]
      }
    }
  }, {
    "code" : "PS4",
    "contentArea" : "Waves and their Applications in Technologies for Information Transfer",
    "themaCategories" : {
      "defaults" : [ "PHDS", "U", "PDR", "PNRL", "YPMP5", "YPMT6", "YNTC" ],
      "customByGrade" : {
        "HS" : [ "PHDS", "U", "PDR", "PNRL" ]
      }
    }
  }, {
    "code" : "ESS1",
    "contentArea" : "Earth's Place in the Universe",
    "themaCategories" : {
      "defaults" : [ "PGS", "RB", "WNR", "YPMP6", "YNNZ", "YPMP51" ],
      "customByGrade" : {
        "HS" : [ "PGS", "RB", "WNR" ]
      }
    }
  }, {
    "code" : "ESS2",
    "contentArea" : "Earth's Systems",
    "themaCategories" : {
      "defaults" : [ "RB", "RGB", "YPMP6", "YNNV", "YNNT" ],
      "customByGrade" : {
        "HS" : [ "RB", "RGB" ]
      }
    }
  }, {
    "code" : "ESS3",
    "contentArea" : "Earth and Human Activity",
    "themaCategories" : {
      "defaults" : [ "RN", "JBFF", "JPFA", "YPMP6", "YXZG" ],
      "customByGrade" : {
        "HS" : [ "RN", "JBFF", "JPFA" ]
      }
    }
  }, {
    "code" : "LS1",
    "contentArea" : "From Molecules to Organisms: Structures and Processes",
    "themaCategories" : {
      "defaults" : [ "PSD", "PSF", "PSG", "PSAF", "YPMP1" ],
      "customByGrade" : {
        "HS" : [ "PSD", "PSF", "PSG", "PSAF" ]
      }
    }
  }, {
    "code" : "LS2",
    "contentArea" : "Ecosystems: Interactions, Energy, and Dynamics",
    "themaCategories" : {
      "defaults" : [ "RNKH", "PSAF", "RNC", "RNA", "YNN", "YPMP6" ],
      "customByGrade" : {
        "HS" : [ "RNKH", "PSAF", "RNC", "RNA" ]
      }
    }
  }, {
    "code" : "LS3",
    "contentArea" : "Heredity: Inheritance and Variation of Traits",
    "themaCategories" : {
      "defaults" : [ "PSAK", "YPMP1", "YNTA" ],
      "customByGrade" : {
        "HS" : [ "PSAK" ]
      }
    }
  }, {
    "code" : "LS4",
    "contentArea" : "Biological Evolution: Unity and Diversity",
    "themaCategories" : {
      "defaults" : [ "PSAJ", "RNCB", "PSXE", "YPMP1", "YNN" ],
      "customByGrade" : {
        "HS" : [ "PSAJ", "RNCB", "PSXE" ]
      }
    }
  }, {
    "code" : "ETS1",
    "contentArea" : "Engineering Design",
    "themaCategories" : {
      "defaults" : [ "TBD", "TBC", "TBX", "TBY", "YPMT", "YNTG" ],
      "customByGrade" : {
        "HS" : [ "TBD", "TBC", "TBX" ]
      }
    }
  } ]
}
Response fields
Path Type Description

_embedded[].code

String

NGSS code value

_embedded[].contentArea

String

Content area associated to the NGSS code

Retrieving all supported NGSS grades

All supported grades with the description of classes that fall under them will be returned.

HTTP request
GET /v1/curriculum/ngss/grades HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/curriculum/ngss/grades' -i -X GET \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 469

{
  "_embedded" : [ {
    "grade" : "K-2",
    "description" : "Kindergarten to class 2",
    "educationLevels" : [ "4CD1" ]
  }, {
    "grade" : "3-5",
    "description" : "Classes 3 to 5",
    "educationLevels" : [ "4CD2" ]
  }, {
    "grade" : "MS",
    "description" : "Middle school (classes 6 to 8)",
    "educationLevels" : [ "4CF" ]
  }, {
    "grade" : "HS",
    "description" : "High school (classes 9 to 12)",
    "educationLevels" : [ "4CL", "4CN" ]
  } ]
}
Response fields
Path Type Description

_embedded[].grade

String

NGSS grade value

_embedded[].description

String

Classes supported in the NGSS grade

Education Levels

Allow identifying the intended user group, e.g. primary school, secondary school, higher education, etc.

This resource can also be used to filter by education levels.

Retrieving all education levels

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 836

{
  "_embedded" : {
    "levels" : [ {
      "code" : "4C",
      "label" : "All ages"
    }, {
      "code" : "4CA",
      "label" : "Pre-school"
    }, {
      "code" : "4CD1",
      "label" : "Lower Primary"
    }, {
      "code" : "4CD2",
      "label" : "Upper Primary"
    }, {
      "code" : "4CF",
      "label" : "Middle and Preparatory"
    }, {
      "code" : "4CL",
      "label" : "Secondary"
    }, {
      "code" : "4CT",
      "label" : "Higher education"
    }, {
      "code" : "4CTB",
      "label" : "Undergraduate"
    }, {
      "code" : "4CTM",
      "label" : "Graduate and Post-Graduate"
    }, {
      "code" : "4CN",
      "label" : "Advanced Secondary"
    }, {
      "code" : "4CP",
      "label" : "Vocational and Professional"
    }, {
      "code" : "4CX",
      "label" : "Adult Education"
    } ]
  }
}

Response fields

Path Type Description

_embedded.levels[].code

String

Code of the education level, can be used for filtering

_embedded.levels[].label

String

Human readable education level name

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1721

{
  "_embedded" : {
    "tags" : [ {
      "id" : "5d3ac0175b3f3b7ba335e104",
      "label" : "Application",
      "userId" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/tags/5d3ac0175b3f3b7ba335e104"
        }
      }
    }, {
      "id" : "5d3ac0185b3f3b7ba335e105",
      "label" : "Experience",
      "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" : "Discovery",
      "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

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 759

{
  "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" : "ANIMATION",
    "label" : "Animation"
  } ],
  "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

Request parameters

Parameter Type Optional Description

page

Integer

true

Zero-index based page number, first page by default

size

Integer

true

Channels page size, 10000 by default

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
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Encoding: gzip
Content-Type: application/hal+json
Referrer-Policy: no-referrer
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 152842

{
  "_embedded" : {
    "channels" : [ {
      "id" : "64d0cadad9c95c59623e86ae",
      "name" : "111111111111",
      "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/64d0cadad9c95c59623e86ae"
        }
      }
    }, {
      "id" : "64d0c860d9c95c59623e86ad",
      "name" : "123",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "HISTORICAL_NEWS_ARCHIVE" ],
      "contentType" : "HISTORICAL_NEWS_ARCHIVE",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/64d0c860d9c95c59623e86ad"
        }
      }
    }, {
      "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" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : "64d0cc07b94f2a3683bde1df",
      "name" : "32111",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : null,
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "HISTORICAL_NEWS_ARCHIVE" ],
      "contentType" : "HISTORICAL_NEWS_ARCHIVE",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/64d0cc07b94f2a3683bde1df"
        }
      }
    }, {
      "id" : "5cfea7d18ce44c52e6e33b3c",
      "name" : "Ab Dav Research",
      "legalRestriction" : {
        "id" : "5d976e9c138a17514040baca",
        "text" : "Some dummy restrictions",
        "_links" : {
          "self" : {
            "rel" : "self",
            "href" : "https://api.boclips.com/v1/legal-restrictions/5d976e9c138a17514040baca"
          }
        }
      },
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "eng",
        "name" : "English"
      },
      "notes" : null,
      "contentTypes" : [ "HISTORICAL_NEWS_ARCHIVE" ],
      "contentType" : "HISTORICAL_NEWS_ARCHIVE",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cf140c4c1475c47f7178679"
        }
      }
    }, {
      "id" : "5cfea8338ce44c52e6e33dae",
      "name" : "AQA",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "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/5cfea84d8ce44c52e6e33e5a"
        }
      }
    }, {
      "id" : "5cfea89a8ce44c52e6e34049",
      "name" : "Barristan Selmy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89a8ce44c52e6e34049"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f09",
      "name" : "BBC",
      "legalRestriction" : null,
      "description" : "tedst",
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "spa",
        "name" : "Spanish"
      },
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea88f8ce44c52e6e33ff4"
        }
      }
    }, {
      "id" : "5cfea86a8ce44c52e6e33f0c",
      "name" : "BBC News",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "abk",
        "name" : "Abkhazian"
      },
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9318ce44c52e6e343cd"
        }
      }
    }, {
      "id" : "5cfe8ab3336c6d2d0aa7c47b",
      "name" : "BBC Teach",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "abk",
        "name" : "Abkhazian"
      },
      "notes" : null,
      "contentTypes" : [ "HISTORICAL_NEWS_ARCHIVE" ],
      "contentType" : "HISTORICAL_NEWS_ARCHIVE",
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "abk",
        "name" : "Abkhazian"
      },
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea4528ce44c52e6e32702"
        }
      }
    }, {
      "id" : "620ce8c5ef54676e3bda78cd",
      "name" : "Channel Test Search 1",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "spa",
        "name" : "Spanish"
      },
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/620ce8c5ef54676e3bda78cd"
        }
      }
    }, {
      "id" : "5cfea9958ce44c52e6e34638",
      "name" : "Chungdahm Learning",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "afr",
        "name" : "Afrikaans"
      },
      "notes" : "kkk",
      "contentTypes" : [ "HISTORICAL_NEWS_ARCHIVE" ],
      "contentType" : "HISTORICAL_NEWS_ARCHIVE",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8c0a336c6d2d0aa7cbf3"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e34625",
      "name" : "ColdFusion",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea7d38ce44c52e6e33b55"
        }
      }
    }, {
      "id" : "62b58c94f34caf7bcb955e9a",
      "name" : "Cristina-test",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "eng",
        "name" : "English"
      },
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/62b58c94f34caf7bcb955e9a"
        }
      }
    }, {
      "id" : "5cfea8428ce44c52e6e33e12",
      "name" : "Cult of Pedagogy",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea89b8ce44c52e6e34052"
        }
      }
    }, {
      "id" : "63d1171808335c5b58b9666d",
      "name" : "Harsha - test",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "eng",
        "name" : "English"
      },
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/63d1171808335c5b58b9666d"
        }
      }
    }, {
      "id" : "5cfea8178ce44c52e6e33cfe",
      "name" : "HarvardX",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : [ "NEWS" ],
      "contentType" : "NEWS",
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "spa",
        "name" : "Spanish"
      },
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea8208ce44c52e6e33d37"
        }
      }
    }, {
      "id" : "6362393bcb42106895ebf76e",
      "name" : "Podcasts from NASA",
      "legalRestriction" : null,
      "description" : "Test for Hackathon",
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "eng",
        "name" : "English"
      },
      "notes" : null,
      "contentTypes" : [ "INSTRUCTIONAL" ],
      "contentType" : "INSTRUCTIONAL",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/6362393bcb42106895ebf76e"
        }
      }
    }, {
      "id" : "63623cb8cb42106895ebf771",
      "name" : "Podcasts from Youth Radio",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/63623cb8cb42106895ebf771"
        }
      }
    }, {
      "id" : "5cf140c4c1475c47f7178682",
      "name" : "Press Association",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfe8ab2336c6d2d0aa7c479"
        }
      }
    }, {
      "id" : "5cfea9938ce44c52e6e3461f",
      "name" : "Stock Video - 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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : {
        "code" : "bel",
        "name" : "Belarusian"
      },
      "notes" : null,
      "contentTypes" : [ "STOCK" ],
      "contentType" : "STOCK",
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5cfea9938ce44c52e6e3461f"
        }
      }
    }, {
      "id" : "5cfea86b8ce44c52e6e33f13",
      "name" : "Stonewall | Acceptance Without Exception",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/5d5c231dd6c49b7f5a740fbc"
        }
      }
    }, {
      "id" : "62a6eed573f2db722e7de4bb",
      "name" : "Streaming-test",
      "legalRestriction" : null,
      "description" : "pawel channel description",
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "language" : null,
      "notes" : null,
      "contentTypes" : null,
      "contentType" : null,
      "oneLineDescription" : null,
      "_links" : {
        "self" : {
          "rel" : "self",
          "href" : "https://api.boclips.com/v1/channels/62a6eed573f2db722e7de4bb"
        }
      }
    }, {
      "id" : "5cfea8998ce44c52e6e3403b",
      "name" : "Tate",
      "legalRestriction" : null,
      "description" : null,
      "contentCategories" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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" : [ {
        "key" : "ANIMATION",
        "label" : "Animation"
      } ],
      "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

Alignments

We are constantly aligning our content to existing curricula standards, eg. to NGSS, OpenStax and Common Core. The alignments follow the hierarchy below:

  Provider
  |_ Types
      |_ Themes
          |_ Topics
              |_ Targets
                  |_ Videos

An example alignment could be:

  OpenStax
  |_ Business
      |_ Entrepreneurship
          |_ Chapter 1: The Entrepreneurial Perspective
              |_ 1.1 Entrepreneurship Today
                  |_ (Video) Entrepreneurship Opportunity

Retrieving providers and their types

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 2149

{
  "_embedded" : {
    "providers" : [ {
      "name" : "Common Core Math",
      "types" : [ "Elementary School", "Middle School", "High School" ],
      "logoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/common-core-math/common-core-math-big-logo.png",
      "defaultThemeLogoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/common-core-math/common-core-math-theme-logo.jpg",
      "description" : "Develop student math skills and build proficiency with our curated math collection.",
      "navigationPath" : "common-core-math",
      "_links" : {
        "themes" : {
          "href" : "https://api.boclips.com/v1/alignments/common-core-math/themes",
          "templated" : false
        }
      }
    }, {
      "name" : "NGSS",
      "types" : [ "Elementary School", "Middle School", "High School", "Teacher Resources" ],
      "logoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/ngss/ngss-big-logo.png",
      "defaultThemeLogoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/ngss/ngss-theme-logo.png",
      "description" : "Foster student curiosity and exploration with our hand-picked science selection.",
      "navigationPath" : "ngss",
      "_links" : {
        "themes" : {
          "href" : "https://api.boclips.com/v1/alignments/ngss/themes",
          "templated" : false
        }
      }
    }, {
      "name" : "OpenStax",
      "types" : [ "Business", "College Success", "High School", "Humanities", "Math", "Science", "Social Science" ],
      "logoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/openstax/openstax_ally_logo.png",
      "defaultThemeLogoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/openstax/OSX-ALLY-Blue-RGB-150dpi.png",
      "description" : "Amplify students' learning experience with videos curated for your ebook.",
      "navigationPath" : "openstax",
      "_links" : {
        "themes" : {
          "href" : "https://api.boclips.com/v1/alignments/openstax/themes",
          "templated" : false
        }
      }
    } ]
  }
}

Response fields

Path Type Description

_embedded.providers[].name

String

Name of the curriculum or publisher

_embedded.providers[].types

Array

The disciplines or school levels available by provider

_embedded.providers[]._links

Object

HAL links for the resource

Retrieving all available themes by a provider

Currently supported providers:

Provider Provider ID

OpenStax

openstax

Next Generation Science Standards

ngss

Common Core Math

common-core-math

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1221

{
  "_embedded" : {
    "themes" : [ {
      "id" : "63f794aff679ef2d70967014",
      "provider" : "ngss",
      "title" : "TEST_THEME",
      "type" : "Math",
      "topics" : [ {
        "index" : 0,
        "title" : "The Chapter Two",
        "targets" : [ {
          "index" : 0,
          "title" : "Chapter Overview",
          "videoIds" : [ "5c542ab85438cdbcb56ddce6" ]
        } ]
      } ],
      "logoUrl" : "",
      "_links" : {
        "_self" : {
          "rel" : "_self",
          "href" : "https://api.boclips.com/v1/alignments/ngss/themes/63f794aff679ef2d70967014"
        }
      }
    }, {
      "id" : "63fe43b7b178c163a722a7a5",
      "provider" : "ngss",
      "title" : "TEST_THEME",
      "type" : "Math",
      "topics" : [ {
        "index" : 0,
        "title" : "The Chapter Two",
        "targets" : [ {
          "index" : 0,
          "title" : "Chapter Overview",
          "videoIds" : [ "5c542ab85438cdbcb56ddce6", "64457cb861225b5c1f0592fe" ]
        } ]
      } ],
      "logoUrl" : "",
      "_links" : {
        "_self" : {
          "rel" : "_self",
          "href" : "https://api.boclips.com/v1/alignments/ngss/themes/63fe43b7b178c163a722a7a5"
        }
      }
    } ]
  }
}

Response fields

Path Type Description

_embedded.themes[].id

String

ID of the theme

_embedded.themes[].provider

String

Name of the curriculum or publisher

_embedded.themes[]._links

Object

HAL links for the resource

_embedded.themes[].type

String

The discipline or school level

_embedded.themes[].title

String

The book or specific grade level

_embedded.themes[].topics[].index

Number

Recommended order of the topic

_embedded.themes[].topics[].title

String

The chapter or cluster name

_embedded.themes[].topics[].targets[].index

Number

Recommended order of the target

_embedded.themes[].topics[].targets[].title

String

The section or standard name

_embedded.themes[].topics[].targets[].videoIds

Array

Videos aligned to the target

Retrieving a Theme by provider and by id

HTTP request

GET /v1/alignments/openstax/themes/62eba02f51ecf2a9306c85ef HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 18051

{
  "id" : "62eba02f51ecf2a9306c85ef",
  "provider" : "openstax",
  "title" : "Algebra 4 6",
  "type" : "Math",
  "topics" : [ {
    "index" : 0,
    "title" : "Chapter 1: The Entrepreneurial Perspective",
    "targets" : [ {
      "index" : 0,
      "title" : "1.1 Entrepreneurship Today",
      "videoIds" : [ "5c7829a75c56167742815cf6" ],
      "videos" : [ {
        "id" : "5c7829a75c56167742815cf6",
        "title" : "Dogs compete ahead of 700km sled race",
        "description" : "LEAD IN: ",
        "additionalDescription" : null,
        "releasedOn" : "2019-02-25",
        "updatedAt" : "2024-09-13T07:31:44.549139299Z",
        "playback" : {
          "type" : "STREAM",
          "id" : "1_6nk09lm7",
          "duration" : "PT4M53S",
          "referenceId" : null,
          "maxResolutionAvailable" : null,
          "_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_6nk09lm7/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
              "templated" : true
            },
            "videoPreview" : {
              "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_6nk09lm7/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
              "templated" : true
            },
            "hlsStream" : {
              "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_6nk09lm7/format/applehttp/ks/djJ8MjM5NDE2Mnz-tx5vk4QQRsc2WJ2FVcQBhTvTgBfEcnu3oZ_ZD2LslRRSlTPyBeM2akjOzB1SwZblagA-4iiHVrYq4wL6J7wFhIr-8qPB0BFmw796gCx0N-5tjMDZ9j2kin0enRS-9uP76cc21GORHqzjzpq_mhlKXxxynu2h4KTfbu458XxQHQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
              "templated" : false
            }
          }
        },
        "subjects" : [ ],
        "badges" : [ "ad-free" ],
        "legalRestrictions" : "",
        "ageRange" : {
          "min" : 11,
          "max" : 14,
          "label" : "11-14"
        },
        "bestFor" : [ {
          "label" : "Experience"
        }, {
          "label" : "Discovery"
        } ],
        "createdBy" : "AP",
        "promoted" : null,
        "language" : {
          "code" : "eng",
          "displayName" : "English"
        },
        "attachments" : [ ],
        "contentWarnings" : null,
        "keywords" : [ "World region", "Europe", "Eastern Europe", "Sled dog racing", "Continent", "Sports", "Lifestyle", "Russia", "Social affairs", "Travel", "Cultures", "Animals", "Nation", "Dogs" ],
        "type" : "HISTORICAL_NEWS_ARCHIVE",
        "channel" : null,
        "channelId" : null,
        "channelVideoId" : null,
        "captionStatus" : null,
        "isVoiced" : null,
        "taxonomy" : null,
        "transcriptRequested" : null,
        "deactivated" : null,
        "educationLevels" : [ ],
        "cefrLevel" : null,
        "maxLicenseDurationYears" : 3,
        "contentCategories" : [ "ANIMATION" ],
        "restrictions" : {
          "video" : "",
          "editing" : {
            "permission" : "ALLOWED",
            "editingInfo" : ""
          },
          "territory" : {
            "type" : "RESTRICTED",
            "territories" : [ "United States", "United Arab Emirates" ],
            "additionalTerritoryInfo" : null
          }
        },
        "_links" : {
          "self" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6",
            "templated" : false
          },
          "logInteraction" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6/events?logVideoInteraction=true&type={type}",
            "templated" : true
          },
          "transcript" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6/transcript",
            "templated" : false
          }
        }
      } ]
    }, {
      "index" : 1,
      "title" : "1.2 Entrepreneurial Vision and Goals",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "1.3 The Entrepreneurial Mindset",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 1,
    "title" : "Chapter 2: The Entrepreneurial Journey and Pathways",
    "targets" : [ {
      "index" : 0,
      "title" : "2.1 Overview of the Entrepreneurial Journey",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "2.2 The Process of Becoming an Entrepreneur",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "2.3 Entrepreneurial Pathways",
      "videoIds" : [ "5c7829a75c56167742815cf6" ],
      "videos" : [ {
        "id" : "5c7829a75c56167742815cf6",
        "title" : "Dogs compete ahead of 700km sled race",
        "description" : "LEAD IN: ",
        "additionalDescription" : null,
        "releasedOn" : "2019-02-25",
        "updatedAt" : "2024-09-13T07:31:44.549139299Z",
        "playback" : {
          "type" : "STREAM",
          "id" : "1_6nk09lm7",
          "duration" : "PT4M53S",
          "referenceId" : null,
          "maxResolutionAvailable" : null,
          "_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_6nk09lm7/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
              "templated" : true
            },
            "videoPreview" : {
              "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_6nk09lm7/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
              "templated" : true
            },
            "hlsStream" : {
              "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_6nk09lm7/format/applehttp/ks/djJ8MjM5NDE2Mnz-tx5vk4QQRsc2WJ2FVcQBhTvTgBfEcnu3oZ_ZD2LslRRSlTPyBeM2akjOzB1SwZblagA-4iiHVrYq4wL6J7wFhIr-8qPB0BFmw796gCx0N-5tjMDZ9j2kin0enRS-9uP76cc21GORHqzjzpq_mhlKXxxynu2h4KTfbu458XxQHQ%3D%3D/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
              "templated" : false
            }
          }
        },
        "subjects" : [ ],
        "badges" : [ "ad-free" ],
        "legalRestrictions" : "",
        "ageRange" : {
          "min" : 11,
          "max" : 14,
          "label" : "11-14"
        },
        "bestFor" : [ {
          "label" : "Experience"
        }, {
          "label" : "Discovery"
        } ],
        "createdBy" : "AP",
        "promoted" : null,
        "language" : {
          "code" : "eng",
          "displayName" : "English"
        },
        "attachments" : [ ],
        "contentWarnings" : null,
        "keywords" : [ "World region", "Europe", "Eastern Europe", "Sled dog racing", "Continent", "Sports", "Lifestyle", "Russia", "Social affairs", "Travel", "Cultures", "Animals", "Nation", "Dogs" ],
        "type" : "HISTORICAL_NEWS_ARCHIVE",
        "channel" : null,
        "channelId" : null,
        "channelVideoId" : null,
        "captionStatus" : null,
        "isVoiced" : null,
        "taxonomy" : null,
        "transcriptRequested" : null,
        "deactivated" : null,
        "educationLevels" : [ ],
        "cefrLevel" : null,
        "maxLicenseDurationYears" : 3,
        "contentCategories" : [ "ANIMATION" ],
        "restrictions" : {
          "video" : "",
          "editing" : {
            "permission" : "ALLOWED",
            "editingInfo" : ""
          },
          "territory" : {
            "type" : "RESTRICTED",
            "territories" : [ "United States", "United Arab Emirates" ],
            "additionalTerritoryInfo" : null
          }
        },
        "_links" : {
          "self" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6",
            "templated" : false
          },
          "logInteraction" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6/events?logVideoInteraction=true&type={type}",
            "templated" : true
          },
          "transcript" : {
            "href" : "https://api.boclips.com/v1/videos/5c7829a75c56167742815cf6/transcript",
            "templated" : false
          }
        }
      } ]
    }, {
      "index" : 3,
      "title" : "2.4 Frameworks to Inform Your Entrepreneurial Path",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 2,
    "title" : "Chapter 3: The Ethical and Social Responsibilities of Entrepreneurs",
    "targets" : [ {
      "index" : 0,
      "title" : "3.1 The Ethical and Social Responsibilities of Entrepreneurs",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "3.2 Ethical and Legal Issues in Entrepreneurship",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "3.3 Corporate Social Responsibility and Social Entrepreneurship",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "3.4 Developing a Workplace Culture of Ethical Excellence and Accountability",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 3,
    "title" : "Chapter 4: Creativity, Innovation, and Invention",
    "targets" : [ {
      "index" : 0,
      "title" : "4.1 Tools for Creativity and Innovation",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "4.2 Creativity, Innovation, and Invention: How They Differ",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "4.3 Developing Ideas, Innovations, and Inventions",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 4,
    "title" : "Chapter 5: Identifying Entrepreneurial Opportunity",
    "targets" : [ {
      "index" : 0,
      "title" : "5.1 Entrepreneurial Opportunity",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "5.2 Researching Potential Business Opportunities",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "5.3 Competitive Analysis",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 5,
    "title" : "Chapter 6: Problem Solving and Need Recognition Techniques",
    "targets" : [ {
      "index" : 0,
      "title" : "6.1 Problem Solving to Find Entrepreneurial Solutions",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "6.2 Creative Problem-Solving Process",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "6.3 Design Thinking",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "6.4 Lean Processes",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 6,
    "title" : "Chapter 7: Telling Your Entrepreneurial Story and Pitching the Idea",
    "targets" : [ {
      "index" : 0,
      "title" : "7.1 Clarifying Your Vision, Mission, and Goals",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "7.2 Sharing Your Entrepreneurial Story",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "7.3 Developing Pitches for Various Audiences and Goals",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "7.4 Protecting Your Idea and Polishing the Pitch through Feedback",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 7,
    "title" : "Chapter 8: Entrepreneurial Marketing and Sales",
    "targets" : [ {
      "index" : 0,
      "title" : "8.1 Entrepreneurial Marketing and the Marketing Mix",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "8.2 Market Research, Market Opportunity Recognition, and Target Market",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "8.3 Marketing Techniques and Tools for Entrepreneurs",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "8.4 Entrepreneurial Branding",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 4,
      "title" : "8.5 Marketing Strategy and the Marketing Plan",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 5,
      "title" : "8.6 Sales and Customer Service",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 8,
    "title" : "Chapter 9: Entrepreneurial Finance and Accounting",
    "targets" : [ {
      "index" : 0,
      "title" : "9.1 Overview of Entrepreneurial Finance and Accounting Strategies",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "9.2 Special Funding Strategies",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "9.3 Accounting Basics for Entrepreneurs",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "9.4 Developing Startup Financial Statements and Projections",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 9,
    "title" : "Chapter 10: Launch for Growth to Success",
    "targets" : [ {
      "index" : 0,
      "title" : "10.1 Launching the Imperfect Business: Lean Startup",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "10.2 Why Early Failure Can Lead to Success Later",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "10.3 The Challenging Truth about Business Ownership",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "10.4 Managing, Following, and Adjusting the Initial Plan",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 4,
      "title" : "10.5 Growth: Signs, Pains, and Cautions",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 10,
    "title" : "Chapter 11: Business Model and Plan",
    "targets" : [ {
      "index" : 0,
      "title" : "11.1 Avoiding the “Field of Dreams” Approach",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "11.2 Designing the Business Model",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "11.3 Conducting a Feasibility Analysis",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "11.4 The Business Plan",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 11,
    "title" : "Chapter 12: Building Networks and Foundations",
    "targets" : [ {
      "index" : 0,
      "title" : "12.1 Building and Connecting to Networks",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "12.3 Designing a Startup Operational Plan",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 12,
    "title" : "Chapter 13: Business Structure Options: Legal, Tax, and Risk Issues",
    "targets" : [ {
      "index" : 0,
      "title" : "13.1 Business Structures: Overview of Legal and Tax Considerations",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "13.2 Corporations",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "13.3 Partnerships and Joint Ventures",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "13.4 Limited Liability Companies",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 4,
      "title" : "13.6 Additional Considerations: Capital Acquisition, Business Domicile, and Technology",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 5,
      "title" : "13.7 Mitigating and Managing Risks",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 13,
    "title" : "Chapter 14: Fundamentals of Resource Planning",
    "targets" : [ {
      "index" : 0,
      "title" : "14.1 Types of Resources",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "14.2 Using the PEST Framework to Assess Resource Needs",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "14.3 Managing Resources over the Venture Life Cycle",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  }, {
    "index" : 14,
    "title" : "Chapter 15: Next Steps",
    "targets" : [ {
      "index" : 0,
      "title" : "15.1 Launching Your Venture",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 1,
      "title" : "15.2 Making Difficult Business Decisions in Response to Challenges",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 2,
      "title" : "15.3 Seeking Help or Support",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 3,
      "title" : "15.4 Now What? Serving as a Mentor, Consultant, or Champion",
      "videoIds" : [ ],
      "videos" : [ ]
    }, {
      "index" : 4,
      "title" : "15.5 Reflections: Documenting the Journey",
      "videoIds" : [ ],
      "videos" : [ ]
    } ]
  } ],
  "logoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/cat.jpeg",
  "_links" : {
    "_self" : {
      "rel" : "_self",
      "href" : "https://api.boclips.com/v1/alignments/openstax/themes/62eba02f51ecf2a9306c85ef"
    }
  }
}

Response fields

Path Type Description

id

String

ID of the theme

provider

String

Name of the curriculum or publisher

_links

Object

HAL links for the resource

type

String

The discipline or school level

title

String

The book or specific grade level

topics[].index

Number

Recommended order of the topic

topics[].title

String

The chapter or cluster name

topics[].targets[].index

Number

Recommended order of the target

topics[].targets[].title

String

The section or standard name

topics[].targets[].videoIds

Array

Videos aligned to the target

topics[].targets[].videos

Array

Videos details

Retrieving Themes by ids

Request parameters

Parameter Type Optional Description

id

List of Theme IDs

true

IDs of the Theme

HTTP request

GET /v1/alignments/themes?id=62eba02f51ecf2a9306c85ef HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

$ curl 'https://api.boclips.com/v1/alignments/themes?id=62eba02f51ecf2a9306c85ef' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 0
Content-Type: application/hal+json
Referrer-Policy: no-referrer
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 10481

{
  "_embedded" : {
    "themes" : [ {
      "id" : "62eba02f51ecf2a9306c85ef",
      "provider" : "openstax",
      "title" : "Algebra 4 6",
      "type" : "Math",
      "topics" : [ {
        "index" : 0,
        "title" : "Chapter 1: The Entrepreneurial Perspective",
        "targets" : [ {
          "index" : 0,
          "title" : "1.1 Entrepreneurship Today",
          "videoIds" : [ "5c7d0009c4347d45194e0498", "5c7d0008c4347d45194e0497", "5c7829a75c56167742815cf6", "5c7d0005c4347d45194e0494", "5c7d0006c4347d45194e0495" ]
        }, {
          "index" : 1,
          "title" : "1.2 Entrepreneurial Vision and Goals",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "1.3 The Entrepreneurial Mindset",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 1,
        "title" : "Chapter 2: The Entrepreneurial Journey and Pathways",
        "targets" : [ {
          "index" : 0,
          "title" : "2.1 Overview of the Entrepreneurial Journey",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "2.2 The Process of Becoming an Entrepreneur",
          "videoIds" : [ "5c7d0008c4347d45194e0497", "5c7d0002c4347d45194e0491", "5c7d0005c4347d45194e0494" ]
        }, {
          "index" : 2,
          "title" : "2.3 Entrepreneurial Pathways",
          "videoIds" : [ "5c7829a75c56167742815cf6" ]
        }, {
          "index" : 3,
          "title" : "2.4 Frameworks to Inform Your Entrepreneurial Path",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 2,
        "title" : "Chapter 3: The Ethical and Social Responsibilities of Entrepreneurs",
        "targets" : [ {
          "index" : 0,
          "title" : "3.1 The Ethical and Social Responsibilities of Entrepreneurs",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "3.2 Ethical and Legal Issues in Entrepreneurship",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "3.3 Corporate Social Responsibility and Social Entrepreneurship",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "3.4 Developing a Workplace Culture of Ethical Excellence and Accountability",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 3,
        "title" : "Chapter 4: Creativity, Innovation, and Invention",
        "targets" : [ {
          "index" : 0,
          "title" : "4.1 Tools for Creativity and Innovation",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "4.2 Creativity, Innovation, and Invention: How They Differ",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "4.3 Developing Ideas, Innovations, and Inventions",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 4,
        "title" : "Chapter 5: Identifying Entrepreneurial Opportunity",
        "targets" : [ {
          "index" : 0,
          "title" : "5.1 Entrepreneurial Opportunity",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "5.2 Researching Potential Business Opportunities",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "5.3 Competitive Analysis",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 5,
        "title" : "Chapter 6: Problem Solving and Need Recognition Techniques",
        "targets" : [ {
          "index" : 0,
          "title" : "6.1 Problem Solving to Find Entrepreneurial Solutions",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "6.2 Creative Problem-Solving Process",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "6.3 Design Thinking",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "6.4 Lean Processes",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 6,
        "title" : "Chapter 7: Telling Your Entrepreneurial Story and Pitching the Idea",
        "targets" : [ {
          "index" : 0,
          "title" : "7.1 Clarifying Your Vision, Mission, and Goals",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "7.2 Sharing Your Entrepreneurial Story",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "7.3 Developing Pitches for Various Audiences and Goals",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "7.4 Protecting Your Idea and Polishing the Pitch through Feedback",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 7,
        "title" : "Chapter 8: Entrepreneurial Marketing and Sales",
        "targets" : [ {
          "index" : 0,
          "title" : "8.1 Entrepreneurial Marketing and the Marketing Mix",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "8.2 Market Research, Market Opportunity Recognition, and Target Market",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "8.3 Marketing Techniques and Tools for Entrepreneurs",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "8.4 Entrepreneurial Branding",
          "videoIds" : [ ]
        }, {
          "index" : 4,
          "title" : "8.5 Marketing Strategy and the Marketing Plan",
          "videoIds" : [ ]
        }, {
          "index" : 5,
          "title" : "8.6 Sales and Customer Service",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 8,
        "title" : "Chapter 9: Entrepreneurial Finance and Accounting",
        "targets" : [ {
          "index" : 0,
          "title" : "9.1 Overview of Entrepreneurial Finance and Accounting Strategies",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "9.2 Special Funding Strategies",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "9.3 Accounting Basics for Entrepreneurs",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "9.4 Developing Startup Financial Statements and Projections",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 9,
        "title" : "Chapter 10: Launch for Growth to Success",
        "targets" : [ {
          "index" : 0,
          "title" : "10.1 Launching the Imperfect Business: Lean Startup",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "10.2 Why Early Failure Can Lead to Success Later",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "10.3 The Challenging Truth about Business Ownership",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "10.4 Managing, Following, and Adjusting the Initial Plan",
          "videoIds" : [ ]
        }, {
          "index" : 4,
          "title" : "10.5 Growth: Signs, Pains, and Cautions",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 10,
        "title" : "Chapter 11: Business Model and Plan",
        "targets" : [ {
          "index" : 0,
          "title" : "11.1 Avoiding the “Field of Dreams” Approach",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "11.2 Designing the Business Model",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "11.3 Conducting a Feasibility Analysis",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "11.4 The Business Plan",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 11,
        "title" : "Chapter 12: Building Networks and Foundations",
        "targets" : [ {
          "index" : 0,
          "title" : "12.1 Building and Connecting to Networks",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "12.3 Designing a Startup Operational Plan",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 12,
        "title" : "Chapter 13: Business Structure Options: Legal, Tax, and Risk Issues",
        "targets" : [ {
          "index" : 0,
          "title" : "13.1 Business Structures: Overview of Legal and Tax Considerations",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "13.2 Corporations",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "13.3 Partnerships and Joint Ventures",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "13.4 Limited Liability Companies",
          "videoIds" : [ ]
        }, {
          "index" : 4,
          "title" : "13.6 Additional Considerations: Capital Acquisition, Business Domicile, and Technology",
          "videoIds" : [ ]
        }, {
          "index" : 5,
          "title" : "13.7 Mitigating and Managing Risks",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 13,
        "title" : "Chapter 14: Fundamentals of Resource Planning",
        "targets" : [ {
          "index" : 0,
          "title" : "14.1 Types of Resources",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "14.2 Using the PEST Framework to Assess Resource Needs",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "14.3 Managing Resources over the Venture Life Cycle",
          "videoIds" : [ ]
        } ]
      }, {
        "index" : 14,
        "title" : "Chapter 15: Next Steps",
        "targets" : [ {
          "index" : 0,
          "title" : "15.1 Launching Your Venture",
          "videoIds" : [ ]
        }, {
          "index" : 1,
          "title" : "15.2 Making Difficult Business Decisions in Response to Challenges",
          "videoIds" : [ ]
        }, {
          "index" : 2,
          "title" : "15.3 Seeking Help or Support",
          "videoIds" : [ ]
        }, {
          "index" : 3,
          "title" : "15.4 Now What? Serving as a Mentor, Consultant, or Champion",
          "videoIds" : [ ]
        }, {
          "index" : 4,
          "title" : "15.5 Reflections: Documenting the Journey",
          "videoIds" : [ ]
        } ]
      } ],
      "logoUrl" : "https://assets.boclips.com/boclips-public-static-files/boclips/sparks/cat.jpeg",
      "_links" : {
        "_self" : {
          "rel" : "_self",
          "href" : "https://api.boclips.com/v1/alignments/openstax/themes/62eba02f51ecf2a9306c85ef"
        }
      }
    } ]
  }
}

Response fields

Path Type Description

_embedded.themes[].id

String

ID of the theme

_embedded.themes[].provider

String

Name of the curriculum or publisher

_embedded.themes[]._links

Object

HAL links for the resource

_embedded.themes[].type

String

The discipline or school level

_embedded.themes[].title

String

The book or specific grade level

_embedded.themes[].topics[].index

Number

Recommended order of the topic

_embedded.themes[].topics[].title

String

The chapter or cluster name

_embedded.themes[].topics[].targets[].index

Number

Recommended order of the target

_embedded.themes[].topics[].targets[].title

String

The section or standard name

_embedded.themes[].topics[].targets[].videoIds

Array

Videos aligned to the target