Kanal Oynatma Listeleri

GET/v1/youtube/channel/playlists1 kredi

Bir kanalın Oynatma listeleri sekmesindeki listeleri döndürür; her listede kimlik, başlık, video sayısı, ilk video ve kanal bilgisi bulunur.

01Sorgu parametreleri

Ad	Tür	Açıklama
handleisteğe bağlı	string	Kanalı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/playlists?handle=TED" \
  -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/playlists?handle=TED

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [],
  "channels": [],
  "playlists": [
    {
      "type": "playlist",
      "id": "PLQpQQFZKzl7o",
      "title": "TED Talks on Mental Fitness",
      "thumbnail": "https://i.ytimg.com/vi/xb0nLpdWttA/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD_A9XYBqmEWYXWbqtszpizQ4VCJw",
      "playlistUrl": "https://www.youtube.com/playlist?list=PLQpQQFZKzl7o",
      "videoId": "xb0nLpdWttA",
      "videoUrl": "https://www.youtube.com/watch?v=xb0nLpdWttA",
      "videoCount": 10,
      "channel": {
        "id": "UCAuUUnT6oDeKwE6v1NGQxug",
        "title": "TED",
        "handle": "TED",
        "channelUrl": "https://www.youtube.com/@TED"
      }
    },
    {
      "type": "playlist",
      "id": "PLUCPc-R61w-s",
      "title": "Talks for when you want to start a new hobby",
      "thumbnail": "https://i.ytimg.com/vi/rIRon8zJyps/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCSkyJnEt5B4Z1HvOrRfBwOd3sZRQ",
      "playlistUrl": "https://www.youtube.com/playlist?list=PLUCPc-R61w-s",
      "videoId": "rIRon8zJyps",
      "videoUrl": "https://www.youtube.com/watch?v=rIRon8zJyps",
      "videoCount": 11,
      "channel": {
        "id": "UCAuUUnT6oDeKwE6v1NGQxug",
        "title": "TED",
        "handle": "TED",
        "channelUrl": "https://www.youtube.com/@TED"
      }
    }
  ],
  "shorts": [],
  "shelves": [],
  "lives": [],
  "continuationToken": "4qmFsgJ4EhhVQ0F1VVVuVDZvRGVLd0U2djFOR1F4dWcaKkVnbHdiR0Y1YkdsemRITVlBeUFBTUFFNEFlb0RCME5uVGtSUmFsRSUzRJoCL2Jyb3dzZS1mZWVkVUNBdVVVblQ2b0RlS3dFNnYxTkdReHVncGxheWxpc3RzMTA0"
}

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 yaklaşık 27 liste, `playlists` listesinde. Yanıtta her zaman altı liste (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) ve `continuationToken` bulunur; ilgisiz listeler boş gelir. Sonraki sayfa için `continuationToken` değerini geri gönderin; son sayfada null olur. Bilinmeyen bir kanal 404 döndürür; bu sekmede hiçbir şey olmayan bir kanal boş listeleri 0 krediyle döndürür. YouTube'un kabul etmediği bir token 400 hatası verir.

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.