İçeriğe geç

Kanal Gönderileri

GET/v1/youtube/channel/community-posts1 kredi

Bir kanalın Gönderiler sekmesindeki topluluk gönderilerini döndürür: metin, görseller, ekli video, beğeni sayısı ve yayın zamanı.

01Sorgu parametreleri

AdTürAçıklama
handleisteğe bağlıstringKanalın kullanıcı adı, başında `@` olsun ya da olmasın (ör. `MrBeast`). `handle` veya `channelId` parametrelerinden biri zorunludur; `continuationToken` gönderirseniz gerekmez.
channelIdisteğe bağlıstring`UC` ile başlayan kanal kimliği (ör. `UCX6OQ3DkcsbYNE6H8uQQuVA`). `handle` veya `channelId` parametrelerinden biri zorunludur; `continuationToken` gönderirseniz gerekmez.
continuationTokenisteğe bağlıstringÖnceki sayfanın `continuationToken` değeri. Kanal bilgisi olmadan tek başına gönderilebilir.
regionisteğe bağlıstringİsteğin YouTube bölgesini belirleyen iki harfli ülke kodu (ör. `US`, `GB`).Varsayılan: US

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/channel/community-posts?handle=MrBeast" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Yanıtlar

API'nin gerçek yanıtları. Listeler 2 öğeye kısaltılmıştır.

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"
}

Tüm uç noktalarda ortak

Her rota bunları döndürebilir: eksik ya da hatalı anahtar, biten kredi, yanıt vermeyen platform ya da bizim tarafımızdaki bir hata. Hiçbiri kredi harcamaz.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notlar

Sayfa başına 10 gönderi, `posts` listesinde. Sonraki sayfa için `continuationToken` değerini geri gönderin; son sayfada null olur. Bilinmeyen bir kanal 404 döndürür; gönderisi olmayan bir kanal 0 krediyle boş liste döndürür.

05Hatalar ve krediler

Her hatada success: false ve gerçek bir HTTP durum kodu döner; kredi düşmez.

  • 400missing_parameter

    Zorunlu bir parametre eksik veya geçersiz.

  • 403private_account

    Hesap gizli ya da yaş kısıtlamalı.

  • 404not_found

    Böyle bir hesap yok.

  • 503upstream_error

    Platform şu an cevap vermiyor; tekrar deneyin.