Search TikTok Hashtags API

Endpoint

GET /v1/tiktok/hashtags

Parameters

query *

Search keyword (max 500 characters)

pages

Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 30 hashtags.

Response fields

hashtags

Array of matching hashtags, most relevant first

hashtag_id

Numeric hashtag ID

name

Hashtag name, without the #

description

Hashtag description, or empty string

video_count

Number of videos using the hashtag

views

Total views across the hashtag's videos

is_commerce

Whether TikTok flags the hashtag as commercial

cover

Cover image URL, or empty string

url

Link to the hashtag page

pages

Number of pages returned

count

Number of results returned

Example Request

curl "https://apidirect.io/v1/tiktok/hashtags?query=cooking&pages=2"   -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/hashtags",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "cooking",
        "pages": 2
    }
)
print(response.json())

Example Response

{
  "hashtags": [
    {
      "hashtag_id": "18973",
      "name": "cooking",
      "description": "",
      "video_count": 19318490,
      "views": 555119436497,
      "is_commerce": false,
      "cover": "https://p16-common-sign.tiktokcdn.com/.../cover.jpeg",
      "url": "https://www.tiktok.com/tag/cooking"
    },
    {
      "hashtag_id": "8620710",
      "name": "cookingtips",
      "description": "",
      "video_count": 622053,
      "views": 12157160228,
      "is_commerce": false,
      "cover": "https://p16-common-sign.tiktokcdn.com/.../cover.jpeg",
      "url": "https://www.tiktok.com/tag/cookingtips"
    }
  ],
  "pages": 2,
  "count": 60
}

Frequently asked questions

What do video_count and views mean?

video_count is the number of videos using the hashtag and views is their total view count, as TikTok reports them.

How do I get a hashtag's videos?

Pass its name or hashtag_id to the Hashtag Videos endpoint.

How does pricing work?

You only pay for successful requests. The Search TikTok Hashtags API costs $0.006 per page. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 10 simultaneous requests per endpoint per user. If you need more, just get in touch.