Overview

This is the reference guide to the Boclips API.

Terms of service

Playback information

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

Undocumented fields

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

Changes to the API

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

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

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

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

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

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

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

HTTP verbs

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

Verb Usage

GET

Used to retrieve a resource

POST

Used to create a new resource

PUT

Used to fully replace an existing resource

PATCH

Used to update an existing resource, including partial updates

DELETE

Used to delete an existing resource

HTTP status codes

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

Status code Usage

200 OK

The request completed successfully

201 Created

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

204 No Content

An update to an existing resource has been applied successfully

400 Bad Request

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

404 Not Found

The requested resource did not exist

Hypermedia

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

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

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

Interpolating URLs

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

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

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

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

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

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

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

This sort of modifications should not break your client.

Errors

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

Path Type Description

error

String

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

message

String

A description of the cause of the error

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
X-Boclips-Trace-ID: 16aa345475503610
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Type: application/json
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" : "2023-01-27T11:18:34.208215512Z",
  "error" : "Invalid request",
  "message" : "not-quite-a-number is not a valid ISO 8601 duration. Example is PT5S.",
  "reasons" : null
}

Cross-Origin Resource Sharing

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

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

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

Authentication

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

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

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

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

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

{
  "access_token" : "***",
  "expires_in" : "300",
  "refresh_expires_in" : "604798",
  "refresh_token" : "***",
  "token_type" : "Bearer",
  "not-before-policy" : "1673824636",
  "session_state" : "ccdeeecc-1479-4297-892d-35eeeff849fd",
  "scope" : "profile email"
}
Path Type Description

access_token

String

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

refresh_token

String

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

expires_in

String

Expiration of the access_token in seconds

refresh_expires_in

String

Expiration of the refresh_token in millis

scope

String

OIDC claims allowed for this particular access_token

session_state

String

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

not-before-policy

String

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

token_type

String

OIDC token type must be bearer

Authentication Use Cases

Backend Service Integration

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

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

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

HTTP request

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

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

Example request

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

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be client_credentials

client_id

String

false

The client ID that you’ve been issued with

client_secret

String

false

The client secret that was Boclips issued to you

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

Providing a user identifier for analytics

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

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

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

Boclips-User-Id: [your user id]

Full user context

This feature is still in beta and could potentially change.

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

Boclips-User-Id: [your user id]

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

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

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

Using your platform as SSO

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

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

Configuring Identity Federation

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

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

OIDC

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

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

Configuring an OIDC Client

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

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

Retrieving an Access Token

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

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

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

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

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

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

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

Authenticating mobile applications

Authenticating mobile applications is possible with both options described above.

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

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

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

Mobile browser usage

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

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

Proof for Key Code Exchange

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

Sample Requests

Obtaining an Authorization Code:

HTTP request

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

Example request

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

Request parameters

Parameter Type Optional Description

response_type

String - Constant

false

The response type for this flow must always be code

client_id

String

false

The client ID that you’ve been issued with

redirect_uri

URL

false

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

Obtaining an Access Token:

HTTP request

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

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

Example request

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

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be authorization_code

client_id

String

false

The client ID that you’ve been issued with

code

String

false

The client secret that was Boclips issued to you

redirect_uri

String

false

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

Refreshing an Access Token

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

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

HTTP request

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

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

Example request

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

Request parameters

Parameter Type Optional Description

grant_type

String - Constant

false

The grant type for this flow must always be refresh_token

client_id

String

false

The client ID that you’ve been issued with

refresh_token

String

false

The refresh_token that was obtained before

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

Resources

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

Index

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

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

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

Accessing the index

A GET request is used to access the index.

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: ac6734c7dc60206c
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Content-Type: application/hal+json
content-encoding: gzip
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 5705

{
  "_links" : {
    "activate" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0",
      "templated" : false
    },
    "profile" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0",
      "templated" : false
    },
    "currentUser" : {
      "href" : "https://api.boclips.com/v1/users/_self",
      "templated" : false
    },
    "countries" : {
      "href" : "https://api.boclips.com/v1/countries",
      "templated" : false
    },
    "trackPageRendered" : {
      "href" : "https://api.boclips.com/v1/events/page-render",
      "templated" : false
    },
    "trackPlatformInteractedWith" : {
      "href" : "https://api.boclips.com/v1/events/platform-interaction{?subtype,anonymous}",
      "templated" : true
    },
    "validateShareCode" : {
      "href" : "https://api.boclips.com/v1/users/{id}/shareCode/{shareCode}",
      "templated" : true
    },
    "isUserActive" : {
      "href" : "https://api.boclips.com/v1/users/{id}/active",
      "templated" : true
    },
    "subjects" : {
      "href" : "https://api.boclips.com/v1/subjects",
      "templated" : false
    },
    "allSubjects" : {
      "href" : "https://api.boclips.com/v1/subjects?visibility=all",
      "templated" : false
    },
    "disciplines" : {
      "href" : "https://api.boclips.com/v1/disciplines",
      "templated" : false
    },
    "allDisciplines" : {
      "href" : "https://api.boclips.com/v1/disciplines?visibility=all",
      "templated" : false
    },
    "openstaxBooks" : {
      "href" : "https://api.boclips.com/v1/curriculum/openstax/books",
      "templated" : false
    },
    "openstaxBook" : {
      "href" : "https://api.boclips.com/v1/curriculum/openstax/books/{id}",
      "templated" : true
    },
    "openstaxSubjects" : {
      "href" : "https://api.boclips.com/v1/curriculum/openstax/subjects",
      "templated" : false
    },
    "video" : {
      "href" : "https://api.boclips.com/v1/videos/{id}{?referer,shareCode}",
      "templated" : true
    },
    "searchVideos" : {
      "href" : "https://api.boclips.com/v1/videos{?query,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,prices,category_code,updated_as_of,language,education_level,content_package,topics,cefr_level,include_cefr_level_facets}",
      "templated" : true
    },
    "getMetadata" : {
      "href" : "https://api.boclips.com/v1/videos/metadata",
      "templated" : false
    },
    "videoTypes" : {
      "href" : "https://api.boclips.com/v1/video-types",
      "templated" : false
    },
    "discoverCollections" : {
      "href" : "https://api.boclips.com/v1/collections?projection=list&discoverable=true&page=0&size=30{&query,subject,sort_by}",
      "templated" : true
    },
    "promotedCollections" : {
      "href" : "https://api.boclips.com/v1/collections?projection=list&promoted=true&discoverable=true&page=0&size=30",
      "templated" : false
    },
    "searchCollections" : {
      "href" : "https://api.boclips.com/v1/collections{?query,subject,discoverable,projection,page,size,age_range_min,age_range_max,age_range,resource_types,sort_by}",
      "templated" : true
    },
    "collection" : {
      "href" : "https://api.boclips.com/v1/collections/{id}{?projection,referer,shareCode}",
      "templated" : true
    },
    "myCollections" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0/collections?bookmarked=false{&projection,page,size,sort_by,origin}",
      "templated" : true
    },
    "mySavedCollections" : {
      "href" : "https://api.boclips.com/v1/users/ace8ab42-cbe3-4fa2-92b6-01dc1c2b0ff0/collections{?query,partial_title_match,projection,page,size,sort_by,origin,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
    },
    "contentCategories" : {
      "href" : "https://api.boclips.com/v1/content-categories",
      "templated" : false
    },
    "educationLevels" : {
      "href" : "https://api.boclips.com/v1/education-levels",
      "templated" : false
    },
    "ngssCodes" : {
      "href" : "https://api.boclips.com/v1/curriculum/ngss/codes",
      "templated" : false
    },
    "ngssGrades" : {
      "href" : "https://api.boclips.com/v1/curriculum/ngss/grades",
      "templated" : false
    }
  }
}
Relation Description

