YouTube profile (v1)

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 is slower.

Shorts and long-form video are returned from the same channel endpoint and are labelled by content type rather than by duration.

Authorization

ApiKeyAuth

X-API-Key<token>

Your API key. Sent on every request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

type*string

'video' or 'shorts'

channel_id?string

Creator's channel ID starting with UC

count?integer

Number of posts to fetch

Default30

cursor?string

Cursor for pagination

Default"0"

include_comment_count?boolean

Fetch the comment_count NUMBER (both 'video' and 'shorts'). This is NOT the same as 'include_comments' (which fetches actual comment bodies on the single/details endpoints), this only populates the comment_count metric. Default True → comment_count is fetched. It is the most expensive field (~120 KB /next per item, run DIRECT/off-request routing so it never bills the residential request routing) and the only best-effort one (it can be null under heavy load since it runs off the rotating request routing). Set False to skip it for max speed/reliability, view_count (exact), upload_timestamp (precise) and like_count (exact) are always returned regardless, all from cheap direct calls.

Defaulttrue

include_like_comment_count?boolean

Legacy alias for include_comment_count (like_count is already on by default).

Defaultfalse

username?string

Creator's username/handle without @

Response Body

`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  }}

Authorization

Request Body

Response Body

200application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`