# YouTube Channel Videos API. Videos, shorts and live streams, page by page. Videos, shorts and live streams of a channel. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dyoutube.posts) ## YouTube Channel Videos API at a glance Returns a public YouTube channel's videos, shorts or live streams a page at a time, newest, oldest or most popular first. Each upload has its link, title, thumbnail, length, views and upload time, and the newest also have exact times, view and like counts and descriptions. Accepts a handle, any channel link or a channel ID. GET `/v1/youtube/posts` [Read the API reference](https://socialtap.dev/docs/reference/youtube/posts/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **22 typed fields** null when unknown - **48** videos, shorts and live streams per page, newest first - **`handle`** is all it needs, e.g. `@MrBeast` ## Send one request. Get up to 48 videos, shorts and live streams back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = @MrBeast` [Open in playground](https://socialtap.dev/playground/?endpoint=youtube.posts) cURL: ```shell curl -G 'https://socialtap.dev/v1/youtube/posts' \ --data-urlencode 'handle=@jawed' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.youtube.posts.list({ handle: "@jawed" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "@jawed", }); const res = await fetch(`https://socialtap.dev/v1/youtube/posts?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/youtube/posts", params={"handle": "@jawed"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "@jawed") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/youtube/posts?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "author": { "avatar_url": "https://yt3.googleusercontent.com/uI3VE4PVqvCy0xnWLqMJnEzyBUm3T8VHOCp4ee-1RxdHqKXCdUE_qXYQnpf9AfuEoIPactVyDhM=s900-c-k-c0x00ffffff-no-rj", "display_name": "jawed", "id": "UC4QobU6STFB0P71PMvOGN5A", "is_verified": null, "url": "https://www.youtube.com/channel/UC4QobU6STFB0P71PMvOGN5A", "username": "jawed" }, "coauthors": [], "duration_ms": 19000, "hashtags": [], "id": "jNQXAC9IVRw", "is_nsfw": null, "is_pinned": null, "is_sponsored": null, "language": null, "media": [ { "alt_text": null, "duration_ms": 19000, "expires_at": null, "height": 360, "thumbnail_url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg", "type": "video", "url": null, "width": 480 } ], "mentions": [], "metrics": { "comment_count": null, "like_count": 20117813, "quote_count": null, "repost_count": null, "save_count": null, "share_count": null, "view_count": 446865949 }, "platform": "youtube", "platform_specific": { "youtube": { "author_subscriber_count": null, "category": null, "chapters": [], "description_links": [ "https://www.youtube.com/watch?v=0PT5c1z3LL8", "https://www.youtube.com/watch?v=RRBN_4L09Mg" ], "is_age_restricted": null, "is_live_now": null, "is_paywalled": null, "is_unlisted": null, "keywords": [], "live_ended_at": null, "live_started_at": null, "scheduled_start_at": null } }, "platform_type": "video", "published_at": "2005-04-24T03:31:52Z", "text": "Microplastics are accumulating in human brains at an alarming rate\nhttps://www.youtube.com/watch?v=0PT5c1z3LL8\n\n“Nanoplastics and Human Health” with Matthew J Campen, PhD, MSPH\nhttps://www.youtube.com/watch?v=RRBN_4L09Mg\n\n00:00 Intro\n00:05 The cool thing\n00:17 End", "thumbnail_url": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg", "title": "Me at the zoo", "type": "video", "unknown_fields": [ "coauthors", "platform_specific.youtube.keywords", "platform_specific.youtube.chapters" ], "url": "https://www.youtube.com/watch?v=jNQXAC9IVRw" } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "end" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "youtube", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 442, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "UC4QobU6STFB0P71PMvOGN5A", "url": "https://www.youtube.com/@jawed" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` ## One schema on 21 platforms. The [response reference](https://socialtap.dev/docs/reference/youtube/posts/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/post/index.md). - ### Null means unknown A field YouTube doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts YouTube channel: a handle with or without the @, any channel link (@handle, /channel/UC…, legacy /c/, /user/ and root vanity links, any tab, m. and music. hosts), a bare UC… channel ID, or c/\, user/\, vanity/\. - ### Write one parser YouTube, TikTok, Instagram and 18 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native post ID (string; Instagram shortcode, Reddit with its t3_ prefix). - **`url`string**: Canonical post URL. - **`type`string**: Normalized content shape. New values may be added; treat unknown values as other. - **`platform_type`string**: The platform's own product label, lowercase (reel, short, story, live, tweet, …). - **`title`string**: Headline (YouTube title, Reddit title); null on caption-only platforms. - **`text`string**: Caption, description or body as plain text. - **`language`string**: BCP-47 language of text, when the platform states it. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the YouTube Channel Videos API. - ### Monitor a channel for new uploads - ### Export a creator's full video catalog - ### Find a channel's most viewed videos or shorts - ### Follow channels' upcoming streams and premieres ## Good to know before you build. - Each tab's newest uploads (up to 15) are exact, from YouTube's uploads feed. Beyond them published_at comes from a relative label (the day of the latest time it allows, at midnight UTC; the hour for a label in hours) and views are rounded, both in approximate_fields, text and metrics.like_count are null, and a non-English title may be YouTube's English translation. - When the uploads feed does not answer, the newest uploads are read like the rest and a partial_data warning names the fields left null. - Shorts beyond the newest have no published_at or duration_ms, so since and until are refused with tab=shorts. Streams live now or scheduled have no view count. - A channel without the tab returns an empty page. A tab in a pasted link is ignored, so set tab. - The live tab lists upcoming and live streams first, then past streams by when they streamed. With tab=live, since and until filter the streams instead of ending the walk, so it reads further. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/youtube/posts/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Any source | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the YouTube Channel Videos API. More in the [API reference](https://socialtap.dev/docs/reference/youtube/posts/index.md). **How much does the YouTube Channel Videos API cost?** A page of up to 48 videos, shorts and live streams costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 1 hour. Other platforms ## Posts on 20 more platforms. - [TikTok Posts API](https://socialtap.dev/apis/tiktok/posts/index.md) (1 credit / page · `GET /v1/tiktok/posts`) - [Instagram Posts API](https://socialtap.dev/apis/instagram/posts/index.md) (1 credit / page · `GET /v1/instagram/posts`) - [Facebook Profile Posts API](https://socialtap.dev/apis/facebook/posts/index.md) (1 credit / page · `GET /v1/facebook/posts`) - [Reddit User Posts API](https://socialtap.dev/apis/reddit/posts/index.md) (1 credit / page · `GET /v1/reddit/posts`) - [Threads Posts API](https://socialtap.dev/apis/threads/posts/index.md) (1 credit / page · `GET /v1/threads/posts`) - [Spotify Track API](https://socialtap.dev/apis/spotify/track/index.md) (1 credit · `GET /v1/spotify/track`) - [Amazon Shop Posts API](https://socialtap.dev/apis/amazon/shop_posts/index.md) (1 credit / page · `GET /v1/amazon/shop_posts`) - [Apple Music Track API](https://socialtap.dev/apis/applemusic/track/index.md) (1 credit · `GET /v1/applemusic/track`) - [Pinterest Pin API](https://socialtap.dev/apis/pinterest/pin/index.md) (1 credit · `GET /v1/pinterest/pin`) - [Rumble Channel Videos API](https://socialtap.dev/apis/rumble/posts/index.md) (1 credit / page · `GET /v1/rumble/posts`) - [X (Twitter) Post API](https://socialtap.dev/apis/x/post/index.md) (1 credit · `GET /v1/x/post`) - [Bluesky User Posts API](https://socialtap.dev/apis/bluesky/posts/index.md) (1 credit / page · `GET /v1/bluesky/posts`) - [Twitch Video and Clip API](https://socialtap.dev/apis/twitch/video/index.md) (1 credit · `GET /v1/twitch/video`) - [LinkedIn Post API](https://socialtap.dev/apis/linkedin/post/index.md) (1 credit · `GET /v1/linkedin/post`) - [Telegram Post API](https://socialtap.dev/apis/telegram/post/index.md) (1 credit · `GET /v1/telegram/post`) - [Kwai User Posts API](https://socialtap.dev/apis/kwai/posts/index.md) (1 credit / page · `GET /v1/kwai/posts`) - [Snapchat Spotlight API](https://socialtap.dev/apis/snapchat/spotlight/index.md) (1 credit · `GET /v1/snapchat/spotlight`) - [SoundCloud Track API](https://socialtap.dev/apis/soundcloud/track/index.md) (1 credit · `GET /v1/soundcloud/track`) - [Truth Social Posts API](https://socialtap.dev/apis/truthsocial/posts/index.md) (1 credit / page · `GET /v1/truthsocial/posts`) - [Kick Clip API](https://socialtap.dev/apis/kick/post/index.md) (1 credit · `GET /v1/kick/post`) More YouTube ## YouTube API. 6 endpoints, one key. - [YouTube Video API](https://socialtap.dev/apis/youtube/post/index.md) (1 credit · `GET /v1/youtube/post`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [YouTube Comments API](https://socialtap.dev/apis/youtube/comments/index.md) (1 credit / page · `GET /v1/youtube/comments`) - [YouTube Transcript API](https://socialtap.dev/apis/youtube/transcript/index.md) (From 1 credit · `GET /v1/youtube/transcript`) - [YouTube Engagement API](https://socialtap.dev/apis/youtube/engagement/index.md) (1 credit · `GET /v1/youtube/engagement`) ## Try it on an account you know. Paste its handle or link in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/youtube/posts/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)