trackPageRendered

POST endpoint for tracking pageRendered event

trackPlatformInteractedWith

POST endpoint for tracking a platform interaction event

createPlaybackEvents

Sending batches of playback events from the past

createSearchQueryCompletionsSuggestedEvent

POST endpoint for tracking search completions suggested event

activate

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

profile

Templated link to get user profile information

currentUser

Get the current user’s profile

video

The video resource, templated link to retrieve an individual video

searchVideos

Templated link to perform video search

videoFeed

A feed of videos for deep pagination

videoTypes

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

tags

List of tags that can be attached to videos

createCollection

Link to create a new video collection

myCollections

Collections created by the current user

mySavedCollections

Collections created or bookmarked by the current user

discoverCollections

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

promotedCollections

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

searchCollections

Search all collections

collection

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

subjects

List of subjects available 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

countries

List of countries

channel

Retrieve a specific channel

channels

Retrieve all channels

contentCategories

Retrieve a list of content categories

validateShareCode

Validate a share code for a given user

isUserActive

Check whether given user is active

Events

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

Playback events

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

Sending single playback event

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

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

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

Request fields
Path Type Optional Description

videoId

String

false

ID of the video

segmentStartSeconds

Number

false

Second the video started its playback

segmentEndSeconds

Number

false

Second the video ended its playback

userId

String

true

ID of the user who initiated the playback
HTTP request
POST /v1/events/playback HTTP/1.1
Authorization: Bearer ***
Content-Type: application/json
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
X-Boclips-Trace-ID: 8a58ddbe337fd939
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: 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
X-Boclips-Trace-ID: a24d887d6c533958
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000

Users

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

User profile

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

Search results customization

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

Fetching

User profile can be fetched by profile hypermedia link.

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

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

id

String

The ID of the user

firstName

String

The first name of the user

lastName

String

The user’s last name

ages

Array

The student ages taught by the user

subjects

Array

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

email

String

The email of the user

_links

Object

HAL links related to this collection

Updating

User profile can be updated by profile hypermedia link.

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

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

firstName

String

true

The first name of the user

lastName

String

true

The user’s last name

subjects

Array

true

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

ages

Array

true

The student ages taught by the user

country

String

true

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

state

String

true

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

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

Videos

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

Accessing a single video

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

Path parameters

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

id

The ID of the video asset

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: e0aeefc3423fe2fb
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: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 3438

{
  "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" : "2023-01-27T10:27:58.279038849Z",
  "playback" : {
    "type" : "STREAM",
    "id" : "1_e72xmbcb",
    "duration" : "PT1M14S",
    "_links" : {
      "createPlaybackEvent" : {
        "href" : "https://api.boclips.com/v1/events/playback",
        "templated" : false
      },
      "createPlayerInteractedWithEvent" : {
        "href" : "https://api.boclips.com/v1/events/player-interaction",
        "templated" : false
      },
      "thumbnail" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
        "templated" : true
      },
      "videoPreview" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
        "templated" : true
      },
      "hlsStream" : {
        "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
        "templated" : false
      }
    }
  },
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish",
    "categories" : null
  }, {
    "id" : "5cb499c9fd5beb428189454e",
    "name" : "Chemistry",
    "categories" : null
  } ],
  "badges" : [ "ad-free" ],
  "legalRestrictions" : "",
  "ageRange" : {
    "min" : 12,
    "max" : 12,
    "label" : "12-12"
  },
  "rating" : 2.0,
  "yourRating" : null,
  "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" : "4CA",
    "label" : "Pre-school"
  }, {
    "code" : "4CD1",
    "label" : "Lower Primary"
  } ],
  "cefrLevel" : "B1",
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf",
      "templated" : false
    },
    "logInteraction" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
      "templated" : true
    },
    "rate" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
      "templated" : true
    },
    "transcript" : {
      "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

id

String

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

title

String

Human readable title for this video

description

String

Description detailing what this video talks about

additionalDescription

Null

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

releasedOn

String

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

updatedAt

String

Date when the most recent update occured

subjects

Array

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

badges

Array

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

rating

Number

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

yourRating

Null

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

bestFor

Array

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

attachments

Array

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

legalRestrictions

String

Legal restrictions for this particular video if any

contentWarnings

Array

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

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)

createdBy

String

Who provided the video

availability.availableUntil

ISO-8601 (YYYY-MM-DD)

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

_links

Object

HAL links for this resource

Response fields-playback

Path Type Description

type

String

Playback type, i.e. STREAM or YOUTUBE

