Hashtag Search

GET/v1/youtube/search/hashtag1 credit

Returns videos and Shorts tagged with a hashtag.

01Query parameters

Name	Type	Description
hashtagrequired	string	The hashtag, with or without `#` (e.g. `funny`).
typeoptional	string	`shorts` returns only Shorts.Default: `all`Accepted values:`allshorts`
continuationTokenoptional	string	The `continuationToken` from the previous page.

02Request

curl "https://api.scrapesocial.ai/v1/youtube/search/hashtag?hashtag=funny" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

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"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

The answer always has six lists (`videos`, `channels`, `playlists`, `shorts`, `shelves`, `lives`) plus `continuationToken`; lists that do not apply are empty. Pass `continuationToken` back for the next page; it is null on the last page. No results = empty lists for 0 credits.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.