İçeriğe geç

Oynatma Listesi

GET/v1/youtube/playlist1 kredi

Bir oynatma listesinin başlığını, sahibini, toplam video sayısını ve videolarını döndürür.

01Sorgu parametreleri

AdTürAçıklama
playlist_idzorunlustringOynatma listesi kimliği veya URL'si (ör. `UUX6OQ3DkcsbYNE6H8uQQuVA`).
continuationTokenisteğe bağlıstringÖnceki sayfanın `continuationToken` değeri. Aynı `playlist_id` ile birlikte gönderin.

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/playlist?playlist_id=UUX6OQ3DkcsbYNE6H8uQQuVA" \
  -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/playlist?playlist_id=UUX6OQ3DkcsbYNE6H8uQQuVA

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "title": "Uploads from MrBeast",
  "owner": {
    "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "name": "MrBeast",
    "url": "https://www.youtube.com/@MrBeast",
    "handle": "MrBeast"
  },
  "totalVideos": 1009,
  "videos": [
    {
      "id": "mND4T0lzg_g",
      "title": "How People Treat You Based on Subscribers",
      "thumbnail": "https://i.ytimg.com/vi/mND4T0lzg_g/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLB3z_cZ71HPDxXkGlXMCLU5-ZGb6Q",
      "url": "https://www.youtube.com/watch?v=mND4T0lzg_g",
      "lengthText": "0:30",
      "lengthSeconds": 30,
      "channel": {
        "title": "MrBeast",
        "url": "https://www.youtube.com/@MrBeast"
      }
    },
    {
      "id": "RE3_PGwDwhw",
      "title": "Lose 150 Lbs Together, Win $250,000",
      "thumbnail": "https://i.ytimg.com/vi/RE3_PGwDwhw/hqdefault_custom_3.jpg?sqp=CLzt-NYG-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAwcBUhKZZYRerVurs4DTuiutSTrw",
      "url": "https://www.youtube.com/watch?v=RE3_PGwDwhw",
      "lengthText": "43:17",
      "lengthSeconds": 2597,
      "channel": {
        "title": "MrBeast",
        "url": "https://www.youtube.com/@MrBeast"
      }
    }
  ],
  "continuationToken": "CE8SPBILWkZvTkJ4cFhlbjQiGFVVWDZPUTNEa2NzYllORTZIOHVRUXVWQThO-gEQNThCRjI0OEY0MzBERTlDMxgCggEeUFQ6Q0U4aUVEWkRPRVpDTmtOR05qZzROVGsxTnpj"
}

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 79 video; her sayfa 1 kredidir. İlk sayfada `title`, `owner`, `totalVideos` ve `videos` bulunur; sonraki sayfalarda yalnızca `videos` ve `continuationToken` gelir, son sayfada token null olur. Bilinmeyen bir liste 404, liste kimliği veya URL'si olmayan bir değer 400 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.