id

String

Id of this playback, useful for YOUTUBE type

duration

String

Duration of this particular video in ISO-8601

_links.createPlaybackEvent.href

String

POST endpoint for a createPlaybackEvent. See more on events here

_links.createPlayerInteractedWithEvent.href

String

POST endpoint for a createPlayerInteractedWithEvent

_links.thumbnail.href

String

Thumbnail URL for the video. May be templated with thumbnailWidth

_links.thumbnail.templated

Boolean

Tells whether the thumbnail link is templated

_links.videoPreview.href

String

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

_links.hlsStream.href

String

URL for the Apple HLS stream

Response fields-contentwarnings

Path Type Description

id

String

ID of the content warning

label

String

Label describing the content warning

Response fields-bestfor

Path Type Description

label

String

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

self

The video resource that was just retrieved

logInteraction

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

rate

PATCH request to this URL will give this video a rating

tag

PATCH request to this URL will tag this video

transcript

GET to fetch transcripts of video

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

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

Request parameters

Parameter Type Optional Description

size

Number

true

The number of videos per page, 100 by default

page

Number

true

Zero-index based page number, first page by default

query

String

true

The text search query

duration

Range of ISO-8601 (PT6M5S)

true

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

duration_min

ISO-8601 (PT6M5S)

true

Filters on the video duration property, this range is inclusive

duration_max

ISO-8601 (PT30S)

true

Filters on the video duration property, this range is inclusive

released_date_from

ISO-8601 (YYYY-MM-DD)

true

Filters on the video releasedOn property, this range is inclusive

released_date_to

ISO-8601 (YYYY-MM-DD)

true

Filters on the video releasedOn property, this range is inclusive

updated_as_of

ISO-8601 (YYYY-MM-DD)

true

Filters on the video updatedAt property, this range is inclusive

source

YOUTUBE, BOCLIPS

true

Filter by video source, e.g youtube or boclips

subject

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

true

Filter by subject id - from the list of subjects

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, RATING

true

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

id

Video ID (e.g '5cd9627d6c2905689d1c150c'

true

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

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

openstax_book_id

String (eg. '62739e7e94ee013d09effa5b')

true

Filter by openstax book id.

openstax_book_chapter

Number

true

Filter by openstax book chapter number.

openstax_chapter_section

Number

true

Filter by openstax chapter section number.

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=NEWS 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=NEWS' -i -X GET \
    -H 'Authorization: Bearer ***'

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 603351fb4a96bddb
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 6160

{
  "_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" : "2023-01-27T09:36:28.388191593Z",
      "playback" : {
        "type" : "STREAM",
        "id" : "1_9kry7wp3",
        "duration" : "PT2M11S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_9kry7wp3/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
            "templated" : true
          },
          "videoPreview" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_9kry7wp3/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
            "templated" : true
          },
          "hlsStream" : {
            "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_9kry7wp3/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
            "templated" : false
          }
        }
      },
      "subjects" : [ {
        "id" : "5cb499c9fd5beb428189454b",
        "name" : "Spanish",
        "categories" : null
      }, {
        "id" : "5cb499c9fd5beb428189454e",
        "name" : "Chemistry",
        "categories" : null
      } ],
      "badges" : [ "ad-free" ],
      "legalRestrictions" : "",
      "ageRange" : {
        "min" : 11,
        "max" : 14,
        "label" : "11-14"
      },
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ {
        "label" : "Experience"
      }, {
        "label" : "Discovery"
      } ],
      "createdBy" : "AP",
      "promoted" : null,
      "language" : {
        "code" : "eng",
        "displayName" : "English"
      },
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ "Colorado", "United States government", "Science", "Medical research", "Continent", "Aerospace and defense industry", "POLITICIAN", "North America", "PERSON", "Health", "Space exploration", "Nation", "City", "Space industry", "Genomics", "United States", "National Aeronautics and Space Administration", "Fort Collins", "State", "Scott J. Kelly", "Mark Kelly", "Barack Obama", "Biology", "Industrial products and services", "Business", "Colorado State University", "NEWSMAKER", "Genetics" ],
      "type" : "NEWS",
      "educationLevels" : [ ],
      "cefrLevel" : 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
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/5cb4c9e4fd5beb42818945a2?rating={rating}",
          "templated" : true
        }
      }
    } ],
    "facets" : {
      "subjects" : {
        "5cb499c9fd5beb428189454b" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454b",
          "name" : "Spanish",
          "score" : null
        },
        "5cb499c9fd5beb428189454e" : {
          "hits" : 10,
          "id" : "5cb499c9fd5beb428189454e",
          "name" : "Chemistry",
          "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" : {
        "NEWS" : {
          "hits" : 10,
          "id" : null,
          "name" : null,
          "score" : null
        }
      },
      "channels" : { },
      "prices" : { },
      "educationLevels" : { },
      "topics" : { },
      "languages" : {
        "eng" : {
          "hits" : 10,
          "id" : "eng",
          "name" : "English",
          "score" : null
        }
      },
      "cefrLevels" : { }
    }
  },
  "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
X-Boclips-Trace-ID: 5afd8c032b2fa473
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 81

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

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
X-Boclips-Trace-ID: 198c0fd579423d46
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 35205

