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
| Ad | Tür | Açıklama |
|---|---|---|
| playlist_idzorunlu | string | Oynatma 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.