Logo SearchApi

YouTube Hashtag API Documentation

GET   /api/v1/search?engine=youtube_hashtag
OpenAPI Initiative Download OpenAPI Spec

The YouTube Hashtag API returns the videos or shorts YouTube lists under a hashtag, with the hashtag's approximate video and channel counts.

API Parameters

Search Query

  • Name
    hashtag
    Required
    Required
    Description

    Defines the hashtag to look up, with or without the leading #. Examples: funny, #cooking. Up to 100 characters, with only letters, numbers and underscores. Values from the hashtags field of the YouTube Post API can be passed as they are.

Filters

  • Name
    search_type
    Required
    Optional
    Description

    Selects the hashtag feed to return, one of all or shorts. all returns the videos YouTube lists under the hashtag, and shorts returns its shorts.

Localization

  • Name
    gl
    Required
    Optional
    Description

    The default parameter US defines the country of the search. Check the full list of supported YouTube gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported YouTube hl languages.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    A token used to retrieve the next page of the same hashtag and search_type. Use the pagination.next_page_token from the previous response.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines the engine that will be used to retrieve real-time data. To retrieve videos and shorts from a YouTube hashtag, it must be set to youtube_hashtag.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response

Each page holds up to 36 videos. Videos that are YouTube Shorts carry is_short, and live streams carry is_live with their current viewers in views. Some hashtags list a single page, so the response has no pagination.

Use the pagination.next_page_token to retrieve the next page. Paginated responses don't include the hashtag object. Hashtags without a YouTube hashtag page return an error message instead of results.

