youtube.com APIwww.youtube.com ↗
Retrieve video URLs, titles, view counts, and publish dates from any YouTube channel. Supports sorting by latest, popular, or oldest with automatic pagination.
curl -X GET 'https://api.parse.bot/scraper/17f80f00-16b9-481b-8d14-fa845ca3f046/get_channel_videos' \ -H 'X-API-Key: $PARSE_API_KEY'
Get all videos from a YouTube channel's videos page. Returns video URLs (youtube.com/watch?v=...), titles, view counts, and publish dates. Supports sorting by latest, popular, or oldest, and pagination via a configurable limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of videos to return. The scraper paginates automatically to fulfill the limit. |
| sort_by | string | Sort order for videos. Accepts exactly one of: latest, popular, oldest. |
| channel_handlerequired | string | YouTube channel handle, with or without the leading '@' (e.g. '@SuccessionBio' or 'SuccessionBio'). |
{
"type": "object",
"fields": {
"videos": "array of video objects with video_id, title, url, views, published",
"video_count": "integer",
"channel_handle": "string"
},
"sample": {
"videos": [
{
"url": "https://www.youtube.com/watch?v=WDx-dJ-oznI",
"title": "The Alien Intern: Why Managing AI Agents Is the Career Skill of the Decade | SalesDNA Podcast",
"views": "19 views",
"video_id": "WDx-dJ-oznI",
"published": "8 days ago"
},
{
"url": "https://www.youtube.com/watch?v=QmWjcCLEUlw",
"title": "Have an Omnipresent, Helpful Opinion | SalesDNA Podcast",
"views": "38 views",
"video_id": "QmWjcCLEUlw",
"published": "3 weeks ago"
}
],
"video_count": 10,
"channel_handle": "@SuccessionBio"
}
}About the youtube.com API
The YouTube Channel Videos API exposes 5 data fields per video — video_id, title, url, views, and published — from any public YouTube channel via the single get_channel_videos endpoint. Pass a channel handle with or without the leading '@', choose a sort order, and set a limit to retrieve exactly the slice of a channel's video catalog you need.
What get_channel_videos Returns
The get_channel_videos endpoint accepts a channel_handle (e.g. SuccessionBio or @SuccessionBio) and returns an array of video objects alongside a video_count integer and the normalized channel_handle. Each video object includes video_id, title, url (in youtube.com/watch?v=... format), views, and published date. There is one endpoint in this API.
Sorting and Pagination
The sort_by parameter accepts exactly three values: latest, popular, or oldest. This maps directly to the sort options available on a YouTube channel's videos tab. The optional limit integer controls how many video objects are returned; the API paginates automatically to fulfill larger limits, so you do not need to manage page tokens or cursors yourself.
Coverage and Scope
The API works against any public YouTube channel identifiable by a handle. It returns only the data visible on the channel's videos listing: title, URL, view count, and publish date. Data from private or members-only videos is not accessible. Fields like subscriber counts, channel descriptions, video thumbnails, like counts, or comment data are not part of the current response shape.
- Build a video catalog index for a brand or creator by pulling all published video URLs and titles sorted by publish date.
- Track view count changes over time for a channel by periodically fetching videos sorted by
popularand storing theviewsfield. - Populate a content aggregation dashboard with the latest uploads from multiple YouTube channels using the
latestsort order. - Identify the oldest content on a channel using the
oldestsort to audit or archive historical video archives. - Feed a recommendation engine with channel video metadata including
publisheddates to weight recency in scoring. - Monitor a competitor's content cadence by checking new
video_countvalues and recentpublishedtimestamps on a schedule.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does YouTube have an official developer API?+
What does the `published` field contain — a timestamp, a relative label, or an ISO date?+
published field reflects the date information shown on the YouTube channel videos listing. This is typically a human-readable date or relative label (e.g. '3 days ago') as it appears on that page, not a guaranteed ISO 8601 timestamp. If your application requires precise publication times, plan to normalize this field after retrieval.Does the API return video thumbnails, like counts, or subscriber counts?+
Can I retrieve videos from a specific playlist rather than the main videos tab?+
How does pagination work when requesting a large number of videos?+
limit parameter to the number of videos you want. The API handles multi-page retrieval automatically and returns up to that many results. You do not need to pass any cursor or page token — the limit is the only control needed.