# TikTok Trending Hashtags API. Trending hashtags, on request. Ranked by country, period and industry. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.trending_hashtags) ## TikTok Trending Hashtags API at a glance Returns TikTok Creative Center's top trending hashtags for a country over 7, 30 or 90 days, overall or in one industry. Each has its rank, ID and tag page link, how many posts used it and how many views they drew in the window, its day-by-day popularity curve and its industry. With no parameters you get the US overall board for the latest 7 days. GET `/v1/tiktok/trending_hashtags` [Read the API reference](https://socialtap.dev/docs/reference/tiktok/trending_hashtags/index.md) - **1 credit** per page, $0.75–$1.97 per 1,000 pages - **9 typed fields** null when unknown - **20** hashtags per page, Creative Center's trend rank (1 = most popular) - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get up to 20 hashtags back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` [Open in playground](https://socialtap.dev/playground/?endpoint=tiktok.trending_hashtags) cURL: ```shell curl 'https://socialtap.dev/v1/tiktok/trending_hashtags' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.tiktok.trendingHashtags.list({}); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ }); const res = await fetch(`https://socialtap.dev/v1/tiktok/trending_hashtags?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, page, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/tiktok/trending_hashtags", params={}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, page, meta = body["data"], body["page"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/trending_hashtags?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Page json.RawMessage `json:"page"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": [ { "approximate_fields": [], "description": null, "id": "7691443554018656263", "metrics": { "post_count": null }, "name": "tiktokscaryhorrorcontest", "platform": "tiktok", "platform_specific": { "tiktok": { "banner_url": null, "industry": null, "is_new_to_board": null, "is_promoted": null, "period_post_count": 73462, "period_view_count": 312182870, "rank": 1, "rank_change": null, "trend": [ { "popularity": 0, "start_at": "2026-10-09T00:00:00Z" }, { "popularity": 0.49960472751387236, "start_at": "2026-10-10T00:00:00Z" }, { "popularity": 0.6260068613247346, "start_at": "2026-10-11T00:00:00Z" } ], "view_count": null } }, "thumbnail_url": null, "unknown_fields": [], "url": "https://www.tiktok.com/tag/tiktokscaryhorrorcontest" }, { "approximate_fields": [], "description": null, "id": "7462773581512966150", "metrics": { "post_count": null }, "name": "marvelrivalsavengers", "platform": "tiktok", "platform_specific": { "tiktok": { "banner_url": null, "industry": "Games", "is_new_to_board": null, "is_promoted": null, "period_post_count": 110088, "period_view_count": 24120743, "rank": 2, "rank_change": null, "trend": [ { "popularity": 0.9554338258860562, "start_at": "2026-10-09T00:00:00Z" }, { "popularity": 1, "start_at": "2026-10-10T00:00:00Z" }, { "popularity": 0.09724921698774618, "start_at": "2026-10-11T00:00:00Z" } ], "view_count": null } }, "thumbnail_url": null, "unknown_fields": [], "url": "https://www.tiktok.com/tag/marvelrivalsavengers" }, { "approximate_fields": [], "description": null, "id": "7534678037321744414", "metrics": { "post_count": null }, "name": "livecanbeeasy", "platform": "tiktok", "platform_specific": { "tiktok": { "banner_url": null, "industry": "News & Entertainment", "is_new_to_board": null, "is_promoted": null, "period_post_count": 21285, "period_view_count": 30155625, "rank": 3, "rank_change": null, "trend": [ { "popularity": 0, "start_at": "2026-10-09T00:00:00Z" }, { "popularity": 0.04117372687378199, "start_at": "2026-10-10T00:00:00Z" }, { "popularity": 0.03219741952858018, "start_at": "2026-10-11T00:00:00Z" } ], "view_count": null } }, "thumbnail_url": null, "unknown_fields": [], "url": "https://www.tiktok.com/tag/livecanbeeasy" } ], "page": { "has_more": false, "next_cursor": null, "next_cursor_expires_at": null, "end_reason": "platform_limit" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "tiktok", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 706, "fetched_at": "2026-10-25T12:00:00Z", "input": null, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 2 platforms. The [response reference](https://socialtap.dev/docs/reference/tiktok/trending_hashtags/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/hashtag/index.md). - ### Null means unknown A field TikTok doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### No input needed Every parameter is optional: the plain request returns the default list. - ### Write one parser TikTok and Instagram answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, instagram, …). - **`id`string**: Platform-native hashtag ID (TikTok's challenge ID, Threads' tag ID); on platforms whose public pages key a hashtag by its name (Instagram, YouTube, Facebook, X), the name lowercased. - **`name`string**: The tag without #, as the platform shows it (case kept). Threads tags may contain spaces ("book club"). - **`url`string**: Canonical hashtag page URL (for a multi-word Threads tag, its tag search page). - **`description`string**: The hashtag's description as its page shows it; null when it has none. - **`thumbnail_url`string**: The hashtag's own picture (not one of its posts' images); null when it has none. Platform CDN URLs can expire. - **`metrics`object**: Counts at fetch time; null = hidden or not exposed, 0 = zero. - **`approximate_fields`string\[\]**: JSON paths of values rounded by the platform or parsed from display text ("36M videos": metrics.post_count). \[\] when all exact. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the TikTok Trending Hashtags API. - ### Pick rising hashtags before you post - ### Track which tags lead an industry weekly - ### Compare trending tags across countries ## Good to know before you build. - Logged out, Creative Center shows only the top hashtags of each board and keeps the rest behind its login, so the page ends with page.end_reason platform_limit. Each industry is its own board: read several industries for more tags. - The window is Creative Center's latest published one, not the days up to now, so a board trails today by as long as Creative Center takes to update it. trend\[\].start_at shows which days it covers. - period_post_count and period_view_count count the board's window, not all time, so metrics.post_count and the all-time view_count are null here. - trend\[\] is Creative Center's popularity curve, one point a day, scaled 0 to 1 against the window's peak. - A country Creative Center publishes no board for returns invalid_input naming the countries it does. ## 1 credit per page. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/tiktok/trending_hashtags/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful page | Per 1,000 pages | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the TikTok Trending Hashtags API. More in the [API reference](https://socialtap.dev/docs/reference/tiktok/trending_hashtags/index.md). **How much does the TikTok Trending Hashtags API cost?** A page of up to 20 hashtags costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. **How do I get the next page?** Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours. Other platforms ## Hashtags on 1 more platform. - [Instagram Hashtag API](https://socialtap.dev/apis/instagram/hashtag/index.md) (1 credit · `GET /v1/instagram/hashtag`) More TikTok ## TikTok API. 31 endpoints, one key. - [TikTok Post API](https://socialtap.dev/apis/tiktok/post/index.md) (1 credit · `GET /v1/tiktok/post`) - [TikTok Posts API](https://socialtap.dev/apis/tiktok/posts/index.md) (1 credit / page · `GET /v1/tiktok/posts`) - [TikTok Search API](https://socialtap.dev/apis/tiktok/search_posts/index.md) (1 credit / page · `GET /v1/tiktok/search_posts`) - [TikTok Top Videos API](https://socialtap.dev/apis/tiktok/top_posts/index.md) (1 credit / page · `GET /v1/tiktok/top_posts`) - [TikTok Liked Posts API](https://socialtap.dev/apis/tiktok/liked_posts/index.md) (1 credit / page · `GET /v1/tiktok/liked_posts`) - [TikTok Place Posts API](https://socialtap.dev/apis/tiktok/place_posts/index.md) (1 credit / page · `GET /v1/tiktok/place_posts`) - [TikTok Sound Posts API](https://socialtap.dev/apis/tiktok/sound_posts/index.md) (1 credit / page · `GET /v1/tiktok/sound_posts`) - [TikTok Effect Posts API](https://socialtap.dev/apis/tiktok/effect_posts/index.md) (1 credit / page · `GET /v1/tiktok/effect_posts`) - [TikTok Hashtag Posts API](https://socialtap.dev/apis/tiktok/hashtag_posts/index.md) (1 credit / page · `GET /v1/tiktok/hashtag_posts`) - [TikTok Playlist Posts API](https://socialtap.dev/apis/tiktok/playlist_posts/index.md) (1 credit / page · `GET /v1/tiktok/playlist_posts`) - [TikTok Trending Videos API](https://socialtap.dev/apis/tiktok/trending_posts/index.md) (1 credit / page · `GET /v1/tiktok/trending_posts`) - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [TikTok Followers API](https://socialtap.dev/apis/tiktok/followers/index.md) (1 credit / page · `GET /v1/tiktok/followers`) - [TikTok Following API](https://socialtap.dev/apis/tiktok/following/index.md) (1 credit / page · `GET /v1/tiktok/following`) - [TikTok Comment API](https://socialtap.dev/apis/tiktok/comment/index.md) (1 credit · `GET /v1/tiktok/comment`) - [TikTok Comments API](https://socialtap.dev/apis/tiktok/comments/index.md) (1 credit / page · `GET /v1/tiktok/comments`) - [TikTok Comment Replies API](https://socialtap.dev/apis/tiktok/replies/index.md) (1 credit / page · `GET /v1/tiktok/replies`) - [TikTok Transcript API](https://socialtap.dev/apis/tiktok/transcript/index.md) (From 1 credit · `GET /v1/tiktok/transcript`) - [TikTok Hashtag API](https://socialtap.dev/apis/tiktok/hashtag/index.md) (1 credit · `GET /v1/tiktok/hashtag`) - [TikTok Top Search API](https://socialtap.dev/apis/tiktok/search_top/index.md) (From 1 credit / page · `GET /v1/tiktok/search_top`) - [TikTok User Search API](https://socialtap.dev/apis/tiktok/search_profiles/index.md) (From 1 credit / page · `GET /v1/tiktok/search_profiles`) - [TikTok Sound Search API](https://socialtap.dev/apis/tiktok/search_sounds/index.md) (From 1 credit / page · `GET /v1/tiktok/search_sounds`) - [TikTok Hashtag Search API](https://socialtap.dev/apis/tiktok/search_hashtags/index.md) (From 1 credit / page · `GET /v1/tiktok/search_hashtags`) - [TikTok Playlists API](https://socialtap.dev/apis/tiktok/playlists/index.md) (1 credit / page · `GET /v1/tiktok/playlists`) - [TikTok Engagement API](https://socialtap.dev/apis/tiktok/engagement/index.md) (1 credit · `GET /v1/tiktok/engagement`) - [TikTok Search Suggestions API](https://socialtap.dev/apis/tiktok/search_suggestions/index.md) (1 credit / page · `GET /v1/tiktok/search_suggestions`) - [TikTok Live API](https://socialtap.dev/apis/tiktok/live/index.md) (1 credit · `GET /v1/tiktok/live`) - [TikTok Sound API](https://socialtap.dev/apis/tiktok/sound/index.md) (1 credit · `GET /v1/tiktok/sound`) - [TikTok Download API](https://socialtap.dev/apis/tiktok/download/index.md) (1 credit · `GET /v1/tiktok/download`) - [TikTok Effect API](https://socialtap.dev/apis/tiktok/effect/index.md) (1 credit · `GET /v1/tiktok/effect`) ## See what's on the list right now. Run it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/tiktok/trending_hashtags/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)