GET
https://www.searchapi.io/api/v1/search?engine=youtube_hashtag&hashtag=cooking
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "youtube_hashtag",
  "hashtag": "cooking"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_savSP3BPGOCd8EDfw5JrpkSa",
    "status": "Success",
    "created_at": "2026-09-29T00:49:24Z",
    "request_time_taken": 1.95,
    "parsing_time_taken": 0.18,
    "total_time_taken": 2.13,
    "request_url": "https://www.youtube.com/hashtag/cooking",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_savSP3BPGOCd8EDfw5JrpkSa.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_savSP3BPGOCd8EDfw5JrpkSa"
  },
  "search_parameters": {
    "engine": "youtube_hashtag",
    "hashtag": "cooking",
    "search_type": "all",
    "gl": "US",
    "hl": "en"
  },
  "hashtag": {
    "title": "#cooking",
    "link": "https://www.youtube.com/hashtag/cooking",
    "videos": 41000000,
    "channels": 4100000
  },
  "videos": [
    {
      "position": 1,
      "id": "FUc6iKRXeUc",
      "title": "First Day in Georgia! Cooking Chicken for a Heartwarming Dinner",
      "link": "https://www.youtube.com/watch?v=FUc6iKRXeUc",
      "views": 390908,
      "channel": {
        "id": "UCjAKzWYZLayOQfSud0lU1vQ",
        "title": "Royal Cooking",
        "link": "https://www.youtube.com/channel/UCjAKzWYZLayOQfSud0lU1vQ",
        "thumbnail": "https://yt3.ggpht.com/wO9nCIsV1rU0UGMXVeXZSstwE7LnZx9Wdp8rmRMUPHNe4m06abCt1v5eXvuvEfhYhgG0BdtMrg=s68..."
      },
      "length": "39:41",
      "published_time": "1d ago",
      "thumbnail": {
        "static": "https://i.ytimg.com/vi/FUc6iKRXeUc/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs...",
        "rich": "https://i.ytimg.com/vi/FUc6iKRXeUc/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs..."
      }
    },
    "..."
  ],
  "pagination": {
    "next_page_token": "eyJ0b2tlbiI6IjRxbUZzZ0x4QlJJSlJrVm9ZWE5vZEdGbkdzd0ZRME5TTmw5M1RrUlJNVVpTVVZWS2NXUklielZWUmxaNFRqQm9RMDlYVFRSUmEyUk9Uak5aTVZSVVpEWlBWR015WkVab2IyRnFVVE5hYkU0MFQwWTVkVTVYYURSaE1Xd3dZakJrY21Nd2NEVlJla1V5V1cwMVFsVnRiRnBhTUhodFZXNWtlV1JxUW5GVVIzUkRVakJzTWxKcVNreGFWWE0xV2xWbmQxcEZTbkZTV0d4clZESTBlRnB0YkRST1ZqbENVV3RrVUdGWVozUlVXSEJTWWtoT01XRkZaRk5oV0d4NldsZFdhVTB5Um5oVldGcG1WbFZLU0ZSck9UWmhlVEZRVVdwV1RHSlhNRFZSVlZaYVkzcFdTV0pIZUhkUk1sazFaRWRKTWxGV1NuRlRibTh3Vkhwa05sbFdhRE5oYWtacVYxZHNVVmxyV1RCa1ZWSkNZak5TVEdSclJsTmhiRXB6V20xSk0yUlhVWGxWYm1SNFRVVktTRlJzVG01aVJGSnhVVmhLZDJKVWEzZFZWVlphWVZSc2NHVkhkSFpWUmtwMlkwVjBObEZXU25GTmJEbE5WakJ3YmxkdE5IbGtTRVoyVVd0a1QxVXhhek5PZWs1V1pWaE9TRlo1TVVKU1ZteHpURmhGZUUxSVduRlNWM2N5V2pBNVNGTXhPVlZQV0VaMVdsUldNbHBxYkdwbFIzQkVZekU1Y0dWdVZsQmphemx2VGtaR1ExSXdjSEZYYm1Rd1dtMWpNbE51V2tKU1JVcHhWV3c0TUZkSWJHWlVNM0IwWWtaU2JsZFlWbmRPYlU1eFZESTFNMkl3TlRKU01FWlRZVlpLZFdSdE1VSmxSamxJVldwR1NWTldiRzlrUkU1WVRWWndTVTVFVG1GaFIwcElVMVk0TUU0eVNUTldXSEJPV21wTk1WVlZWbHBqU0VKWVYyMXNZVlZIT1haT2VrRXpVakE1UkZkcVpHRlJlbXgxVjFkc1UyTkZSa1pYVkdSS1pWYzVjRk5xV2xWa2JrcHZVMFZrU21OclNUVk1VekF5WWpFNVJGRlZSalJoVlZKMVl6RlJlV0l5U2xSaFZGWnpZakZzY2xScVpHOWtNbEYwVVZSWk1rMUhkRWhUYlVwMVlVUnNkRXhZV2xwa1V6RlVVVzFzVG1GRWJHeGlWRTUzWVcxc2NWbHNiRU5TTUhBeFZETndiVkV3WkhKVE0wWlFaV3hHUmpablZVNURaMlJxWWpJNWNtRlhOVzVGUVVGWlFWRWxNMFFsTTBTYUFoUmljbTkzYzJVdFptVmxaRVpGYUdGemFIUmhadyUzRCUzRCIsInZpc2l0b3JfZGF0YSI6IkNndEJaR3RDYVhwRlpVSlZUU2lWbHV6VkJqSUtDZ0pWVXhJRUdnQWdWbUxmQWdyY0FqSXlMbGxVUFVwWVZXWXdVM0p3U0dWb2QyODBia3MwWlZCUVdqbFRlVlpqU0dWMGQxaGZVM0ZCVTFsSGVVZG9UelIxUW5oalowTlFNR0V3VEhZMmIzaHRRVEJCY2kxbVlrVjNWbGxWY201WWREbElNRmcxVkZKVVZHaGFVMk5qWjJkWU5HVk9kREJSVkZBelVsbHhNbGxMYTB4a2NGUmliRU0xY0dWNmJHRlpjRFJLVXpoWWRsWjBWbWxsWnpsVFJEVm9ialozVG5OUVgyNWpOeTF1VDJsNlZHazBhWFpTYlRCNGRXbFFkbWM1VlVoRVRteHlTbm80YzFkaVRHNXBVekJyWm1WeVFXMUVRbXBKWjFCUFFqUXRWMVZPTnkxRVpFcGFUbnBzVTJ0cGJXNUtkMmh0TnpkUmNGRTVOa2RUUVVwRVlYVldSblE0TXpGS1FXSmFlSHB4TWpsVWQzUnNiVGx1WWxOS05ubERjMkpwUzBGRWFqZElibkV0Tm5aVlpHVnJWVlpTT0Vjd09YUm1aVFZJYkdWT1IyMU9OVlZmV0RWc2VVczNRVWwwUmxaSk5FTjNla1ZEVTJneU1GUktXR3hKYjFwV2RFa3hPVWhUUVElM0QlM0QiLCJjbGllbnRfdmVyc2lvbiI6IjIuMjAyNjA5MjUuMDguMDAifQ"
  }
}

Shorts

Shorts

Set search_type to shorts to get the hashtag's shorts feed. Shorts carry the title, link, thumbnail and an approximate view count.

