# TikTok API: List trending hashtags > Lists publicly visible TikTok Creative Center trending hashtags by country, time period and industry. Anonymous visitors see at most three rows; rank change and new-entry status are not public and come back null. Unofficial. Not affiliated with or endorsed by TikTok. - Page: https://fous.com/methods/ads.tiktok.com/list-trending-hashtags - Method: `ads.tiktok.com/list_trending_hashtags`, version 1 - Website: ads.tiktok.com - Returns: rank, hashtag, posts count, views, hashtag page link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `period` | string | no | `"last_7_days"` | Trend period, for example last_7_days. The site offers 7 and 30 days; 120 days is refused. One of "last_7_days", "last_30_days", "last_120_days". Default "last_7_days". | | `country` | string | no | `"United States"` | Country name or two-letter code, for example United States or FR. Default "United States". | | `industry` | string | no | `"all"` | Industry name, for example Beauty and Personal Care or Food and Beverage; use all for every industry. Default "all". | | `max_results` | integer | no | `20` | Most hashtags to return, for example 20. Anonymous access currently shows at most three. Default 20. | ## Output From a run on Oct 23, 2026. Its input: ```json { "period": "last_7_days", "country": "United States", "industry": "all", "max_results": 20 } ``` Its output: ```json { "hashtags": [ { "rank": 1, "views": 312182870, "hashtag": "#tiktokscaryhorrorcontest", "new_entry": null, "posts_count": 73462, "rank_change": null, "hashtag_page_link": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/7691443554018656263?region=US&period=7" }, { "rank": 2, "views": 24120743, "hashtag": "#marvelrivalsavengers", "new_entry": null, "posts_count": 110088, "rank_change": null, "hashtag_page_link": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/7462773581512966150?region=US&period=7" }, { "rank": 3, "views": 30155625, "hashtag": "#livecanbeeasy", "new_entry": null, "posts_count": 21285, "rank_change": null, "hashtag_page_link": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag/7534678037321744414?region=US&period=7" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"ads.tiktok.com/list_trending_hashtags","input":{"period":"last_7_days","country":"United States","industry":"all","max_results":20}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What hashtags are trending in the United States over the last 7 days? - Show me the top 10 trending TikTok hashtags in France for the past 30 days in Beauty and Personal Care. - Which hashtags are rising in Japan in the last 7 days under Food and Beverage? - List the most viewed trending hashtags across all industries in Brazil for last_30_days, with post counts. - Give me the top 25 trending hashtags in Germany over the past week on tiktok.com, including their hashtag page links. ## Input schema ```json { "type": "object", "properties": { "period": { "enum": [ "last_7_days", "last_30_days", "last_120_days" ], "type": "string", "default": "last_7_days", "description": "Trend period, for example last_7_days. The site offers 7 and 30 days; 120 days is refused." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example United States or FR." }, "industry": { "type": "string", "default": "all", "description": "Industry name, for example Beauty and Personal Care or Food and Beverage; use all for every industry." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Most hashtags to return, for example 20. Anonymous access currently shows at most three." } } } ``` ## Output schema ```json { "type": "object", "required": [ "hashtags" ], "properties": { "hashtags": { "type": "array", "items": { "type": "object", "required": [ "rank", "hashtag", "posts_count", "views", "rank_change", "new_entry", "hashtag_page_link" ], "properties": { "rank": { "type": "integer", "description": "Public list position." }, "views": { "type": [ "integer", "null" ], "description": "Views for the selected period." }, "hashtag": { "type": "string", "description": "Hashtag with #." }, "new_entry": { "type": [ "boolean", "null" ], "description": "Whether this is a new entry; unavailable to anonymous visitors." }, "posts_count": { "type": [ "integer", "null" ], "description": "Posts for the selected period." }, "rank_change": { "type": [ "integer", "null" ], "description": "Change in rank compared with the previous period; unavailable to anonymous visitors." }, "hashtag_page_link": { "type": "string", "description": "TikTok Creative Center hashtag page link." } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [TikTok API: Get video](https://fous.com/methods/tiktok.com/get-video.md): Gets details and engagement statistics for one public TikTok video from its link, including vm.tiktok.com short links: creator, caption, hashtags, posting time, views, likes, comments, shares, length and sound. - [TikTok API: Get profile](https://fous.com/methods/tiktok.com/get-profile.md): Gets a TikTok creator's public profile and totals (followers, following, likes, videos) from a username, @handle or profile link. Profiles not visible to public visitors cannot be returned. - [Google API: List trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines. - [themoviedb.org API: List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md): Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those. - [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days. - [GitHub API: List trending repositories](https://fous.com/methods/github.com/list-trending-repositories.md): Lists up to 25 public repositories trending on GitHub, in page order, optionally filtered by programming language and time period. - [Mastodon API: List hashtag posts](https://fous.com/methods/mastodon.social/list-hashtag-posts.md): Lists the latest public posts for a hashtag on a Mastodon server, newest first. Some servers require login for public timelines. - [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links. - [All TikTok methods](https://fous.com/methods/tiktok.com.md)