Hashtag Araması

GET/v1/youtube/search/hashtag1 kredi

Bir hashtag ile etiketlenmiş videoları ve Shorts videolarını döndürür.

01Sorgu parametreleri

Ad	Tür	Açıklama
hashtagzorunlu	string	Hashtag, `#` ile ya da `#` olmadan (ör. `funny`).
typeisteğe bağlı	string	`shorts` yalnızca Shorts videolarını döndürür.Varsayılan: `all`Kabul edilen değerler:`allshorts`
continuationTokenisteğe bağlı	string	Önceki sayfanın `continuationToken` değeri.

02İstek

curl "https://api.scrapesocial.ai/v1/youtube/search/hashtag?hashtag=funny" \
  -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/hashtag?hashtag=funny

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "videos": [
    {
      "type": "video",
      "id": "pRxpQTF8ym8",
      "url": "https://www.youtube.com/watch?v=pRxpQTF8ym8",
      "title": "TRY NOT TO LAUGH 😆 Top Funniest Moments 😅😂 Memes PART 2",
      "thumbnail": "https://i.ytimg.com/vi/pRxpQTF8ym8/hq720.jpg?sqp=-oaymwEgCNAFEJQDSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLBxnjr515dfsTMesR678eClLwi1TQ",
      "channel": {
        "id": "UC-0-SQSQhgTuXFMX994jUAA",
        "title": "FC Memes",
        "handle": "fcmemes12",
        "thumbnail": "https://yt3.ggpht.com/eQ1cjC1iNdP_Jva9qoIBaSh5SZU93jwgiwcHcEm-TCaZyBvGSWeDSFUhCaFFEsJjndOotZ5iqg=s68-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "9,378,767 views",
      "viewCountInt": 9378767,
      "publishedTimeText": "10 months ago",
      "publishedTime": "2025-12-25T17:07:17.311Z",
      "lengthText": "18:14",
      "lengthSeconds": 1094,
      "badges": []
    },
    {
      "type": "video",
      "id": "iLTxTDelLwE",
      "url": "https://www.youtube.com/watch?v=iLTxTDelLwE",
      "title": "Jun Jun funny video😂😂😂best TikTok compilation 2024#shorts#funny#cocomelon",
      "thumbnail": "https://i.ytimg.com/vi/iLTxTDelLwE/hqdefault.jpg?sqp=-oaymwEgCOADEI4CSFXyq4qpAxIIARUAAIhCGAFwAcABBrgC9xg=&rs=AOn4CLBaXY68Q5_f3KtFq6aGL9sZ275VOw",
      "channel": {
        "id": "UCiANwF7TtFb4UJ4awhzBqQg",
        "title": "Jun Jun House",
        "handle": "junjunworld9795",
        "thumbnail": "https://yt3.ggpht.com/DPrRxcRyw384gZ-vHLAC4Cd6gD_BxJY60vUHn1r4TX-MkETRBdu9DMXNeuQz0O7_JERo6Lawsps=s68-c-k-c0x00ffffff-no-rj"
      },
      "viewCountText": "8,541,597 views",
      "viewCountInt": 8541597,
      "publishedTimeText": "1 year ago",
      "publishedTime": "2025-10-25T17:07:17.311Z",
      "lengthText": "13:57",
      "lengthSeconds": 837,
      "badges": []
    }
  ],
  "channels": [],
  "playlists": [],
  "shorts": [
    {
      "type": "short",
      "id": "dCu2a3SWvA0",
      "url": "https://www.youtube.com/watch?v=dCu2a3SWvA0",
      "title": "I NEED TO WIN #shorts #funny #funny",
      "viewCountText": "2.6M",
      "viewCountInt": 2600000
    },
    {
      "type": "short",
      "id": "sDOdOd2FFeE",
      "url": "https://www.youtube.com/watch?v=sDOdOd2FFeE",
      "title": "Crazy Dinosaur Sound 😂🤣 | #pawanuu_comedian #trending #comedy #funny",
      "viewCountText": "32K",
      "viewCountInt": 32000
    }
  ],
  "shelves": [],
  "lives": [],
  "continuationToken": "EqsBEggiI2Z1bm55IhqeAVNCU0NBUXR3VW5od1VWUkdPSGx0T0lJQkMybE1WSGhVUkdWc1RIZEZnZ0VMTnpWVWVtcHFTV0pmY2xHQ0FRdGhhblpuTW0xTGRISjFOSUlCQzA1d2JpMW5RVmxEYVdOWmdnRUxOMGxaV0Vka2VteElSRldDQVF0VGRYbzBNSGxXUlVGbVFiSUJCZ29FQ0FrUUF1b0JCQWdDRUJrJTNEGIHg6BgiC3NlYXJjaC1mZWVk"
}

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

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. Sonuç yoksa 0 krediyle boş listeler 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.