YouTube profile (v1)
A YouTube channel and its videos, paged with a cursor.
A channel's header record and a page of its content.
type selects which tab to read, so videos and Shorts come from the same
endpoint. Address the channel by channel_id or by username.
Counts and upload timestamps are exact. Where a count is not published,
the field is null rather than a rounded guess. include_comment_count
attaches comment counts, which costs an extra request per video.
Shorts and long-form video are returned from the same channel endpoint and are labelled by content type rather than by duration.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 27.3s.
Authorization
ApiKeyAuth Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/youtube-profile" \ -H "Content-Type: application/json" \ -d '{ "username": "@MrBeast", "type": "video" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "available_country_codes": [ "KH", "AD", "… 247 more items in the full response" ], "channel_id": "UCX6OQ3DkcsbYNE6H8uQQuVA", "description": "SUBSCRIBE FOR A an authenticated session!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- B… (+652 chars)", "is_family_safe": true, "keywords": "mrbeast6000 beast mrbeast Mr.Beast mr", "subscriber_count_text": "514M subscribers", "title": "MrBeast" }, "main": [ { "caption": "Escape 100 Cops, Win $500,000\n\nis it possible to escape 100 cops?\n\nSponsored by Call of Duty: Mobile\nDownload it for FREE today:https://codmatvi.onelink.me/jYL7/91xx2x6j\n\nCOD Point Rush Event Details: COD Point Rush runs through September 9, 2026 (UTC). Void where prohibited. Time limited COD Points can be used towards… (+2053 chars)", "comment_count": 46272, "creator_handle": "@MrBeast", "hashtags": [], "like_count": 874764, "post_id": "Qtl8lJwbd4g", "post_url": "https://www.youtube.com/watch?v=Qtl8lJwbd4g", "profile_picture_url": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE", "save_count": null, "share_count": null, "thumbnail_url": "https://i.ytimg.com/vi/Qtl8lJwbd4g/hq720.jpg", "upload_timestamp": 1787414405, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 23695858 }, { "caption": "Last To Leave Mansion, Keeps It\n\nimagine living in a mansion with strangers for months\n\nClick the link to subscribe to Homecare+ and get 7 services handled by a trained Lowe’s associate for just $99 / Year: https://www.lowes.com/homecareplus\n\nBack-to-school starts at Old Navy. Shop denim, fleece, activewear, graphic te… (+1385 chars)", "comment_count": 164515, "creator_handle": "@MrBeast", "hashtags": [], "like_count": 2070477, "post_id": "Af6i6ChAVTw", "post_url": "https://www.youtube.com/watch?v=Af6i6ChAVTw", "profile_picture_url": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE", "save_count": null, "share_count": null, "thumbnail_url": "https://i.ytimg.com/vi/Af6i6ChAVTw/hq720.jpg", "upload_timestamp": 1786204801, "video_url": null, "video_urls_by_quality": { "high": null, "low": null, "medium": null, "watermarked": null }, "view_count": 93909783 }, "… 28 more items in the full response" ] }, "hasMore": true, "nextCursor": "B1:H4sIAHrhimoA_21Xa3OjOBb9K6xrdne2qnsa7Did9DeDETYOYAtJ2GxPpYQhASMeDTjYnpr_vrrq19TufoiCdM8999yHVMkfk7fJJ-PdJDm_TD79-_d3k-sw-TS5-1Kh_vUptcz1gVH_4JeP2NNxd5j5RUTnyC9f71KGcMpi0-kX68BJ86R0m2M0WEmNml3VXmLq1sl0CBKq6xFLmW8b9m6PfWyjGaHemLF2TwjymJM3kcAslfb4xjizbZ3sWzejj_uIYJSWhkNZGlGURqS8kKyUKJuFlLG5txIRI-wcLc2QVP6aVI-nTLTDgeab0… (+3371 chars)" }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "youtube-profile", "billable": true, "duration_ms": 26431 }}