YouTube Scraper API endpoints

This guide shows you how to send a synchronous request to each Bright Data YouTube Scraper API endpoint. It covers channels, videos, and comments.

Prerequisites

A Bright Data account with an active API key
Completed the Quickstart

Request structure

Every synchronous request follows the same pattern:

POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.youtube.com/..."}]

The only thing that changes between endpoints is the dataset_id and the input URL format.

The /scrape endpoint is built for real-time, single-URL requests. It accepts up to 20 URLs and waits up to 1 minute. If collection takes longer, the response is HTTP 202 with a snapshot_id instead of data, and collection continues asynchronously. Fetch the result with async requests or have it pushed to you with webhook delivery.

How to scrape YouTube channels

Dataset ID: gd_lk538t2k2p1k3oos71

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk538t2k2p1k3oos71&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/@MrBeast"}]'

You should see a 200 response. Processing time varies with target-site conditions and scraper workload.

Example response

[
  {
    "subscribers": 516000000,
    "url": "https://www.youtube.com/@mrbeast",
    "handle": "@MrBeast",
    "handle_md5": "dd748d5dfc88b91ea388429c3c685874",
    "banner_img": "https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-...",
    "profile_image": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
    "name": "MrBeast",
    "Description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000...",
    "videos_count": 1000,
    "created_date": "2012-02-19T00:00:00.000Z"
  }
]

Full Channels response schema

How to scrape YouTube videos

Dataset ID: gd_lk56epmy2i5g7lzu0k

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk56epmy2i5g7lzu0k&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'

Example response

[
  {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
    "views": 1812511291,
    "likes": 19374379,
    "date_posted": "2009-10-25T06:57:33.000Z",
    "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick...",
    "num_comments": 2457228,
    "youtuber": "@RickAstleyYT",
    "youtuber_md5": "4fc65cd6213b5c0f1d04c2aa3006f46a",
    "video_url": "https://rr2---sn-n4v7snse.googlevideo.com/videoplayback?expire=1788712345&ei=OUGdaoSULZ-RsfIP8OmfsAo&ip=208.41.164.3&id=o-ALklNMQDHiVh32KdRiuWf9qyPo-8mNxywN-..."
  }
]

Full Videos response schema

How to scrape YouTube comments

Dataset ID: gd_lk9q0ew71spt1mxywf

curl -X POST \
  "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_lk9q0ew71spt1mxywf&format=json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}]'

Example response

[
  {
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "likes": 311000,
    "replies": 0,
    "comment_id": "Ugzge340dBgB75hWBm54AaABAg",
    "comment_text": "can confirm: he never gave us up",
    "username": "@Yo***e",
    "username_md5": "0e4d7a0778633b4acf6631dd251f0797",
    "user_channel": "https://www.youtube.com/@YouTube",
    "date": "1 year ago",
    "video_id": "dQw4w9WgXcQ"
  }
]

Full Comments response schema

Quick reference: dataset IDs

Endpoint	Dataset ID	URL pattern
Videos	`gd_lk56epmy2i5g7lzu0k`	`youtube.com/watch?v={video_id}`
Channels	`gd_lk538t2k2p1k3oos71`	`youtube.com/@{handle}`
Comments	`gd_lk9q0ew71spt1mxywf`	`youtube.com/watch?v={video_id}`

Output formats

Control the response format with the format query parameter:

Value	Description
`json`	JSON array (default)
`ndjson`	Newline-delimited JSON, one record per line
`csv`	Comma-separated values

Async batch requests

Scrape hundreds of URLs in a single batch job.

API reference

Full parameter and response field reference.

Get started

Data extraction

Web access

AI training data

Proxy networks

YouTube Scraper API endpoints

Prerequisites

Request structure

How to scrape YouTube channels

How to scrape YouTube videos

How to scrape YouTube comments

Quick reference: dataset IDs

Output formats

Async batch requests

API reference

​Prerequisites

​Request structure

​How to scrape YouTube channels

​How to scrape YouTube videos

​How to scrape YouTube comments

​Quick reference: dataset IDs

​Output formats

​Related

Async batch requests

API reference

Prerequisites

Request structure

How to scrape YouTube channels

How to scrape YouTube videos

How to scrape YouTube comments

Quick reference: dataset IDs

Output formats

Related