{
  "_embedded" : {
    "videos" : [ {
      "id" : "63cd84585054fa0d3e55c374",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ١٦) - أدوات المطبخ | تعلم ألوان السيارات باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال اسماء أدوات المطبخ  بطريقة ممتعة.\n\nموضوع اليوم: أدوات المطبخ \n\nسيتعلم الأطفال الأرقام  التالية:\nمغرفة\nملعقة\nشوكة\nسكّين\nمقلاة\nقدر\nصحن\nكأس\nخلاّط\nعصّارة\nإبريق\nميزان\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2023-01-22",
      "updatedAt" : "2023-01-25T11:51:01.70953564Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "QBZTU9OHp00",
        "duration" : "PT4M26S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/QBZTU9OHp00/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63cd84585054fa0d3e55c374",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63cd84585054fa0d3e55c374/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63cd84585054fa0d3e55c374?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "63c449c4f9421a3ac9c52f2e",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ١٥) - ألوان السيارات | تعلم ألوان السيارات باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال اسماء الأدوات المدرسية  بطريقة ممتعة.\n\nموضوع اليوم: ألوان السيارات \n\nسيتعلم الأطفال الأرقام  التالية:\nسيّارة بيضاء\nسيّارة خضراء\nسيّارة زرقاء\nسيّارة سوداء\nسيّارة بنّية\nسيّارة برتقالية\nسيّارة حمراء\nسيّارة صفراء\nسيّارة بنفسجية\nسيّارة رماديّة\nسيّارة خضراء\nسيّارة ورديّة\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2023-01-15",
      "updatedAt" : "2023-01-21T00:06:52.838977062Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "6gW4LEvBmpI",
        "duration" : "PT4M26S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/6gW4LEvBmpI/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63c449c4f9421a3ac9c52f2e",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63c449c4f9421a3ac9c52f2e/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63c449c4f9421a3ac9c52f2e?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "63bb0f4418ad8918be1a1ce0",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ١٤) - أدوات المدرسة | تعلم اسماء تعابير الوجه باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال اسماء الأدوات المدرسية  بطريقة ممتعة.\n\nموضوع اليوم: أدوات المدرسة \n\nسيتعلم الأطفال الأرقام  التالية:\nمقلمة\nممحاة\nحقيبة\nدفتر\nقلم حبر\nقلم رصاص\nفرشاة رسم\nمبراة\nمسطرة\nمنقلة\nكوس\nمقص\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2023-01-08",
      "updatedAt" : "2023-01-21T00:06:52.813494772Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "jAa0UXrtznU",
        "duration" : "PT4M26S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/jAa0UXrtznU/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63bb0f4418ad8918be1a1ce0",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63bb0f4418ad8918be1a1ce0/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63bb0f4418ad8918be1a1ce0?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "63b1d4dae2fbbd4eef41099f",
      "title" : "لعبة صل الكلمة بالصورة (الحلقة ١٣) - الأرقام | تعلم اسماء تعابير الوجه باللغة العربية مع زكريا",
      "description" : "هيا نلعب معا لعبة صل الكلمة بالصورة مع هذا الكرتون، الذي سيعلم الأطفال اسماء الأرقام  بطريقة ممتعة.\n\nموضوع اليوم: تعابير الوجه \n\nسيتعلم الأطفال الأرقام  التالية:\nواحد\nاثنان\nثلاثة\nأربعة\nخمسة\nستة\nسبعة\nثمانية\nتسعة\nعشرة\nاحدى عشر \nاثنى عشر \n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2023-01-01",
      "updatedAt" : "2023-01-21T00:06:52.738788387Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "n7rZ_xyVCeo",
        "duration" : "PT4M26S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/n7rZ_xyVCeo/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63b1d4dae2fbbd4eef41099f",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63b1d4dae2fbbd4eef41099f/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63b1d4dae2fbbd4eef41099f?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "639f5feec006ea4d97d016d0",
      "title" : "لعبة الذاكرة (الحلقة 19)  - فصل الشتاء للأطفال، لعبة البطاقات لكل العائلة – تعلم مع زكريا",
      "description" : "هيا نلعب معا لعبة الذاكرة (لعبة البطاقات) مع هذا الكرتون، الذي سوف يحفز ذاكرة الأطفال بطريقة ممتعة.\n\nموضوع اليوم: فصل الشتاء\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nصفح موقعنا:\n\nhttp://learnwithzakaria.com\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria\n\nتابعنا على الانستغرام:\n\nhttps://www.instagram.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-12-18",
      "updatedAt" : "2023-01-21T00:06:52.710364934Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "UdkiFViRhlo",
        "duration" : "PT3M30S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/UdkiFViRhlo/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/639f5feec006ea4d97d016d0",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/639f5feec006ea4d97d016d0/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/639f5feec006ea4d97d016d0?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "63962557ada8f71eae1c4694",
      "title" : "حرف الياء (ي) - برنامج الحروف العربية للأطفال (الحلقة ٢٨) - تعلم حروف الهجاء مع زكريا",
      "description" : "هيا نتعلم حرف الياء والكلمات التي تحتوي على الحرف الأخير في حروف الهجاء مع هذا الكرتون، بطريقة مسلية وفريدة من نوعها:\n\nسيتعلم الأطفال الكلمات التالية التي تحتوي على حرف الواو:\nيَحْبُو\nيُصَلِّي\nيَدٌ\nسَيَّارَةٌ\nهَدِيَّةٌ\nبَيْضٌ\nجَدِّي\nكُرْسِي\nشَايٌ\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nمزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nتصفح موقعنا:\n\nhttp://learnwithzakaria.com/\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-12-11",
      "updatedAt" : "2023-01-21T00:06:52.633435333Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "nP0ftHMBlWk",
        "duration" : "PT12M39S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/nP0ftHMBlWk/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63962557ada8f71eae1c4694",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63962557ada8f71eae1c4694/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63962557ada8f71eae1c4694?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "638ceac2988919381f15d0b2",
      "title" : "حرف الواو (و) - برنامج الحروف العربية للأطفال (الحلقة ٢٧) - تعلم حروف الهجاء مع زكريا",
      "description" : "هيا نتعلم حرف الواو والكلمات التي تحتوي على الحرف السابع وعشرون في حروف الهجاء مع هذا الكرتون، بطريقة مسلية وفريدة من نوعها:\n\nسيتعلم الأطفال الكلمات التالية التي تحتوي على حرف الواو:\nوَجْهٌ\nوُرُودٌ\nوِسَادَةٌ\nحُوتٌ\nكَتْكُوتٌ\nكَوْبٌ\nدَلْوٌ\nجَرْوٌ\nيَحْبُو\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nمزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nتصفح موقعنا:\n\nhttp://learnwithzakaria.com/\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-12-04",
      "updatedAt" : "2023-01-21T00:06:52.607149958Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "PVdZ5efDOx4",
        "duration" : "PT12M39S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/PVdZ5efDOx4/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/638ceac2988919381f15d0b2",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/638ceac2988919381f15d0b2/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/638ceac2988919381f15d0b2?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "6383b036011a86706eb80221",
      "title" : "حرف الهاء (ه) - برنامج الحروف العربية للأطفال (الحلقة ٢٦) - تعلم حروف الهجاء مع زكريا",
      "description" : "هيا نتعلم حرف الهاء والكلمات التي تحتوي على الحرف السادس وعشرون في حروف الهجاء مع هذا الكرتون، بطريقة مسلية وفريدة من نوعها:\n\nسيتعلم الأطفال الكلمات التالية التي تحتوي على حرف الهاء:\nهَرَمٌ\nهِلَالٌ\nهَدِيَّةٌ\nمُهَنْدِسٌ\nزَهْرَةٌ\nذَهَبٌ\nمُتَنَزِّهٌ\nاللّه\nوَجْهٌ\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nمزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nتصفح موقعنا:\n\nhttp://learnwithzakaria.com/\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-11-27",
      "updatedAt" : "2023-01-21T00:06:52.541387541Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "nl4fmttRH5Y",
        "duration" : "PT12M39S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/nl4fmttRH5Y/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/6383b036011a86706eb80221",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/6383b036011a86706eb80221/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/6383b036011a86706eb80221?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "637a75eed7b5131456ec397f",
      "title" : "حرف النون (ن) - برنامج الحروف العربية للأطفال (الحلقة ٢٥) - تعلم حروف الهجاء مع زكريا",
      "description" : "هيا نتعلم حرف النون والكلمات التي تحتوي على الحرف الخامس وعشرون في حروف الهجاء مع هذا الكرتون، بطريقة مسلية وفريدة من نوعها:\n\nسيتعلم الأطفال الكلمات التالية التي تحتوي على حرف النون:\nنَخْلَةٌ\nنُقُودٌ\nنِصْفٌ\nعِنَبٌ\nقُنْفُذٌ\nمِغْنَاطِيسٌ\nثُعْبَانٌ\nأُذُنٌ\nجُبنٌ\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nمزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nتصفح موقعنا:\n\nhttp://learnwithzakaria.com/\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-11-20",
      "updatedAt" : "2023-01-21T00:06:52.516844993Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "2RqUkWKr4N0",
        "duration" : "PT12M39S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/2RqUkWKr4N0/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/637a75eed7b5131456ec397f",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/637a75eed7b5131456ec397f/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/637a75eed7b5131456ec397f?rating={rating}",
          "templated" : true
        }
      }
    }, {
      "id" : "63713b65c4ec200f0f004056",
      "title" : "حرف الميم (م) - برنامج الحروف العربية للأطفال (الحلقة ٢٤) - تعلم حروف الهجاء مع زكريا",
      "description" : "هيا نتعلم حرف الميم والكلمات التي تحتوي على الحرف الرابع وعشرون في حروف الهجاء مع هذا الكرتون، بطريقة مسلية وفريدة من نوعها:\n\nسيتعلم الأطفال الكلمات التالية التي تحتوي على حرف الميم:\nمَوْزٌ\nمُعَلِّمٌ\nمِفْتَاحٌ\nرُمَّانٌ\nرَمْلٌ\nنَجْمَةٌ\nقَلَمٌ\nحِزَامٌ\nرَسْمٌ\n\nنتمنى أن يعجبكم هذا الفيديو و أن يستفيد الأطفال منه.\n\nمرحبا بكم في قناة تعلّم مع زكريا, مكان فريد من نوعه مليء بالأدوات التعليمية للأطفال, الأولياء والمعلمين.\n\nقناتنا تحتوي على فيديوهات تجعل الأطفال يضحكون,  يبتسمون ويتعلمون في نفس الوقت, كل من الحروف، ..الألوان، الأشكال، أسماء الحيوانات ...الفواكه والخضروات و الكثير من الأشياء الأخرى, باللغة العربية ,الإنجليزية و حتى الفرنسية\n\nنتمنى أن تعجبكم قناتنا.\n\nمزيد من الفيديوهات هنا:\n\nhttps://www.youtube.com/learnWithZakaria\n\nتصفح موقعنا:\n\nhttp://learnwithzakaria.com/\n\nتابعنا على الفيسبوك:\n\nhttps://www.facebook.com/LearnWithZakaria",
      "additionalDescription" : null,
      "releasedOn" : "2022-11-13",
      "updatedAt" : "2023-01-21T00:06:52.439242375Z",
      "playback" : {
        "type" : "YOUTUBE",
        "id" : "55yuDuEn7sw",
        "duration" : "PT12M39S",
        "_links" : {
          "createPlaybackEvent" : {
            "href" : "https://api.boclips.com/v1/events/playback",
            "templated" : false
          },
          "createPlayerInteractedWithEvent" : {
            "href" : "https://api.boclips.com/v1/events/player-interaction",
            "templated" : false
          },
          "thumbnail" : {
            "href" : "https://i.ytimg.com/vi/55yuDuEn7sw/hqdefault.jpg",
            "templated" : false
          }
        }
      },
      "subjects" : [ ],
      "badges" : [ "youtube" ],
      "legalRestrictions" : "",
      "ageRange" : null,
      "rating" : null,
      "yourRating" : null,
      "bestFor" : [ ],
      "createdBy" : "Learn with Zakaria - تعلم مع زكريا",
      "promoted" : null,
      "language" : null,
      "attachments" : [ ],
      "contentWarnings" : [ ],
      "keywords" : [ ],
      "type" : "INSTRUCTIONAL",
      "educationLevels" : [ ],
      "cefrLevel" : null,
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/videos/63713b65c4ec200f0f004056",
          "templated" : false
        },
        "logInteraction" : {
          "href" : "https://api.boclips.com/v1/videos/63713b65c4ec200f0f004056/events?logVideoInteraction=true&type={type}",
          "templated" : true
        },
        "rate" : {
          "href" : "https://api.boclips.com/v1/videos/63713b65c4ec200f0f004056?rating={rating}",
          "templated" : true
        }
      }
    } ]
  },
  "_links" : {
    "next" : {
      "href" : "https://api.boclips.com/v1/feed/videos?cursor_id=FGluY2x1ZGVfY29udGV4dF91dWlkDnF1ZXJ5VGhlbkZldGNoBRYwSGdoQmJTOFNOMk9pLXhiellVU3RRAAAAAAKaQaAWdUhVVkJlbGtTMk95dzhwU1gyUzRvZxYwSGdoQmJTOFNOMk9pLXhiellVU3RRAAAAAAKaQZ8WdUhVVkJlbGtTMk95dzhwU1gyUzRvZxZzMXl2TDJRSFNxeUhrWXBKUEdzRFBBAAAAAAMg5JoWTWdzaElBd3FRLVNLbHI4dXZwMkloURYwSGdoQmJTOFNOMk9pLXhiellVU3RRAAAAAAKaQaEWdUhVVkJlbGtTMk95dzhwU1gyUzRvZxZzMXl2TDJRSFNxeUhrWXBKUEdzRFBBAAAAAAMg5JsWTWdzaElBd3FRLVNLbHI4dXZwMkloUQ==&size=10",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

_embedded.videos

Array

Video resources array. See video for payload details

_links

Object

HAL links related to this collection
Relation Description

next

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

Caveats

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

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

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

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

Collections

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

Creating a collection

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

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

Request fields

Path Type Optional Description

title

String

false

Collection’s title

description

String

true

Collection’s description

videos

Array

true

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

subjects

Array

true

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

HTTP request

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

{
  "title" : "Genetic Screening Debate",
  "description" : "Doctors and other health care professionals are faced with complex patient care issues as genetic testing becomes more widely available, study finds.",
  "videos" : [ "5c542abf5438cdbcb56df0bf", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454d" ],
  "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", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454d" ],
  "discoverable" : true
}'

Example response

HTTP/1.1 201 Created
X-Boclips-Trace-ID: aefc455340159db9
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/63d3b3579ffd970b52a36fea
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 8358

{
  "id" : "63d3b3579ffd970b52a36fea",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "ownerName" : "Some First Name Some Last Name",
  "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" : "2023-01-27T10:27:58.279038849Z",
    "playback" : {
      "type" : "STREAM",
      "id" : "1_e72xmbcb",
      "duration" : "PT1M14S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
          "templated" : true
        },
        "videoPreview" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
          "templated" : true
        },
        "hlsStream" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : null
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "rating" : 2.0,
    "yourRating" : null,
    "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" : "4CA",
      "label" : "Pre-school"
    }, {
      "code" : "4CD1",
      "label" : "Lower Primary"
    } ],
    "cefrLevel" : "B1",
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
        "templated" : true
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  }, {
    "id" : "5cf15aaece7c2c4e212747d3",
    "title" : "The Lonely Howl of Tamayo’s Last Dog",
    "description" : "Experience the raw emotion of Rufino Tamayo’s Perro Aullando a La Luna, the only dog from his Animal series left in private hands. In this evocative piece from 1942, he combines European Modernism with his Zapotec heritage to reveal the anguish of a world at war.  Perro Aullando a La Luna will be offered in our Impressionist & Modern Art Evening Sale on 14 May.\n\nLearn More: http://www.sothebys.com/en/auctions/ecatalogue/2018/impressionist-modern-art-evening-sale-n09860/lot.25.html\n\nDownload The Sotheby’s App:https://itunes.apple.com/us/app/sothebys/id1061156465?mt=8\n\nFOR MORE NEWS FROM SOTHEBY’S\nInstagram: https://www.instagram.com/sothebys/\nFacebook: https://www.facebook.com/sothebys \nTwitter: https://twitter.com/sothebys \nPinterest: https://www.pinterest.com/ \nWeibo: www.weibo.com/sothebyshongkong \nWeChat: sothebyshongkong \nSnapchat: Sothebys",
    "additionalDescription" : null,
    "releasedOn" : "2019-04-26",
    "updatedAt" : "2023-01-27T09:36:38.165554812Z",
    "playback" : {
      "type" : "YOUTUBE",
      "id" : "8Y5J5xCwHrQ",
      "duration" : "PT3M13S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://i.ytimg.com/vi/8Y5J5xCwHrQ/hqdefault.jpg",
          "templated" : false
        }
      }
    },
    "subjects" : [ ],
    "badges" : [ "youtube" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 3,
      "max" : 14,
      "label" : "3-14"
    },
    "rating" : 4.0,
    "yourRating" : null,
    "bestFor" : [ {
      "label" : "Experience"
    } ],
    "createdBy" : "Sotheby's",
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ ],
    "type" : "INSTRUCTIONAL",
    "educationLevels" : [ ],
    "cefrLevel" : null,
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5cf15aaece7c2c4e212747d3?rating={rating}",
        "templated" : true
      }
    }
  } ],
  "updatedAt" : "2023-01-27T11:19:51.349Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454d",
    "name" : "History"
  }, {
    "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" : [ ],
  "origin" : null,
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea?last_updated_at=2023-01-27T11%3A19%3A51.349Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b3579ffd970b52a36fea/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/63d3b34bd8d25c614617d62a HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: f4091dc736cc2a26
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 3331

{
  "id" : "63d3b34bd8d25c614617d62a",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "ownerName" : "Some First Name Some Last Name",
  "title" : "Genetic Screening Debate",
  "videos" : [ {
    "id" : "5c542abf5438cdbcb56df0bf",
    "title" : null,
    "description" : null,
    "additionalDescription" : null,
    "releasedOn" : null,
    "updatedAt" : null,
    "playback" : null,
    "subjects" : [ ],
    "badges" : [ ],
    "legalRestrictions" : null,
    "ageRange" : null,
    "rating" : null,
    "yourRating" : null,
    "bestFor" : null,
    "createdBy" : null,
    "promoted" : null,
    "language" : null,
    "attachments" : [ ],
    "contentWarnings" : [ ],
    "keywords" : [ ],
    "type" : null,
    "educationLevels" : null,
    "cefrLevel" : 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" : "2023-01-27T11:19:40.68Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454d",
    "name" : "History"
  }, {
    "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" : "63d3b34cd8d25c614617d62b",
    "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" : [ ],
  "origin" : null,
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a?last_updated_at=2023-01-27T11%3A19%3A40.680Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b34bd8d25c614617d62a/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

String

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

Response fields-attachments
Path Type Description

id

String

ID of the attachment

type

Enum String

The type of the attachment: LESSON_PLAN ACTIVITY

description

String

Text that describes the attachment

_links.download.href

String

A link that points to attachment’s actual content

Projections

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

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

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

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

HTTP request
GET /v1/collections/63d3b329d8d25c614617d623?projection=details HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example response
HTTP/1.1 200 OK
X-Boclips-Trace-ID: 0047b90a8bf716e3
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 6076

{
  "id" : "63d3b329d8d25c614617d623",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "ownerName" : "Some First Name Some Last Name",
  "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" : "2023-01-27T10:27:58.279038849Z",
    "playback" : {
      "type" : "STREAM",
      "id" : "1_e72xmbcb",
      "duration" : "PT1M14S",
      "_links" : {
        "createPlaybackEvent" : {
          "href" : "https://api.boclips.com/v1/events/playback",
          "templated" : false
        },
        "createPlayerInteractedWithEvent" : {
          "href" : "https://api.boclips.com/v1/events/player-interaction",
          "templated" : false
        },
        "thumbnail" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/3/vid_slice/1",
          "templated" : true
        },
        "videoPreview" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/thumbnail/entry_id/1_e72xmbcb/width/{thumbnailWidth}/vid_slices/{thumbnailCount}",
          "templated" : true
        },
        "hlsStream" : {
          "href" : "https://cdnapisec.kaltura.com/p/2394162/sp/239416200/playManifest/entryId/1_e72xmbcb/format/applehttp/flavorParamIds/487041%2C487051%2C487061%2C487071%2C487081%2C487091%2C487111/protocol/https/video.mp4",
          "templated" : false
        }
      }
    },
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : null
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : null
    } ],
    "badges" : [ "ad-free" ],
    "legalRestrictions" : "",
    "ageRange" : {
      "min" : 12,
      "max" : 12,
      "label" : "12-12"
    },
    "rating" : 2.0,
    "yourRating" : null,
    "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" : "4CA",
      "label" : "Pre-school"
    }, {
      "code" : "4CD1",
      "label" : "Lower Primary"
    } ],
    "cefrLevel" : "B1",
    "_links" : {
      "self" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?projection=details",
        "templated" : false
      },
      "logInteraction" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/events?logVideoInteraction=true&type={type}",
        "templated" : true
      },
      "rate" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf?rating={rating}",
        "templated" : true
      },
      "transcript" : {
        "href" : "https://api.boclips.com/v1/videos/5c542abf5438cdbcb56df0bf/transcript",
        "templated" : false
      }
    }
  } ],
  "updatedAt" : "2023-01-27T11:19:06.624Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : true,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454d",
    "name" : "History"
  }, {
    "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" : "63d3b32a9ffd970b52a36fe4",
    "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" : [ ],
  "origin" : null,
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623",
      "templated" : false
    },
    "edit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623",
      "templated" : false
    },
    "safeEdit" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623?last_updated_at=2023-01-27T11%3A19%3A06.624Z",
      "templated" : false
    },
    "remove" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623",
      "templated" : false
    },
    "addVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623/videos/{video_id}",
      "templated" : true
    },
    "removeVideo" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623/videos/{video_id}",
      "templated" : true
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623/events",
      "templated" : false
    },
    "updatePermissions" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b329d8d25c614617d623/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
