WARNING: This API has been deprecated and should not be used for new projects. Support for write methods were discontinued on June 30, 2017, and read methods will be discontinued on December 31, 2017. Click here for more information.

Media API Sample: find_video_by_reference_id

This example uses the find_video_by_reference_id() READ method, which allows you to retrieve data for a video, even if it is inactive, unscheduled, or deleted.

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:

Reference ID of the video you want to find: (required)

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:

Find 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: