Documentation Center

Get a Brightcove Video Cloud asset

Use the externalItem GraphQL query get a single video, playlist or player from Brightcove Video Cloud.

Entity types

This query supports following entity types:
  • BrightcoveVideo (or vid)
  • BrightcovePlaylist
  • BrightcovePlayer (or plr)

Example request and response for a video

The first sample code block illustrates a request to retrieve a video asset from Brightcove Video Cloud. The second code block illustrates the corresponding response with with the requested content item details.

RequestResponse
{
  externalItem(eclUri: "ecl:2-brightcove-6190897370001-BrightcoveVideo-file") {
    ... on BrightcoveVideo {
      videoId
      accountId
      title
      filename
     binaryReference
      thumbnail
      images{
        type
        src
        width
        height
      }
      link
      {
        text
        url
      }
      longDescription
      tags
    }
  }
}





{
  "data": {
    "externalItem": {
      "videoId": "61590297",
      "accountId": "12345678",
      "title": "Aircooling",
      "filename": null,
      "binaryReference": null,
      "thumbnail": "http://10.111.22.000:8081/cd/api/external/binary/brightcove/eyJDb250Z",
      "images": [
        {
          "type": "Thumbnail",
          "src": "https://cf-images.eu-1.prod.adns.net/v1/static/6159029/8165ebce/f756d3/160x90/match/image.jpg",
          "width": 160,
          "height": 90
        },
        {
          "type": "Poster",
          "src": "https://cf-images.eu-1.prod.adns.net/v1/static/615902979/8165ebce/90b9351d/1280x720/match/image.jpg",
          "width": 1280,
          "height": 720
        }
      ],
      "link": null,
      "longDescription": null,
      "tags": [
        "animation"
      ]
    }
  }
}

Example request and response for a video playlist

This example retrieves a playlist from Brightcove Video Cloud.

RequestResponse
{
  externalItem(eclUri: "ecl:2-brightcove-16788306-BrightcovePlaylist-file") {
    ... on BrightcovePlaylist {
    playlistId
      accountId
      title
      filename
     binaryReference
      thumbnail       
      tags
      videoIds
      type
    }
  }
}





{
  "data": {
    "externalItem": {
      "playlistId": "16788302",
      "accountId": "123456789",
      "title": "BUILD-Pexels",
      "filename": null,
      "binaryReference": null,
      "thumbnail": null,
      "tags": null,
      "videoIds": [
        "6169646326001",
        "6191480028001",
        "6168930994001",
        "6191479633001",
        "6180892130001"
      ],
      "type": "EXPLICIT"
    }
  }
}

Example request and response for a player

This example retrieves a video player from Brightcove Video Cloud.

RequestResponse
{
  externalItem(eclUri: "ecl:2-brightcove-16788306-BrightcovePlaylist-file") {
    ... on BrightcovePlaylist {
    playlistId
      accountId
      title
      filename
     binaryReference
      thumbnail       
      tags
      videoIds
      type
    }
  }
}





{
  "data": {
    "externalItem": {
      "playlistId": "16788306",
      "accountId": "61590297",
      "title": "BUILD-Pexels",
      "filename": null,
      "binaryReference": null,
      "thumbnail": null,
      "tags": null,
      "videoIds": [
        "6169646326001",
        "6191480028001",
        "6168930994001",
        "6191479633001",
        "6180892130001"
      ],
      "type": "EXPLICIT"
    }
  }
}