# TikTok Hashtag API (https://www.socialcrawl.dev/platforms/tiktok/hashtag)

> Returns TikTok's own record for a hashtag: its display name, its description where the platform has written one, and the two numbers that size it. `post.engagement.views` is the total views of videos under the tag and it is live, moving between calls minutes apart. `post.ext.video_count` is how many videos carry the tag. Pass either the tag name or, if you already have it, TikTok's numeric hashtag id. Use `/v1/tiktok/search/hashtag` to read the videos themselves.

TL;DR: `GET /v1/tiktok/hashtag` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `hashtag` | no | Hashtag name, with or without the leading # symbol. |
| `hashtag_id` | no | TikTok numeric hashtag id. Skips the name lookup when you already have it. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tiktok/hashtag" \
  --data-urlencode "hashtag=kpop" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TikTok Hashtag API return?

Returns TikTok's own record for a hashtag, with its display name, its description where one exists, the live total views under the tag, and how many videos carry it. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the TikTok Hashtag endpoint?

Use it to size a tag before pulling its posts. Pass the tag name and the id lookup happens for you, or pass hashtag_id when you already hold it.

### How much does the TikTok Hashtag API cost?

Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the TikTok Hashtag API need?

Identify the target with one of hashtag, hashtag_id. It also accepts 2 optional parameters, all listed on this page.

### How do I call the TikTok Hashtag API?

Send a GET request to https://www.socialcrawl.dev/v1/tiktok/hashtag?hashtag=kpop with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full TikTok API: https://www.socialcrawl.dev/platforms/tiktok

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl TikTok Hashtag API return?
- How do I get TikTok Hashtag data with the SocialCrawl API?