Skip to content
truescrape
Free key

Contents

Site

YouTube Channel Community Posts API

Open in ChatGPTOpen in ClaudeOpen in Gemini

A channel's Posts tab (what YouTube used to call Community). Images, multi-image carousels, shared videos and polls all come back as posts; poll options are under raw. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/youtube/channel/community-posts
ParameterTypeRequiredDescription
handlestringyesHandle (@mrbeast), channel id (UC…), or full URL
cursorstringnopagination.cursor from a previous response

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl
curl "$API/v1/youtube/channel/community-posts?handle=%40MrBeast&cache_max_age=7d" \
  -H "x-api-key: $KEY"
JavaScript
const query = new URLSearchParams({
  handle: '@MrBeast',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/youtube/channel/community-posts?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);
Python
import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/youtube/channel/community-posts",
    params={
        "handle": "@MrBeast",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on , with raw removed and lists cut to two items. A live call returns current data.

response
{
  "success": true,
  "data": {
    "items": [
      {
        "platform": "youtube",
        "id": "Ugkx2lkCYp85jak0n5z7-bq_4ug2Rntk9iWT",
        "type": "image",
        "url": "https://www.youtube.com/post/Ugkx2lkCYp85jak0n5z7-bq_4ug2Rntk9iWT",
        "title": null,
        "text": "These last two videos are the best content we’ve ever made and somehow our next 3 uploads are even better. (The team is cooking) I’m feeling more excited and energized about our videos than ever before, new era of Beast coming up 🥰",
        "authorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "authorHandle": "MrBeast",
        "authorName": "MrBeast",
        "thumbnailUrl": "https://yt3.ggpht.com/9davaq2roo2vRpZ80IIGBiCAy6CmeYfm17AkJbLofKYVreyWRk9Y3SF2tcHwTpdGSzRXym9Y_6096A=s988-c-fcrop64=1,00c60000ff39ffff-rw-nd-v1",
        "mediaUrls": [
          "https://yt3.ggpht.com/9davaq2roo2vRpZ80IIGBiCAy6CmeYfm17AkJbLofKYVreyWRk9Y3SF2tcHwTpdGSzRXym9Y_6096A=s988-c-fcrop64=1,00c60000ff39ffff-rw-nd-v1"
        ],
        "durationSeconds": null,
        "viewCount": null,
        "likeCount": 106452,
        "commentCount": 2900,
        "shareCount": null,
        "hashtags": [],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:55:25.126Z"
      },
      {
        "platform": "youtube",
        "id": "UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
        "type": "image",
        "url": "https://www.youtube.com/post/UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
        "title": null,
        "text": "NO MORE WAITING, this Saturday “Eat Everything In A Grocery Store Win $1,000,000” finally goes live! You’ll get to see if Juan and the gang pulled it off :D",
        "authorId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "authorHandle": "MrBeast",
        "authorName": "MrBeast",
        "thumbnailUrl": "https://yt3.ggpht.com/-gQueci3cQXl50-Tgiv_Ru65aUfw2-6aHe9ny2Iy1KWoU1iAALkCZ9VeiZkH5tcqqiAjaTjb50D7iQ=s1320-c-fcrop64=1,35f50000ca0affff-rw-nd-v1",
        "mediaUrls": [
          "https://yt3.ggpht.com/-gQueci3cQXl50-Tgiv_Ru65aUfw2-6aHe9ny2Iy1KWoU1iAALkCZ9VeiZkH5tcqqiAjaTjb50D7iQ=s1320-c-fcrop64=1,35f50000ca0affff-rw-nd-v1"
        ],
        "durationSeconds": null,
        "viewCount": null,
        "likeCount": 316675,
        "commentCount": 7200,
        "shareCount": null,
        "hashtags": [],
        "mentions": [],
        "isSponsored": null,
        "publishedAt": null,
        "fetchedAt": "2026-10-21T01:55:25.126Z"
      }
    ]
  },
  "pagination": {
    "cursor": "eyJ0IjoiNHFtRnNnS1RBUklZVlVOWU5rOVJNMFJyWTNOaVdVNUZOa2c0ZFZGUmRWWkJHbDVGWjFaM1lqTk9NR00zWjBKQlNrbEVRVXR2UkV0QmIydFZWRXB2VVRGS1IxWnJWbFJpUjJoUFZXcEdTMUl4Vm5GUmJHUlVZbFZhZVZac1VrOVdWa3B5VjJ0V1UxWlZXa05MUVhKNVFtZHJTMEl3YjBGdlowVkRRMEZGSlRORW1nSVdZbUZqYTNOMFlXZGxMV2wwWlcwdGMyVmpkR2x2YmclM0QlM0QiLCJ2IjoiQ2d0YU1rMXVVell4VkZBNE1DaU10LURXQmpJS0NnSkVSUklFRWdBZ1UyS3lBZ3F2QWtOMVFVSkRRVlZUYTJkRlFqaFJXblZhYlROWGVVVnllSEJpY25kRVIwTlNVa1JHZVZSdk1HOXlPVTVuTkY5T1lXbEVkVWN5TnpOR2RqTmZWbGxoU1dWQ0xXMHRXVFptWW1wa1FqY3pkVlZmTTJsMVMyNU9iVzFpUmpaaVZEYzFkR2hoYm01RFdIbE1YekZEUTAxUmRuQkpTM2hFY0RsRVRHRnpZVWxEVmsxSFZsUlhRVTU0V1dWMVp6WlFaVEZUWW1WTVVtSnRSbTh0WmxCS1VWVldlVlJ2WTNKelgzZDJVMjlVVUVOVlFsSldSV1I0UWxkRE4yRjRNMWRoVTJOQk0xTlJRMUU0VDFVemJEQkZNR0Y1WjBaTmExVkNNM0Z0WkZSZk1YaDBVMFYxZEhwb1FrRmtiVXRRYzJWTFptbzVSR0Y1VjE4M2RqTnNSekV3UTBGaGJWWnNZbHA2VFUxNlJtWTJZMXB4ZDNoc1RHOU5VVWxKVURkaGIwbElTalZRZHpneVJWbHVSSGgzY0hKQlFUSlJVUSUzRCUzRCJ9",
    "hasMore": true,
    "count": 10
  },
  "meta": {
    "platform": "youtube",
    "endpoint": "youtube.channelCommunityPosts",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 245,
    "requestId": "req_zp8xitepgtdwgpbimtw1"
  }
}

Returns

Returns a list of Post in data.items.

Cost and behaviour

Credits1 per live request, 0 on a cache hit
Cacheableyes: cache_max_age accepts a cached copy
Batchableyes: usable as a target in POST /v1/jobs/batch
Subscribableyes: as often as every 3600 seconds, firing a webhook only on a change

Other YouTube endpoints

All YouTube endpointsThe unified schema