GET
/
streaming
/
videos
curl --request GET \
  --url https://api.gcore.com/streaming/videos \
  --header 'APIKey: <api-key>'
[
  {
    "id": 70575,
    "name": "Coffee Run - Blender Open Movie 720p",
    "description": "Fueled by caffeine, a young woman runs through the bittersweet memories of her past relationship. Coffee Run was directed by Hjalti Hjalmarsson and produced by the team at Blender Studio.",
    "client_id": 1,
    "duration": 184669,
    "slug": "xMbWbUSuvJ8NX2",
    "status": "ready",
    "origin_size": 29260881,
    "origin_video_duration": 184669,
    "origin_audio_channels": 2,
    "origin_height": 804,
    "origin_width": 1920,
    "created_at": "2024-06-13T12:15:25.000Z",
    "updated_at": "2024-07-26T15:30:50.000Z",
    "clip_start_seconds": null,
    "clip_duration_seconds": null,
    "hls_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.m3u8",
    "hls_cmaf_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master-cmaf.m3u8",
    "dash_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/master.mpd",
    "iframe_url": "https://player.gvideo.co/videos/2675_FnlHXwA16ZMxmUr",
    "poster": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "poster_thumb": "https://static.gvideo.co/videoplatform/posters/video/2474723/thumb_f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshot": "https://static.gvideo.co/videoplatform/posters/video/2474723/f9767f071a8b7da51c64907f6a830cbb.webp",
    "screenshots": [
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_1_1080.jpg",
      "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_2_1080.jpg"
    ],
    "screenshot_id": -1,
    "views": 2000001,
    "cdn_views": 30000003,
    "projection": "regular",
    "sprite": "https://static.gvideo.co/videoplatform/sprites/2675/2474723_FnlHXwA16ZMxmUr.mp4_sprite.jpg",
    "sprite_vtt": "1\n00:00:00,000 --> 00:00:05,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=0,0,100,42\n\n2\n00:00:05,000 --> 00:00:10,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=100,0,100,42\n\n3\n00:00:10,000 --> 00:00:15,000\nxMbWbUSuvJ8NX2_sprite.jpg#xywh=200,0,100,42\n",
    "converted_videos": [
      {
        "id": 25889825,
        "name": "vod720p",
        "width": 1719,
        "height": 720,
        "size": 29929272,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3570v1_h264_1267_720.mp4"
      },
      {
        "id": 25889828,
        "name": "vod480p",
        "width": 1146,
        "height": 480,
        "size": 20827007,
        "progress": 100,
        "status": "complete",
        "mp4_url": "https://demo-public.gvideo.io/videos/2675_p0jh5kwH6F0ff2H6/qid3573v1_h264_800_480.mp4"
      }
    ]
  }
]

Authorizations

​
APIKey
string
header
required

API key for authentication.

Query Parameters

​
id
string

IDs of the videos to find. You can specify one or more identifiers separated by commas. Example, ?id=1,101,1001

​
search
string

Aggregated search condition. If set, the video list is filtered by one combined SQL criterion:

  • id={s} OR slug={s} OR name like {s} i.e. "/videos?search=1000" returns list of videos where id=1000 or slug=1000 or name contains "1000".
​
status
string

Use it to get videos filtered by their status. Possible values:

  • empty
  • pending
  • viewable
  • ready
  • error
​
client_user_id
integer

Find videos where "client_user_id" meta field is equal to the search value

​
stream_id
integer

Find videos recorded from a specific stream, so for which "stream_id" field is equal to the search value

​
fields
string

Restriction to return only the specified attributes, instead of the entire dataset. Specify, if you need to get short response. The following fields are available for specifying: id, name, duration, status, created_at, updated_at, hls_url, screenshots, converted_videos, priority, stream_id. Example, ?fields=id,name,hls_url

​
page
integer

Page number. Use it to list the paginated content

​
per_page
integer

Items per page number. Use it to list the paginated content

Response

200 - application/json

Successful

The response is of type object[].