> ## Documentation Index > Fetch the complete documentation index at: https://docs.scraperize.com/llms.txt > Use this file to discover all available pages before exploring further. # Channel community posts > Fetches a YouTube channel's community posts (its Posts tab), about 10 per page, newest first. Each post has its id, URL, `type` (`text`, `image`, `video`, `playlist`, `poll`, `quiz` or `shared`), author, text with its links and hashtags, when it was posted and whether it was edited, likes (exact for the channel's own posts) and comments, plus what it carries: its images, the video or playlist it links, a poll's choices and vote total, a quiz's choices with the correct answer and explanations, or the original post it shares. The response also carries a summary of the channel (id, handle, name, avatar, verified, subscribers). Pass exactly one of `channelId` or `handle`; pass the returned `cursor` back (with the same channel) for the next page. A channel without a Posts tab returns no posts. Only publicly available data is returned. > [!NOTE] > > **Cost: 1 credit** per successful request. Errors and cache hits (`cache_max_age`) are free. > [accordion] Copy for AI assistant > > Paste this into ChatGPT, Claude or your coding assistant to generate working code for this endpoint (use the copy button). > > ```text Prompt > I want to make an API call to /v1/youtube/channel/community-posts. Here are the details: > > Endpoint: GET https://api.scraperize.com/v1/youtube/channel/community-posts > Description: Fetches a YouTube channel's community posts (its Posts tab), about 10 per page, newest first. Each post has its id, URL, `type` (`text`, `image`, `video`, `playlist`, `poll`, `quiz` or `shared`), author, text with its links and hashtags, when it was posted and whether it was edited, likes (exact for the channel's own posts) and comments, plus what it carries: its images, the video or playlist it links, a poll's choices and vote total, a quiz's choices with the correct answer and explanations, or the original post it shares. The response also carries a summary of the channel (id, handle, name, avatar, verified, subscribers). Pass exactly one of `channelId` or `handle`; pass the returned `cursor` back (with the same channel) for the next page. A channel without a Posts tab returns no posts. Only publicly available data is returned. > > Required Headers: > - x-api-key: Your API key > > Parameters: > - channelId (string): The channel id: `UC` followed by 22 characters, e.g. `UCBJycsmduvYEL83R_U4JriQ`. > - handle (string): The channel handle, with or without `@`, e.g. `mkbhd`. > - cursor (string): The `cursor` from the previous page, to get the next one. Omit for the first page. > - cache_max_age (select): Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. > > Example Response: > { > "data": { > "channel": { > "id": "UCBJycsmduvYEL83R_U4JriQ", > "handle": "mkbhd", > "name": "Marques Brownlee", > "url": "https://www.youtube.com/@mkbhd", > "avatarUrl": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c0x00ffffff-no-rj", > "isVerified": true, > "subscriberCount": 21400000 > }, > "posts": [ > { > "id": "UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", > "url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ", > "type": "image", > "author": { > "id": "UCBJycsmduvYEL83R_U4JriQ", > "name": "Marques Brownlee", > "handle": "mkbhd", > "url": "https://www.youtube.com/@mkbhd", > "avatarUrl": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s76-c-k-c0x00ffffff-no-rj-mo" > }, > "text": "Alright, it's that time: https://vote.mkbhd.com\n\nWelcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3 categories. Scientific winners revealed (I'…", > "links": [ > { > "text": "https://vote.mkbhd.com", > "url": "https://vote.mkbhd.com/" > } > ], > "hashtags": [], > "publishedText": "2 years ago", > "isEdited": true, > "likeCount": 12056, > "likeCountText": "12K", > "commentCount": 1000, > "commentCountText": "1K", > "images": [ > { > "url": "https://yt3.ggpht.com/zy6PEg0QzlzFe8xfDxpAbe1mGV0pXgc-xV1MvQ7rlf_EWjEj_YqN0Y2b7fiaOCdghICsMxy8tDGDaA=s1186-c-fcrop64=1,1bdd0000e422ffff-rw-nd-v1", > "width": 1186, > "height": 1186 > } > ], > "video": null, > "playlist": null, > "poll": null, > "quiz": null, > "sharedPost": null > } > ], > "count": 8, > "cursor": "eyJrIjoiQG1rYmhkIiwiYyI6IjRxbUZzZ0tCQVJJWVZVTkNTbmxqYzIxa2RYWlpSVXc0TTFKZlZUUktjbWxSR2t4RloxWjNZak5PTUdNMmIwUkxRVzlyVlZSS2FrNVdTa2RWYTFaWVlrZFNiMVp0TlVObFZsWnhV…", > "hasMore": true, > "fetchedAt": "2026-11-05T07:29:43.090Z" > }, > "meta": { > "requestId": "req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f", > "creditsCharged": 1, > "creditsRemaining": 4999, > "cached": false > } > } > > Please help me write code in my preferred programming language to make this API call and handle the response appropriately. Include error handling and best practices. > ``` ## OpenAPI ````yaml /api-reference/openapi.json get /v1/youtube/channel/community-posts openapi: 3.0.3 info: title: Scraperize API version: 1.0.0 description: >- Extract public data from social media platforms as clean JSON. Endpoints are split by platform and by what they return, e.g. `GET /v1/twitter/tweet`. ## Authentication Send your API key in the `x-api-key` header (or `Authorization: Bearer `). Create keys in your dashboard. ## Credits Each successful live scrape costs **1 credit**. Credits are prepaid and never expire. ## Caching Every endpoint accepts an optional `cache_max_age` (`1d`|`3d`|`7d`|`14d`|`30d`). A cache hit within that window is returned for **0 credits**. ## Responses Success returns `{ "data": …, "meta": { "requestId", … } }`. Errors return `{ "error": { "code", "message", "requestId" } }` with a matching HTTP status. `meta` on a scrape carries `creditsCharged`, `creditsRemaining`, `cached`, and (on a hit) `cachedAt`. ## Rate limits Requests are limited per team per minute; over the limit returns `429` with a `Retry-After` header. servers: - url: https://api.scraperize.com description: Production security: - ApiKeyAuth: [] tags: - name: Twitter description: Twitter / X scraping endpoints - name: Facebook description: Facebook scraping endpoints - name: Linkme description: Linkme (link.me) scraping endpoints - name: Amazon description: Amazon (creator shop / storefront) scraping endpoints - name: Linkbio description: Linkbio (lnk.bio) scraping endpoints - name: Pillar description: Pillar (pillar.io) scraping endpoints - name: Komi description: Komi (komi.io) scraping endpoints - name: Linktree description: Linktree (linktr.ee) scraping endpoints - name: Kick description: Kick (kick.com) scraping endpoints - name: Snapchat description: Snapchat (snapchat.com) scraping endpoints - name: Telegram description: Telegram (t.me) scraping endpoints - name: LinkedIn description: LinkedIn scraping endpoints - name: Twitch description: Twitch scraping endpoints - name: TikTok description: TikTok (tiktok.com) scraping endpoints - name: Instagram description: Instagram scraping endpoints - name: Lagos Life description: Lagos Life scraping endpoints - name: Bluesky description: Bluesky (bsky.app) scraping endpoints - name: Threads description: Threads (threads.com) scraping endpoints - name: Reddit description: Reddit (reddit.com) scraping endpoints - name: Rumble description: Rumble (rumble.com) scraping endpoints - name: Truth Social description: Truth Social (truthsocial.com) scraping endpoints - name: YouTube description: YouTube (youtube.com) scraping endpoints paths: /v1/youtube/channel/community-posts: get: tags: - YouTube summary: Channel community posts description: >- Fetches a YouTube channel's community posts (its Posts tab), about 10 per page, newest first. Each post has its id, URL, `type` (`text`, `image`, `video`, `playlist`, `poll`, `quiz` or `shared`), author, text with its links and hashtags, when it was posted and whether it was edited, likes (exact for the channel's own posts) and comments, plus what it carries: its images, the video or playlist it links, a poll's choices and vote total, a quiz's choices with the correct answer and explanations, or the original post it shares. The response also carries a summary of the channel (id, handle, name, avatar, verified, subscribers). Pass exactly one of `channelId` or `handle`; pass the returned `cursor` back (with the same channel) for the next page. A channel without a Posts tab returns no posts. Only publicly available data is returned. parameters: - name: channelId in: query required: false description: >- The channel id: `UC` followed by 22 characters, e.g. `UCBJycsmduvYEL83R_U4JriQ`. schema: type: string example: UCBJycsmduvYEL83R_U4JriQ - name: handle in: query required: false description: The channel handle, with or without `@`, e.g. `mkbhd`. schema: type: string example: mkbhd - name: cursor in: query required: false description: >- The `cursor` from the previous page, to get the next one. Omit for the first page. schema: type: string - name: cache_max_age in: query required: false description: >- Optional. Return a cached result if one this age or newer exists — served for **0 credits** with `meta.cached=true` and `meta.cachedAt`. Otherwise a fresh scrape runs (**1 credit**) and refreshes the cache. Omit to always scrape fresh. schema: type: string enum: - 1d - 3d - 7d - 14d - 30d example: 7d responses: '200': description: One page of the channel's community posts (empty when it has none). content: application/json: schema: type: object properties: data: type: object properties: channel: type: object posts: type: array items: type: object count: type: integer cursor: type: string nullable: true hasMore: type: boolean fetchedAt: type: string format: date-time meta: type: object description: >- requestId + credit/caching metadata (creditsCharged, creditsRemaining, cached, cachedAt). required: - data - meta example: data: channel: id: UCBJycsmduvYEL83R_U4JriQ handle: mkbhd name: Marques Brownlee url: https://www.youtube.com/@mkbhd avatarUrl: >- https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c0x00ffffff-no-rj isVerified: true subscriberCount: 21400000 posts: - id: UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ url: >- https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ type: image author: id: UCBJycsmduvYEL83R_U4JriQ name: Marques Brownlee handle: mkbhd url: https://www.youtube.com/@mkbhd avatarUrl: >- https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s76-c-k-c0x00ffffff-no-rj-mo text: >- Alright, it's that time: https://vote.mkbhd.com Welcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3 categories. Scientific winners revealed (I'll collect and reveal all the most interesting data soon. Your winners may surprise you!) links: - text: https://vote.mkbhd.com url: https://vote.mkbhd.com/ hashtags: [] publishedText: 2 years ago isEdited: true likeCount: 12056 likeCountText: 12K commentCount: 1000 commentCountText: 1K images: - url: >- https://yt3.ggpht.com/zy6PEg0QzlzFe8xfDxpAbe1mGV0pXgc-xV1MvQ7rlf_EWjEj_YqN0Y2b7fiaOCdghICsMxy8tDGDaA=s1186-c-fcrop64=1,1bdd0000e422ffff-rw-nd-v1 width: 1186 height: 1186 video: null playlist: null poll: null quiz: null sharedPost: null - id: Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok url: >- https://www.youtube.com/post/Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok type: image author: id: UCBJycsmduvYEL83R_U4JriQ name: Marques Brownlee handle: mkbhd url: https://www.youtube.com/@mkbhd avatarUrl: >- https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s76-c-k-c0x00ffffff-no-rj-mo text: >- Introducing a new colorway and updated design: 251.1. Now in matte black. (Plus a new water repellent ripstop mesh and a little touch of silver reflective detail for the winter) https://atoms.com/products/mkbhd251-1 links: - text: https://atoms.com/products/mkbhd251-1 url: https://atoms.com/products/mkbhd251-1 hashtags: [] publishedText: 2 years ago isEdited: false likeCount: 31614 likeCountText: 31K commentCount: 1300 commentCountText: 1.3K images: - url: >- https://yt3.ggpht.com/DRQFUxLpjmjn-SYaIqWGtXLcx-pD78rqnmhk-yhQEaOSMbQObQMQqkTao0PBQk624sCrRVXZN_29=s5464-c-fcrop64=1,000024ddfffff1a9-rw-nd-v1 width: 5464 height: 5464 - url: >- https://yt3.ggpht.com/TojFATEOvYO3-sFbqEAv7Q4aijzby4KMxTWomslL5KLrEud-TBqJkvIEvEbdH50saRwEBaUnziF1Fg=s5464-c-fcrop64=1,0000199affffe666-rw-nd-v1 width: 5464 height: 5464 - url: >- https://yt3.ggpht.com/pv4bCRUU3-M64oR_veBsGO0daiVq13PSBsm83ZbxHyPQdPEsMOTDV5BkiVjV20NI5oFIRuzZtRumeg=s5291-c-fcrop64=1,0000199affffe665-rw-nd-v1 width: 5291 height: 5291 video: null playlist: null poll: null quiz: null sharedPost: null - id: UgkxZN2SvrU_okjdMCuAS8EULb_QIZ030jIy url: >- https://www.youtube.com/post/UgkxZN2SvrU_okjdMCuAS8EULb_QIZ030jIy type: image author: id: UCBJycsmduvYEL83R_U4JriQ name: Marques Brownlee handle: mkbhd url: https://www.youtube.com/@mkbhd avatarUrl: >- https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s76-c-k-c0x00ffffff-no-rj-mo text: >- Greatest day of my life?! My collab with Elmo and the @SesameStreet crew is up 🥺 https://youtu.be/I85gpjErUVw?t=799 links: - text: '@SesameStreet' url: >- https://www.youtube.com/channel/UCoookXUzPciGrEZEXmh4Jjg - text: https://youtu.be/I85gpjErUVw?t=799 url: https://www.youtube.com/watch?v=I85gpjErUVw&t=799s hashtags: [] publishedText: 3 years ago isEdited: false likeCount: 74147 likeCountText: 74K commentCount: 1600 commentCountText: 1.6K images: - url: >- https://yt3.ggpht.com/CpA5yZ_aaXN-qmu-73bQoSmy_IGBTcRQXKar6dXQFLEYFQJRtpWpvM_gim8vLjOUZR_lXdbGNkr5yg=s1080-c-fcrop64=1,00000000ffffffff-rw-nd-v1 width: 1080 height: 1080 video: null playlist: null poll: null quiz: null sharedPost: null count: 8 cursor: >- eyJrIjoiQG1rYmhkIiwiYyI6IjRxbUZzZ0tCQVJJWVZVTkNTbmxqYzIxa2RYWlpSVXc0TTFKZlZUUktjbWxSR2t4RloxWjNZak5PTUdNMmIwUkxRVzlyVlZSS2FrNVdTa2RWYTFaWVlrZFNiMVp0TlVObFZsWnhVV3hrVkdKVldqQlZiVFYzWVVkR2NsSnNTbEpXVlZVNVMwRnFlVUpuVVV0QmEyOUJtZ0lXWW1GamEzTjBZV2RsTFdsMFpXMHRjMlZqZEdsdmJnJTNEJTNEIiwiY2giOnsiaWQiOiJVQ0JKeWNzbWR1dllFTDgzUl9VNEpyaVEiLCJoYW5kbGUiOiJta2JoZCIsIm5hbWUiOiJNYXJxdWVzIEJyb3dubGVlIiwidXJsIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vQG1rYmhkIiwiYXZhdGFyVXJsIjoiaHR0cHM6Ly95dDMuZ29vZ2xldXNlcmNvbnRlbnQuY29tL3F1NFRtSWFZVWxTNDEtZEo5Z1o3RFVSM25pbHZtQjVfMTFpNk9LU2R2Tm5CTml5T3VzWlAxYk1ONklDbnV4dGpGQmI2aW9LZ1JRPXM5MDAtYy1rLWMweDAwZmZmZmZmLW5vLXJqIiwiaXNWZXJpZmllZCI6dHJ1ZSwic3Vic2NyaWJlckNvdW50IjoyMTQwMDAwMH19 hasMore: true fetchedAt: '2026-11-05T07:29:43.090Z' meta: requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f creditsCharged: 1 creditsRemaining: 4999 cached: false '400': description: Invalid or expired cursor (or one for another channel). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: The request was invalid. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '401': description: Missing, invalid, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: API key required — pass it in the `x-api-key` header. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '402': description: Not enough credits for this request. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INSUFFICIENT_CREDITS message: >- This request costs 1 credit, but your balance is 0. Top up to continue. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '404': description: No YouTube channel found (it may not exist or have been removed). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: >- The requested content was not found (it may not exist, be deleted, or be private). requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '422': description: Invalid query parameters (pass exactly one of channelId or handle). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: VALIDATION_ERROR message: Request validation failed requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: - path: url message: url is required '429': description: Over the per-minute rate limit — honour `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — max 100 requests per 60s. Retry in ~30s. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f '503': description: >- Temporarily unavailable — retry after `Retry-After`. `error.code` tells you why: `UPSTREAM_BLOCKED` (the source blocked this request), `EXTRACTION_FAILED` (the source returned unexpected data), `PLATFORM_UNAVAILABLE` (the source is down), or `SERVICE_UNAVAILABLE` (we are at capacity). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UPSTREAM_BLOCKED message: >- The source is temporarily unavailable. Please try again shortly. requestId: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f components: schemas: Error: type: object properties: error: type: object properties: code: type: string example: NOT_FOUND message: type: string example: The requested content was not found. requestId: type: string example: req_8f0c2b7e-1a2b-4c3d-9e8f-0a1b2c3d4e5f details: type: array items: type: object description: Present on validation errors. required: - code - message - requestId required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your API key. Send it in the `x-api-key` header (or `Authorization: Bearer `). Create and manage keys from your dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.