Skip to content

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

NameTypeDescription
handleoptionalstringChannel handle, with or without the leading `@` (e.g. `MrBeast`). One of `handle` or `channelId` is required, unless you send a `continuationToken`.
channelIdoptionalstringChannel id starting with `UC` (e.g. `UCX6OQ3DkcsbYNE6H8uQQuVA`). One of `handle` or `channelId` is required, unless you send a `continuationToken`.
continuationTokenoptionalstringThe `continuationToken` from the previous page. It can be sent on its own, without the channel.
regionoptionalstringTwo-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.