X-Boclips-Trace-ID: 1650957c28dc9ad8
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1912

{
  "_embedded" : {
    "collections" : [ {
      "id" : "61fbd725791cc80037868b71",
      "owner" : "6eb42a4f-e868-4ee9-b14e-075a88174cbf",
      "ownerName" : "Contract Tests",
      "title" : "A title",
      "videos" : [ ],
      "updatedAt" : "2022-02-03T13:22:45.128Z",
      "public" : true,
      "discoverable" : true,
      "promoted" : false,
      "mine" : false,
      "createdBy" : "Boclips",
      "subjects" : [ ],
      "ageRange" : null,
      "description" : "Description of collection",
      "attachments" : [ ],
      "subCollections" : [ ],
      "origin" : "BO_WEB_APP",
      "permissions" : {
        "anyone" : "VIEW_ONLY"
      },
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/collections/61fbd725791cc80037868b71",
          "templated" : false
        },
        "bookmark" : {
          "href" : "https://api.boclips.com/v1/collections/61fbd725791cc80037868b71?bookmarked=true",
          "templated" : false
        },
        "interactedWith" : {
          "href" : "https://api.boclips.com/v1/collections/61fbd725791cc80037868b71/events",
          "templated" : false
        }
      }
    } ]
  },
  "page" : {
    "size" : 1,
    "totalElements" : 10000,
    "totalPages" : 10000,
    "number" : 0
  },
  "_links" : {
    "list" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&page=0&size=1&projection=list",
      "templated" : false
    },
    "details" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&page=0&size=1&projection=details",
      "templated" : false
    },
    "self" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&projection=list&page=0&size=1",
      "templated" : false
    },
    "next" : {
      "href" : "https://api.boclips.com/v1/collections?query=collection&projection=list&size=1&page=1",
      "templated" : false
    }
  }
}

