import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
playlist_videos = client.streaming.playlists.videos.list(
0,
)
print(playlist_videos)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/option"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
playlistVideos, err := client.Streaming.Playlists.Videos.List(context.TODO(), 0)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", playlistVideos)
}
curl --request GET \
--url https://api.gcore.com/streaming/playlists/{playlist_id}/videos \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.gcore.com/streaming/playlists/{playlist_id}/videos', 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/playlists/{playlist_id}/videos",
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;
}HttpResponse<String> response = Unirest.get("https://api.gcore.com/streaming/playlists/{playlist_id}/videos")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/streaming/playlists/{playlist_id}/videos")
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[
{
"name": "IBC 2026 - International Broadcasting Convention",
"description": "We look forward to welcoming you at IBC2026, which will take place 11-14 September 2026.",
"origin_url": "https://www.googleapis.com/drive/v3/files/...?alt=media",
"origin_http_headers": "Authorization: Bearer ...",
"priority": 0,
"clip_start_seconds": 137,
"clip_duration_seconds": 60,
"directory_id": 800,
"projection": "regular",
"client_user_id": 10,
"poster": "data:image/jpeg;base64,/9j/4AA...qf/2Q==",
"screenshot_id": -1,
"auto_transcribe_audio_language": "auto"
}
]Get playlist videos
Shows ordered array of playlist videos
import os
from gcore import Gcore
client = Gcore(
api_key=os.environ.get("GCORE_API_KEY"), # This is the default and can be omitted
)
playlist_videos = client.streaming.playlists.videos.list(
0,
)
print(playlist_videos)package main
import (
"context"
"fmt"
"github.com/G-Core/gcore-go"
"github.com/G-Core/gcore-go/option"
)
func main() {
client := gcore.NewClient(
option.WithAPIKey("My API Key"),
)
playlistVideos, err := client.Streaming.Playlists.Videos.List(context.TODO(), 0)
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", playlistVideos)
}
curl --request GET \
--url https://api.gcore.com/streaming/playlists/{playlist_id}/videos \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.gcore.com/streaming/playlists/{playlist_id}/videos', 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/playlists/{playlist_id}/videos",
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;
}HttpResponse<String> response = Unirest.get("https://api.gcore.com/streaming/playlists/{playlist_id}/videos")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gcore.com/streaming/playlists/{playlist_id}/videos")
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[
{
"name": "IBC 2026 - International Broadcasting Convention",
"description": "We look forward to welcoming you at IBC2026, which will take place 11-14 September 2026.",
"origin_url": "https://www.googleapis.com/drive/v3/files/...?alt=media",
"origin_http_headers": "Authorization: Bearer ...",
"priority": 0,
"clip_start_seconds": 137,
"clip_duration_seconds": 60,
"directory_id": 800,
"projection": "regular",
"client_user_id": 10,
"poster": "data:image/jpeg;base64,/9j/4AA...qf/2Q==",
"screenshot_id": -1,
"auto_transcribe_audio_language": "auto"
}
]Authorizations
Path Parameters
Response
Successful
Authorization HTTP request header. Will be used as credentials to authenticate a request to download a file (specified in "origin_url" parameter) on an external server.
Syntax: Authorization: <auth-scheme> <authorization-parameters>
Examples:
- "origin_http_headers": "Authorization: Basic ..."
- "origin_http_headers": "Authorization: Bearer ..."
- "origin_http_headers": "Authorization: APIKey ..." Example of usage when downloading a file from Google Drive:
POST https://api.gcore.com/streaming/videos
"video": {
"name": "IBC 2024 intro.mp4",
"origin_url": "https://www.googleapis.com/drive/v3/files/...?alt=media",
"origin_http_headers": "Authorization: Bearer ABC"
}
Priority allows you to adjust the urgency of processing some videos before others in your account, if your algorithm requires it. For example, when there are very urgent video and some regular ones that can wait in the queue.
Value range, integer [-10..10]. -10 is the lowest down-priority, 10 is the highest up-priority. Default priority is 0.
The option allows you to set the video transcoding rule so that the output bitrate in ABR ladder is not exceeding the bitrate of the original video.
This option is for advanced users only.
By default source_bitrate_limit: true this option allows you to have the output bitrate not more than in the original video, thus to transcode video faster and to deliver it to end-viewers faster as well. At the same time, the quality will be similar to the original.
If for some reason you need more byte-space in the output quality when encoding, you can set this option to source_bitrate_limit: false. Then, when transcoding, the quality ceiling will be raised from the bitrate of the original video to the maximum possible limit specified in our the Product Documentation.
For example, this may be needed when:
- to improve the visual quality parameters using PSNR, SSIM, VMAF metrics,
- to improve the picture quality on dynamic scenes,
- etc.
The option is applied only at the video creation stage and cannot be changed later. If you want to re-transcode the video using new value, then you need to create and upload a new video only.
Poster is your own static image which can be displayed before the video starts.
After uploading the video, the system will automatically create several screenshots (they will be stored in "screenshots" attribute) from which you can select an default screenshot. This "poster" field is for uploading your own image. Also use attribute "screenshot_id" to select poster as a default screenshot.
Attribute accepts single image as base64-encoded string (RFC 2397 – The "data" URL scheme). In format: data:[<mediatype>];base64,<data>
MIME-types are image/jpeg, image/webp, and image/png and file sizes up to 1Mb.
Examples:
data:image/jpeg;base64,/9j/4AA...qf/2Q==data:image/png;base64,iVBORw0KGg...ggg==data:image/webp;base64,UklGRt.../DgAAAAA
Default screenshot index.
Specify an ID from the "screenshots" array, so that the URL of the required screenshot appears in the "screenshot" attribute as the default screenshot. By default 5 static screenshots will be taken from different places in the video after transcoding. If the video is short, there may be fewer screenshots.
Counting from 0. A value of -1 sets the default screenshot to the URL of your own image from the "poster" attribute.
Look at "screenshot" attribute in GET /videos/{video_id} for details.
Automatic creation of subtitles by transcribing the audio track.
Values:
- disable – Do not transcribe.
- auto – Automatically detects the activation of the option based on the settings in your account. If generation is activated, then automatic language detection while transcribing.
- \ – Transcribe from specific language. Can be used to specify the exact language spoken in the audio track, or when auto language detection fails. Language is set by 3-letter language code according to ISO-639-2 (bibliographic code). List of languages is available in
audio_languageattribute of API POST /streaming/ai/transcribe .
Example:
auto_transcribe_audio_language: "auto"
auto_transcribe_audio_language: "ger"
More details:
- List of AI tasks – API GET /streaming/ai/tasks
- Add subtitles to an exist video – API POST /streaming/videos/{
video_id}/subtitles.
disable, auto, <language_code> Automatic translation of auto-transcribed subtitles to the specified language(s). Can be used both together with auto_transcribe_audio_language option only.
Use it when you want to make automatic subtitles in languages other than the original language in audio.
Values:
- disable – Do not translate.
- default – There are 3 default languages: eng,fre,ger
- \ – Explicit language to translate to, or list of languages separated by a comma. Look at list of available languages in description of AI ASR task creation.
If several languages are specified for translation, a separate subtitle will be generated for each language.
Example:
auto_translate_subtitles_language: default
auto_translate_subtitles_language: eng,fre,ger
Please note that subtitle translation is done separately and after transcription. Thus separate AI-tasks are created for translation.
disable, default, <language_codes,> Was this page helpful?