Trigger a media extraction job
curl --request POST \
--url https://api.brightdata.com/dca/trigger_hp \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"url": "https://www.video-page-example.com/v=89438398439",
"format": "all_audio_tracks+video",
"captions": true,
"captions_format": "vtt",
"min_height": 720,
"max_height": 1440,
"orientation": [
"vertical",
"horizontal",
"square"
],
"quality_priority": "highest",
"thumbnail": true,
"storyboards": true
}
]
'import requests
url = "https://api.brightdata.com/dca/trigger_hp"
payload = [
{
"url": "https://www.video-page-example.com/v=89438398439",
"format": "all_audio_tracks+video",
"captions": True,
"captions_format": "vtt",
"min_height": 720,
"max_height": 1440,
"orientation": ["vertical", "horizontal", "square"],
"quality_priority": "highest",
"thumbnail": True,
"storyboards": True
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
url: 'https://www.video-page-example.com/v=89438398439',
format: 'all_audio_tracks+video',
captions: true,
captions_format: 'vtt',
min_height: 720,
max_height: 1440,
orientation: ['vertical', 'horizontal', 'square'],
quality_priority: 'highest',
thumbnail: true,
storyboards: true
}
])
};
fetch('https://api.brightdata.com/dca/trigger_hp', 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.brightdata.com/dca/trigger_hp",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'url' => 'https://www.video-page-example.com/v=89438398439',
'format' => 'all_audio_tracks+video',
'captions' => true,
'captions_format' => 'vtt',
'min_height' => 720,
'max_height' => 1440,
'orientation' => [
'vertical',
'horizontal',
'square'
],
'quality_priority' => 'highest',
'thumbnail' => true,
'storyboards' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/dca/trigger_hp"
payload := strings.NewReader("[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.brightdata.com/dca/trigger_hp")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/dca/trigger_hp")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"inputs": 1,
"job_id": "hp_mn1l61rn1p94ynijur"
}Media Data API
Media Data API
Use the Bright Data Media Data API to retrieve video, audio, captions, thumbnails and storyboards from 4 platforms: YouTube, Vimeo, TikTok and Bilibili.
POST
/
dca
/
trigger_hp
Trigger a media extraction job
curl --request POST \
--url https://api.brightdata.com/dca/trigger_hp \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
[
{
"url": "https://www.video-page-example.com/v=89438398439",
"format": "all_audio_tracks+video",
"captions": true,
"captions_format": "vtt",
"min_height": 720,
"max_height": 1440,
"orientation": [
"vertical",
"horizontal",
"square"
],
"quality_priority": "highest",
"thumbnail": true,
"storyboards": true
}
]
'import requests
url = "https://api.brightdata.com/dca/trigger_hp"
payload = [
{
"url": "https://www.video-page-example.com/v=89438398439",
"format": "all_audio_tracks+video",
"captions": True,
"captions_format": "vtt",
"min_height": 720,
"max_height": 1440,
"orientation": ["vertical", "horizontal", "square"],
"quality_priority": "highest",
"thumbnail": True,
"storyboards": True
}
]
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify([
{
url: 'https://www.video-page-example.com/v=89438398439',
format: 'all_audio_tracks+video',
captions: true,
captions_format: 'vtt',
min_height: 720,
max_height: 1440,
orientation: ['vertical', 'horizontal', 'square'],
quality_priority: 'highest',
thumbnail: true,
storyboards: true
}
])
};
fetch('https://api.brightdata.com/dca/trigger_hp', 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.brightdata.com/dca/trigger_hp",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
[
'url' => 'https://www.video-page-example.com/v=89438398439',
'format' => 'all_audio_tracks+video',
'captions' => true,
'captions_format' => 'vtt',
'min_height' => 720,
'max_height' => 1440,
'orientation' => [
'vertical',
'horizontal',
'square'
],
'quality_priority' => 'highest',
'thumbnail' => true,
'storyboards' => true
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.brightdata.com/dca/trigger_hp"
payload := strings.NewReader("[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.brightdata.com/dca/trigger_hp")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.brightdata.com/dca/trigger_hp")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "[\n {\n \"url\": \"https://www.video-page-example.com/v=89438398439\",\n \"format\": \"all_audio_tracks+video\",\n \"captions\": true,\n \"captions_format\": \"vtt\",\n \"min_height\": 720,\n \"max_height\": 1440,\n \"orientation\": [\n \"vertical\",\n \"horizontal\",\n \"square\"\n ],\n \"quality_priority\": \"highest\",\n \"thumbnail\": true,\n \"storyboards\": true\n }\n]"
response = http.request(request)
puts response.read_body{
"success": true,
"inputs": 1,
"job_id": "hp_mn1l61rn1p94ynijur"
}The Media Data API is not enabled by default. Contact support@brightdata.com to enable it for your account.
- Multimodal model training: Download video and audio tracks to build training datasets for vision-language models, audio classification, and video understanding tasks.
- Caption and transcript collection: Retrieve structured captions in VTT, SRT, or JSON format for speech recognition fine-tuning and text-video alignment.
- Thumbnail and storyboard extraction: Collect visual frames for image model training, scene classification, and content analysis pipelines.
A delivery destination is required for every request. Configure a delivery destination before sending your first request. See Deliver results.
Input fields
The request body is a JSON array. Each object in the array is a separate download job.The full URL of the video to download. Supported platforms: YouTube, Vimeo, TikTok, Bilibili.
Specifies what content type to download.
| Value | Description |
|---|---|
full | Downloads the video with the default audio track |
video_only | Downloads the video stream without audio |
audio_only | Downloads the default audio track only |
all_audio_tracks | Downloads all available audio tracks (for example, multiple languages) without video |
all_audio_tracks+video | Downloads the video together with all available audio tracks |
none | Skips media download. Use when you only need captions, thumbnails, or storyboards |
The file format for downloaded captions. Only applies when
captions is true.| Value | Description |
|---|---|
vtt | WebVTT format |
srt | SubRip format |
json3 | JSON format |
Minimum accepted video resolution, expressed as a vertical pixel count. The download proceeds only if a resolution at or above this height is available.Common values:
360, 480, 720, 1080, 1440, 2160Maximum accepted video resolution, expressed as a vertical pixel count. The download proceeds only if a resolution at or below this height is available.Common values:
360, 480, 720, 1080, 1440, 2160Restricts the download to videos with the listed orientations. Accepts one or more values. When
Example:
orientation is omitted, all three orientations are accepted.| Value | Description |
|---|---|
vertical | Portrait videos, where height is greater than width |
horizontal | Landscape videos, where width is greater than height |
square | Videos with equal width and height |
["vertical", "square"]Selects which of the available renditions to download when more than one satisfies
min_height and max_height.| Value | Description |
|---|---|
highest | Downloads the highest available quality |
lowest | Downloads the lowest available quality |
Prioritizes the highest or lowest file size selected for download within the chosen height range (
min_height and max_height ).| Value | Description |
|---|---|
highest | Downloads the format with the highest available file size |
lowest | Downloads the format with the lowest available file size |
Whether to include the video’s storyboard images (sprite sheets used for timeline preview scrubbing) in the results.
A custom path for file upload. Overrides the path configured in your delivery settings. Supports template variables:
{{datetime}}, {{video_id}}, {{job}}.Example: "my-videos/{{video_id}}/{{datetime}}"A custom filename for uploaded files. The value is used as the base name across all output files (e.g.
<filename>.mp4, <filename>.metadata.json, <filename>.sub.0). Supports template variables: {{datetime}}, {{video_id}}, {{job}}.Example: "{{video_id}}_{{datetime}}"Authorizations
Your Bright Data API key. Find it in the Bright Data Control Panel.
Query Parameters
Body
application/json
A JSON array of extraction job objects. Each object represents one media extraction job. Multiple jobs can be submitted in a single request.
Minimum array length:
1Was this page helpful?