WARNING: This API has been deprecated and should not be used for new projects. Click here for more information.

Media API Sample: search_videos

This example uses the search_videos() READ method, which allows you to perform complex searches for videos. You can search any standard or custom data field, and you can have multiple all, any, and none terms to include and exclude videos from the search results.

All READ method samples are made using the JavaScript MAPI wrapper.

Note: making this call from the client side exposes your read token, which could allow a developer to access all video data from your account. If you use the READ token with URL access, that developer could even download copies of all your video files. Brightcove recommends making all Media API calls from a server-side application if possible.

Search Input

Read token:

Service URL:

Return videos that have all of these terms:
(go here for usage - e.g. to search for a tag: "tag:fish")

Return videos that have any of these terms:
(go here for usage - e.g. to search for a tag: "tag:fish")

Return videos that have none of these terms:
(go here for usage - e.g. to search for a tag: "tag:fish")

Sort by:

Page size:   Page number:

Only the first page is available until you make a search; then the available pages are recalculated.

Total items:

Video fields to return:

For details about the video fields, refer to the Video object in the Media API Reference document.

You must use a read token with URL access to return FLVURL, renditions, iOSRenditions, FLVFullLength, and videoFullLength.

The following fields are not returned unless they are explicityly included in the video_fields parameter: iOSRenditions, captioning, digitalMaster, logoOverlay, thumbnail, videoPreview, videoStill, accountId, itemState, startDate, endDate, geoRestricted, geoFilteredCountries, geoFilterExclude, WVMRenditions and HLSURL..

Media delivery:

Search for Videos

Media API Request

Below is the request sent to the Media API service:

JSON Response

Below is the JSON data returned by the request:

JSON Response

Processed Response

Below is simple HTML output of the video names using the Handlebars templating system: