Logo SearchApi

TikTok Hashtag API Documentation

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

The TikTok Hashtag API returns structured data for a single TikTok hashtag. You get its id, name, description, thumbnail and cover images, and its total video and view counts. Any hashtag in the hashtags of a TikTok Video API response can be looked up here, and its name works as the q of the TikTok Search API to find related videos.

API Parameters

Search Query

  • Name
    hashtag
    Required
    Required
    Description

    The hashtag to look up, with or without the leading # (e.g. football or #football). Hashtags are made of letters in any script, numbers, underscores and emoji, up to 70 characters. TikTok matches the hashtag regardless of letter case, and the response's name is the hashtag it matched. A hashtag TikTok does not know, or restricts, returns a 200 with an error field set to TikTok Hashtag not found.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tiktok_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

Hashtag

Hashtag

The hashtag object carries TikTok's id, the name without the leading # and the title with it, the hashtag page link, the description, the thumbnail and cover images, and the exact videos and views totals. is_commerce is true for hashtags TikTok marks as commerce hashtags.

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

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

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_mbBkhmmtyHry9ZvGpmGiOW1y",
    "status": "Success",
    "created_at": "2026-10-01T01:01:38Z",
    "request_time_taken": 3.11,
    "parsing_time_taken": 0.02,
    "total_time_taken": 3.13,
    "request_url": "https://www.tiktok.com/tag/gaming",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_mbBkhmmtyHry9ZvGpmGiOW1y.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_mbBkhmmtyHry9ZvGpmGiOW1y"
  },
  "search_parameters": {
    "engine": "tiktok_hashtag",
    "hashtag": "gaming"
  },
  "hashtag": {
    "id": "16057",
    "name": "gaming",
    "title": "#gaming",
    "link": "https://www.tiktok.com/tag/gaming",
    "description": "Stock up on extra lives, because we're celebrating the #Gaming community. Show us what you're playing, where you play, and your top recommendations!",
    "thumbnail": "https://p19-common-sign.tiktokcdn-us.com/musically-maliva-obj/abf81c1fcbc19bbe0aaadcfdb462a061.png~t...",
    "cover": "https://p16-common-sign.tiktokcdn-us.com/musically-maliva-obj/3a487123fee6293297f60302b2bc9476.png~t...",
    "videos": 88117737,
    "views": 1244624414994
  }
}