Channel Posts
GET/v1/youtube/channel/community-posts1 credit
Returns the community posts on a channel's Posts tab: text, images, attached video, like count and publish time.
01Query parameters
| Name | Type | Description |
|---|---|---|
| handleoptional | string | Channel handle, with or without the leading `@` (e.g. `MrBeast`). One of `handle` or `channelId` is required, unless you send a `continuationToken`. |
| channelIdoptional | string | Channel id starting with `UC` (e.g. `UCX6OQ3DkcsbYNE6H8uQQuVA`). One of `handle` or `channelId` is required, unless you send a `continuationToken`. |
| continuationTokenoptional | string | The `continuationToken` from the previous page. It can be sent on its own, without the channel. |
| regionoptional | string | Two-letter country code that sets the YouTube region for the request (e.g. `US`, `GB`).Default: US |
02Request
curl "https://api.scrapesocial.ai/v1/youtube/channel/community-posts?handle=MrBeast" \ -H "x-api-key: $SCRAPESOCIAL_KEY"
03Responses
Real answers from the API. Lists are shortened to 2 items.
GET /v1/youtube/channel/community-posts?handle=MrBeast
{
"success": true,
"credits_remaining": 4980,
"credits_charged": 1,
"posts": [
{
"id": "Ugkx2lkCYp85jak0n5z7-bq_4ug2Rntk9iWT",
"url": "https://www.youtube.com/post/Ugkx2lkCYp85jak0n5z7-bq_4ug2Rntk9iWT",
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"title": "MrBeast",
"url": "https://www.youtube.com/@MrBeast",
"handle": "MrBeast"
},
"content": "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 🥰",
"image": "https://yt3.ggpht.com/9davaq2roo2vRpZ80IIGBiCAy6CmeYfm17AkJbLofKYVreyWRk9Y3SF2tcHwTpdGSzRXym9Y_6096A=s988-c-fcrop64=1,00c60000ff39ffff-rw-nd-v1",
"images": [
"https://yt3.ggpht.com/9davaq2roo2vRpZ80IIGBiCAy6CmeYfm17AkJbLofKYVreyWRk9Y3SF2tcHwTpdGSzRXym9Y_6096A=s988-c-fcrop64=1,00c60000ff39ffff-rw-nd-v1"
],
"likeCountText": "161K",
"likeCount": 161000,
"publishedTimeText": "5 days ago",
"publishedTime": "2026-10-20T17:07:16.695Z",
"video": null
},
{
"id": "UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
"url": "https://www.youtube.com/post/UgkxHIfkQ3K2my65-kPq4VkRv9KrBRyN7alx",
"channel": {
"id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
"title": "MrBeast",
"url": "https://www.youtube.com/@MrBeast",
"handle": "MrBeast"
},
"content": "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",
"image": "https://yt3.ggpht.com/-gQueci3cQXl50-Tgiv_Ru65aUfw2-6aHe9ny2Iy1KWoU1iAALkCZ9VeiZkH5tcqqiAjaTjb50D7iQ=s1320-c-fcrop64=1,35f50000ca0affff-rw-nd-v1",
"images": [
"https://yt3.ggpht.com/-gQueci3cQXl50-Tgiv_Ru65aUfw2-6aHe9ny2Iy1KWoU1iAALkCZ9VeiZkH5tcqqiAjaTjb50D7iQ=s1320-c-fcrop64=1,35f50000ca0affff-rw-nd-v1"
],
"likeCountText": "319K",
"likeCount": 319000,
"publishedTimeText": "3 weeks ago",
"publishedTime": "2026-10-04T17:07:16.695Z",
"video": null
}
],
"continuationToken": "4qmFsgKBARIYVUNYNk9RM0RrY3NiWU5FNkg4dVFRdVZBGkxFZ1Z3YjNOMGM2b0RLQW9rVVRKb1ExSkdWa1ZUYkdoT1VqRktSMVZxUWxkVGJVWnlWbFJPVlZKcldrVlNWVVpDS0FyeUJnUUtBa29BmgIWYmFja3N0YWdlLWl0ZW0tc2VjdGlvbg%3D%3D"
}Common to every endpoint
Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.
GET /v1/cosmos/profile?handle=design
{
"success": false,
"message": "Invalid API key"
}04Notes
10 posts per page, in `posts`. Pass `continuationToken` back for the next page; it is null on the last page. An unknown channel answers 404; a channel without posts returns an empty list for 0 credits.
05Errors & credits
Every error has success: false, a real HTTP status and costs no credits.
400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.