Tek Yorum

GET/v1/youtube/video/comment1 kredi

Tek bir yorumu ya da yanıtı kimliğiyle, bir yorum bağlantısından (`watch?v=…&lc=…`) döndürür; belirli bir yorumun var olduğunu doğrulayıp metnini, yazarını, beğeni ve yanıt sayısını okuyabilirsiniz.

01Sorgu parametreleri

Ad	Tür	Açıklama
urlzorunlu	string	Video URL'si (watch, youtu.be, shorts veya live). Bir yorum bağlantısı yorum kimliğini `lc` içinde taşır (ör. `https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=UgwPwTibxdgqCHZxktd4AaABAg`); `lc` yoksa `comment_id` gönderin.
comment_idisteğe bağlı	string	Yorum kimliği; bir yanıtın kimliği `<üst yorum kimliği>.<yanıt kimliği>` biçimindedir. `url` içinde `lc` yoksa zorunludur; ikisi de verilirse `comment_id` kullanılır.

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/video/comment?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ%26lc%3DUgwPwTibxdgqCHZxktd4AaABAg" \
  -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/video/comment?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ%26lc%3DUgwPwTibxdgqCHZxktd4AaABAg

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "id": "UgwPwTibxdgqCHZxktd4AaABAg",
  "content": "My algebra teacher said that this was a link to the test answers",
  "publishedTimeText": "7 years ago",
  "publishedTime": "2019-10-25T17:07:17.411Z",
  "replyLevel": 0,
  "author": {
    "name": "@bdr8823",
    "channelId": "UCdi6tGxvFvTRGe-7dAn7m7w",
    "isVerified": false,
    "isCreator": false,
    "avatarUrl": "https://yt3.ggpht.com/ytc/AIdro_kcDoQJUNDkDzTrA5kaF5ADVujN-6UcDjMP2Kydtw=s88-c-k-c0x00ffffff-no-rj",
    "channelUrl": "https://youtube.com/@bdr8823"
  },
  "engagement": {
    "likes": 69000,
    "replies": 639
  },
  "repliesContinuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd3UHdUaWJ4ZGdxQ0haeGt0ZDRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3dQd1RpYnhkZ3FDSFp4a3RkNEFhQUJBZw%3D%3D",
  "parent": null,
  "videoId": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ&lc=UgwPwTibxdgqCHZxktd4AaABAg"
}

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

Kendi uç noktamız (ScrapeCreators'ta tek yorum için bir uç nokta yok). Yanıt, yorumu `/v1/youtube/video/comments` listesindeki bir öğeyle aynı biçimde verir (`id`, `content`, `publishedTimeText`, `publishedTime`, `replyLevel`, `author`, `engagement`, `repliesContinuationToken`); ayrıca `parent`, `videoId` ve `url` (yorum bağlantısı) alanları vardır. Bir yanıtta `replyLevel` 1, `repliesContinuationToken` null ve `parent` yanıtlanan yorumdur; üst düzey bir yorumda `parent` null olur. YouTube'un göstermediği bir yorum (silinmiş, incelemede bekletilen ya da yanlış kimlik) 404 `Comment not found`, bilinmeyen bir video 404 `Video not found`, yorumları kapalı bir video 404 `Comments are turned off for this video` döndürür; hepsi ücretsizdir. `lc` içermeyen bir URL ile `comment_id` gönderilmemesi ya da yorum kimliği olamayacak bir değer ücretsiz 400 hatası verir. Bulunamayan bir yorumun yanıtı daha uzun sürer (yaklaşık 8–12 sn), çünkü yok demeden önce birkaç bağlantıdan kontrol edilir.

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.