# TikTok Hashtags Popular API (https://www.socialcrawl.dev/platforms/tiktok/hashtags-popular)

> Returns the hashtags TikTok itself ranks as trending in a market over the last 7, 30 or 90 days, from the hashtag board TikTok publishes for advertisers. Each row is one hashtag: `content.text` is the tag (no `#`), `id` is TikTok's hashtag id and `url` its TikTok page. What the board says about it is on `ext.trend`: `rank` on the board it was read from, `posts` and `views` for the window (not the tag's lifetime totals, which is why `engagement.views` is null), `industry` / `industry_id` / `industry_label` naming that board (null for the overall board), `popularity_curve` as one relative value per day (0 to 100, peak = 100), and `top_creators` with handle, name, followers and country. **Depth: TikTok shows three hashtags per board to a reader who is not logged in, and that is what this endpoint reads.** One board is therefore three rows. Pass `industry=all` to read the overall board and all 15 industry boards in one call, typically 44 to 46 unique hashtags, which is where the niche signal is (in Germany the industry boards carried #adventskalender, #kürbis and #berufsschule while the overall board was three general tags). A hashtag that ranks on more than one board appears once and is billed once: its `rank` and `industry` fields name the first board it was read from (overall first, then the industries in TikTok's order), and `ext.trend.boards` lists every board it ranks on with its rank there, so a hashtag in the top 3 overall and on an industry board shows both. **Markets:** the 27 TikTok publishes this board for. **Not available any more:** the 120-day window, a second page, the new-to-top-100 filter, rank change, and the business-services, financial-services and life-services industries; each is refused with a 400 at no charge. **Pricing is metered at 2 credits per hashtag returned, minimum 6.** One board costs 6; `industry=all` holds 96 and settles to the rows returned (about 90). A board with no rows costs nothing.

TL;DR: `GET /v1/tiktok/hashtags/popular` costs 2 credits per hashtag returned, minimum 6. One board is 6 credits. industry=all holds 96 credits (sixteen boards of three) and settles down to the hashtags actually returned, typically 88 to 92. An empty board costs nothing. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `countryCode` | no | Market to read the board for, as an ISO country code. One of the 27 markets TikTok publishes the board for. Defaults to US. (US \| FR \| DE \| IT \| ES \| GB \| AR \| AU \| BR \| CA \| CO \| EG \| ID \| IL \| JP \| KR \| MY \| MX \| PH \| SA \| SG \| ZA \| TW \| TH \| TR \| AE \| VN) |
| `period` | no | Window in days: 7, 30 or 90. Defaults to 7. Each window is a different board, not a longer list. (7 \| 30 \| 90) |
| `industry` | no | Which board to read. Omit for the overall board (3 hashtags). Pass an industry slug for that industry's board (3 hashtags), or `all` for the overall board plus all 15 industry boards in one call. (all \| education \| vehicle-and-transportation \| baby-kids-and-maternity \| beauty-and-personal-care \| tech-and-electronics \| travel \| household-products \| pets \| home-improvement \| apparel-and-accessories \| news-and-entertainment \| games \| food-and-beverage \| sports-and-outdoor \| health) |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tiktok/hashtags/popular" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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