Response fields

Path Type Description

_embedded.collections

Array

Collection resources array. See collection for payload details

page.size

Number

Amount of resources in the current page

page.totalElements

Number

Total amount of resources for this search query across pages

page.totalPages

Number

Total amount of pages for this search query

page.number

Number

Number of the current page. Zero-index based

_links

Object

HAL links for the collection resource
Relation Description

self

Points to this exact search query

next

Points to next page of collections

details

Points to this search query with details projection

list

Points to this search query with list projection

Editing collections

Updating selected fields

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

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

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

Request fields
Path Type Optional Description

title

String

true

Collection’s title

description

String

true

Collection’s description

videos

Array

true

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

subjects

Array

true

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

discoverable

Boolean

true

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

ageRange.min

Number

true

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

ageRange.max

Number

true

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

attachment

Object

true

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

linkToResource

String

false

A link that points to attachment’s actual content

type

Enum String

false

The type of the attachment. Currently we support LESSON_PLAN only

description

String

true

Text that describes the attachment
HTTP request
PATCH /v1/collections/63d3b35d9ffd970b52a36feb 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", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454d" ],
  "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/63d3b35d9ffd970b52a36feb' -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", "5cf15aaece7c2c4e212747d3" ],
  "subjects" : [ "5cb499c9fd5beb428189454b", "5cb499c9fd5beb428189454d" ],
  "discoverable" : true,
  "ageRange" : {
    "min" : 8,
    "max" : 12
  },
  "attachment" : {
    "linkToResource" : "https://api.boclips.com/document/d/1SBf26k2PEPsChg2X4yv6F71uqp8bECcYFtAFSmTDN10/edit?usp=sharing",
    "description" : "1.Solving Problems with The Scientific Method: We Do it Everyday! 1.Plan A Science Fair Project",
    "type" : "LESSON_PLAN"
  }
}'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 785fe37e0f12b607
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: 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. /collections/63d3b3309ffd970b52a36fe5/videos/{video_id}
Parameter Description