GET
https://www.searchapi.io/api/v1/search?engine=youtube_hashtag&hashtag=funny&search_type=shorts
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "youtube_hashtag",
  "hashtag": "funny",
  "search_type": "shorts"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_V6QeGdKRg9qeslqWg8mBExyv",
    "status": "Success",
    "created_at": "2026-09-30T18:47:31Z",
    "request_time_taken": 1.82,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.83,
    "request_url": "https://www.youtube.com/hashtag/funny/shorts",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_V6QeGdKRg9qeslqWg8mBExyv.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_V6QeGdKRg9qeslqWg8mBExyv"
  },
  "search_parameters": {
    "engine": "youtube_hashtag",
    "hashtag": "funny",
    "search_type": "shorts",
    "gl": "US",
    "hl": "en"
  },
  "hashtag": {
    "title": "#funny",
    "link": "https://www.youtube.com/hashtag/funny",
    "videos": 516000000,
    "channels": 42000000
  },
  "shorts": [
    {
      "position": 1,
      "id": "MLVF8JLeJV0",
      "title": "This Woman Had the Officer Speechless #funny #shorts #skit #comedy #usa",
      "link": "https://www.youtube.com/shorts/MLVF8JLeJV0",
      "views": 21000000,
      "thumbnail": "https://i.ytimg.com/vi/MLVF8JLeJV0/oardefault.jpg?sqp=-oaymwEdCJUDENAFSFWQAgHyq4qpAwwIARUAAIhCcAHAAQ..."
    },
    "..."
  ],
  "pagination": {
    "next_page_token": "eyJ0b2tlbiI6IjRxbUZzZ0xYQVJJSlJrVm9ZWE5vZEdGbkdySUJRME5TTm1Nd1RrUlVWa1pEVlcwNU1XUXlaRnBqYTA1dVZtMHhhMVo2VmpGYVZrcEtZVlpPUjFWWWJGUmlWM2gyVlcweE5HUXhVbGhPVjBaV1VtMTRkRlpWVFhoVVIxWkpXa2QwYVdKRVozbFZWM013VFRKT2RGVnNjR2hsYlhNd1dsZHNTbFZyVG01UFJFWlFZV3RWZWxReFVrSk5NRGxWVlZoa1QxWkZiRFZVYlhCR1kxVlNVbUl3ZUdGaVIyaE9Xa1JLTUZVeFpGVldiVEZoVW0xMmNVSlJhMHRDVjFveFltMDFOVWRCVFNVelJKb0NGR0p5YjNkelpTMW1aV1ZrUmtWb1lYTm9kR0ZuIiwidmlzaXRvcl9kYXRhIjoiQ2d0d1JuZEJVMDkxVUc1c1l5akVzdlhWQmpJS0NnSlZVeElFR2dBZ0syTGZBZ3JjQWpJeUxsbFVQWE5uY0dFMU5YUkxURkZ1Y0VoSGJWWTRRalZWYzJodWJVVnNXVGR1TVdWUWNpMWpOVUZYV0Y5blRFSkhaRzFtY0ROeWFFWm1kRk5DY2tGWldGSTJSRWRqZURBNFRWTmlXVFJEYTNCa2VtMVRTakJOV1Y5cFIzVlFXV2MwWTJkUmFVVmFaRm8wYjIwM2JDMTVlVlJwY1VoM1NVMW9ObTk1VG1WNGJsWjVjVGgzVDE4MlZtWTBOMU5pVVU5QlFVaENaV1ZwV0ROV1FUQlVVM280TVRkVFF6UmZTa3BOV0c1blpHRmlRbWRtZDBjNVdUVk1VamxMZW1KQmEyTmZUR3hDY1VwVGJrWk5hWGt5VFVsUGVubHdUMDVtU1dZelFpMTVVWFZUVkhOVFZ6SnBSbmwxZEZocGVWVmhjMGQxWWw5bWIycGlNMDEwT0VKd2Jta3hZelZpZG1VMWRrY3lNVFJmZWtGc1VtZ3RYMFZKTnpGRVlqUnBkbUpzVHpoa1ZrNDNPRGRNZEd0a05YWmFNV1ZyZWtKcmVHNUdkRkJ4YzA5TGRFbHBlbWxFT1VwUGFtMHlOekI2ZEU1cWVIbzRVSGxzVW5BM1dVbHRVUSUzRCUzRCIsImNsaWVudF92ZXJzaW9uIjoiMi4yMDI2MDkzMC4wMC4wMCJ9"
  }
}