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.
- 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.
Input fields
The request body is a JSON array. Each object in the array is a separate download job.captions is true.360, 480, 720, 1080, 1440, 2160360, 480, 720, 1080, 1440, 2160{{datetime}}, {{video_id}}, {{job}}.Example: "my-videos/{{video_id}}/{{datetime}}"<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
Your Media Extraction collector ID. This is a fixed value assigned when the feature is enabled on your account.
"YOUR_COLLECTOR_ID"
Body
A JSON array of extraction job objects. Each object represents one media extraction job. Multiple jobs can be submitted in a single request.
1The full URL of the video to download. Supported platforms: YouTube, Vimeo, TikTok, Bilibili.
"https://www.video-page-example.com/v=89438398439"
Specifies what content type to download.
full, video_only, audio_only, all_audio_tracks, all_audio_tracks+video, none Whether to download available captions or subtitles for the video.
The file format for downloaded captions. Only applies when captions is true. Supported formats: vtt, srt, json3.
vtt, srt, json3 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, 2160.
720
Maximum 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, 2160.
1440
Whether to include the video's thumbnail image in the results.
Whether to include the video's storyboard images (sprite sheets used for timeline preview scrubbing) in the results.