video_id

The ID of the video
HTTP request
PUT /v1/collections/63d3b3309ffd970b52a36fe5/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/63d3b3309ffd970b52a36fe5/videos/5c542abf5438cdbcb56df0bf' -i -X PUT \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 21f0c9a0d087d679
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: 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. /collections/63d3b31f9ffd970b52a36fe1/videos/{video_id}
Parameter Description

video_id

The ID of the video
HTTP request
DELETE /v1/collections/63d3b31f9ffd970b52a36fe1/videos/5c542abf5438cdbcb56df0bf HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com
Example request
$ curl 'https://api.boclips.com/v1/collections/63d3b31f9ffd970b52a36fe1/videos/5c542abf5438cdbcb56df0bf' -i -X DELETE \
    -H 'Authorization: Bearer ***'
Example response
HTTP/1.1 204 No Content
X-Boclips-Trace-ID: 1f23a9441688b020
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Via: 1.1 google
Alt-Svc: 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/63d3b344d8d25c614617d629?bookmarked=true HTTP/1.1
Authorization: Bearer ***
Host: api.boclips.com

Example request

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

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 5d0aecf198e1d862
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1168

{
  "id" : "63d3b344d8d25c614617d629",
  "owner" : "63bc0bbf-559b-4e4a-a011-37c395c5b1c8",
  "ownerName" : "Some First Name Some Last Name",
  "title" : "Discoverable Boclips Collection",
  "videos" : [ ],
  "updatedAt" : "2023-01-27T11:19:33.024Z",
  "public" : true,
  "discoverable" : true,
  "promoted" : false,
  "mine" : false,
  "createdBy" : "Teacher",
  "subjects" : [ {
    "id" : "5cb499c9fd5beb428189454d",
    "name" : "History"
  }, {
    "id" : "5cb499c9fd5beb428189454b",
    "name" : "Spanish"
  } ],
  "ageRange" : null,
  "description" : "This content is accessible by everyone",
  "attachments" : [ ],
  "subCollections" : [ ],
  "origin" : null,
  "permissions" : {
    "anyone" : "VIEW_ONLY"
  },
  "_links" : {
    "self" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b344d8d25c614617d629",
      "templated" : false
    },
    "unbookmark" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b344d8d25c614617d629?bookmarked=false",
      "templated" : false
    },
    "interactedWith" : {
      "href" : "https://api.boclips.com/v1/collections/63d3b344d8d25c614617d629/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
X-Boclips-Trace-ID: 144ef834eb13bc59
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1431

{
  "_embedded" : {
    "disciplines" : [ {
      "id" : "5d0921adcbb0371877b252d2",
      "name" : "Social Sciences",
      "code" : "social-studies",
      "subjects" : [ {
        "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" ]
      } ],
      "_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

Links

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
X-Boclips-Trace-ID: 3cfdb6e0f974a63e
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 1005

{
  "_embedded" : {
    "subjects" : [ {
      "id" : "5cb499c9fd5beb428189454b",
      "name" : "Spanish",
      "categories" : [ "A", "D" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454b",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb428189454e",
      "name" : "Chemistry",
      "categories" : [ "A" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb428189454e",
          "templated" : false
        }
      }
    }, {
      "id" : "5cb499c9fd5beb4281894567",
      "name" : "Social Studies",
      "categories" : [ "F" ],
      "_links" : {
        "self" : {
          "href" : "https://api.boclips.com/v1/subjects/5cb499c9fd5beb4281894567",
          "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

Links

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
X-Boclips-Trace-ID: b9dcc290dd844b66
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Type: application/hal+json
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
X-Boclips-Trace-ID: d69f23c9b4bf61d2
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Type: application/hal+json
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
X-Boclips-Trace-ID: f8c2407b3ee0dfd0
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: 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
X-Boclips-Trace-ID: 059d67ee4cb044e8
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: 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

Content Partners

This is now deprecated in favour of channels

Channels

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

Retrieving one channel

HTTP request

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

Example request

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

Example response

HTTP/1.1 200 OK
X-Boclips-Trace-ID: 724507ad1af5e76b
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 861

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

Response fields

Path Type Description

id

String

The ID of the channel

name

String

The name of the channel

legalRestriction

Object

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

description

String

Text describing this channel’s content

contentCategories[*].label

String

Content category label

language.code

String

Language in 3 letter ISO-639-2 code format

language.name

String

Name of the channel language

_links

Object

HAL links related to this collection

contentTypes

Array

Deprecated in favour of contentType

contentType

String

The type of content the channel produces

notes

String

Custom notes about the channel

oneLineDescription

Null

A snappy, high-energy description of the channel

Retrieving many channels

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
X-Boclips-Trace-ID: 20784aa21ad658ce
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
Vary: accept-encoding
Access-Control-Expose-Headers: *
X-XSS-Protection: 1; mode=block
Content-Encoding: gzip
Content-Type: application/hal+json
Via: 1.1 google
Alt-Svc: h3=":443"; ma=2592000,h3-29=":443"; ma=2592000
Content-Length: 135341

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

Response fields

Path Type Description

_embedded.channels

Array

Channels resources array. See the channel resource for payload details