Get list of directories

curl --request GET \
  --url https://api.gcore.com/streaming/directories \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.gcore.com/streaming/directories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/streaming/directories",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/streaming/directories"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/streaming/directories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": 100,
      "item_type": "Directory",
      "name": "New series",
      "parent_id": null,
      "client_id": 102748,
      "items_count": 2,
      "created_at": "2024-07-01T18:00:00Z",
      "updated_at": "2024-07-01T18:00:00Z"
    },
    {
      "id": 4734454,
      "name": "Season 1, Official Trailer 2024",
      "item_type": "Video",
      "slug": "2Y20240219074738"
    }
  ]
}

Directories

Get list of directories

List of directories and videos at the root level of the client’s video hosting. For the hierarchical structure, use the “/directories/tree” method.

Use the “id” of a directory from this list as “directory_id” when uploading videos or creating subdirectories.

The list is paginated. Use “page” and “per_page” to go through it. The pagination data is returned in the “x-page”, “x-per-page”, “x-total” and “x-total-pages” response headers. A page past the end returns an empty “items” array.

The items are sorted: directories first, then videos. Within each group the newest items come first.

GET

streaming

directories

Get list of directories

curl --request GET \
  --url https://api.gcore.com/streaming/directories \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.gcore.com/streaming/directories', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gcore.com/streaming/directories",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gcore.com/streaming/directories"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gcore.com/streaming/directories")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "items": [
    {
      "id": 100,
      "item_type": "Directory",
      "name": "New series",
      "parent_id": null,
      "client_id": 102748,
      "items_count": 2,
      "created_at": "2024-07-01T18:00:00Z",
      "updated_at": "2024-07-01T18:00:00Z"
    },
    {
      "id": 4734454,
      "name": "Season 1, Official Trailer 2024",
      "item_type": "Video",
      "slug": "2Y20240219074738"
    }
  ]
}

Authorizations

Authorization

string

header

required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Query Parameters

page

integer

default:1

Page number. Starts at 1.

Required range: x >= 1

per_page

integer

default:25

Number of items (directories and videos) per page. The maximum is 100, a larger value is reduced to 100.

Required range: 1 <= x <= 100

string

Case-insensitive search by part of the name or slug of directories and videos. When set, the search covers all levels of the client's directories, not only the root level. The characters "_" and "%" in the search text work as wildcards (any one character, any number of characters).

Response

200 - application/json

Successful

items

object[]

required

Directories and videos at the root level of the client's video hosting, in one list. Paginated, see the "page" and "per_page" parameters. Empty array if there is nothing at the root level or the page is past the end.

Option 1
Option 2

Show child attributes

Example:

{
  "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": "FnlHXwA16ZMxmUr",
  "status": "ready",
  "origin_size": 29260881,
  "origin_video_duration": 184669,
  "created_at": "2024-06-13T12:15:25.000Z",
  "updated_at": "2024-07-26T15:30:50.000Z",
  "record_type": null,
  "directory_id": 800,
  "quality_set_id": null,
  "priority": 0,
  "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",
  "poster": "https://static.gvideo.co/videoplatform/posters/video/10507272/f55b7db5f7a1ea48d713d7e6806bb9c5.jpeg",
  "poster_thumb": "https://static.gvideo.co/videoplatform/posters/video/10507272/thumb_f55b7db5f7a1ea48d713d7e6806bb9c5.jpeg",
  "screenshot": "https://static.gvideo.co/videoplatform/posters/video/10507272/f55b7db5f7a1ea48d713d7e6806bb9c5.jpeg",
  "screenshots": [
    "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_2_1080.jpg",
    "https://static.gvideo.co/videoplatform/thumbnails/2675/2474723_FnlHXwA16ZMxmUr.mp4_3_1080.jpg"
  ],
  "screenshot_id": -1,
  "views": 2000001,
  "cdn_views": 30000003,
  "projection": "regular",
  "converted_videos": [
    {
      "id": 25889825,
      "name": "vod720p",
      "width": 1719,
      "height": 720,
      "size": 37651798,
      "progress": 100,
      "status": "complete",
      "mp4_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/qid3570v3_h264_1566_720.mp4"
    },
    {
      "id": 25889828,
      "name": "vod480p",
      "width": 1146,
      "height": 480,
      "size": 20255892,
      "progress": 100,
      "status": "complete",
      "mp4_url": "https://demo-public.gvideo.io/videos/2675_FnlHXwA16ZMxmUr/qid3573v3_h264_800_468.mp4"
    }
  ],
  "item_type": "Video"
}

Overview

IAM

CDN

Managed DNS

Cloud

DDoS Protection

Edge Proxy

FastEdge

WAAP

Streaming

Object Storage

Resellers

Get list of directories

Authorizations

Query Parameters

Response