Arama Önerileri

GET/v1/youtube/search/typeahead1 kredi

Yarım bir arama ifadesi için YouTube arama kutusunun önerilerini, önerilen kanallarla birlikte döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
queryzorunlu	string	Şu ana kadar yazılan metin.

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/search/typeahead?query=mr+beast" \
  -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/search/typeahead?query=mr%20beast

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "query": "mr beast",
  "suggestions": [
    {
      "text": "mrbeast",
      "type": "channel",
      "channel": {
        "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "handle": "@MrBeast",
        "name": "MrBeast",
        "thumbnailUrl": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s88-c-k-c0x00ffffff-no-rj"
      }
    },
    {
      "text": "mr beast give me some money",
      "type": "query"
    }
  ]
}

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

Her önerinin `type` değeri `query` veya `channel` olur; kanal önerilerinde kanalın kimliği, kullanıcı adı, adı ve küçük resmi bulunur. Öneri yoksa 0 krediyle boş liste döner.

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.