TikTok Trends API — MCP server for Claude Code: hashtag trends
Lets your agent pull hashtag history, growth percentages and a live trending list from TikTok. Handy when you want demand data before committing to a content idea.
claude mcp add --transport http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcpWhat TikTok Trends API does
The server talks to trendsapi.ai and returns three kinds of data: a time series for a keyword, growth over chosen windows, and the current hot hashtag feed. Values in the series are a 0-100 index for that hashtag, not view counts. Growth windows come as presets such as 3M, 12M or YTD, or as custom date pairs. Asking for several windows at once still bills as a single request.
Python and JavaScript clients both exist. Python needs 3.9+ and installs with pip install trendsapi-tiktok; the key goes into TRENDSAPI_KEY. Sync and async clients are available, and you can drop results into pandas with asdict. The JS package is npm install trendsapi-tiktok and runs on Node 18+, Deno, Bun and Workers. One key covers both the SDKs and raw HTTP.
Spelling matters: source must be lowercase (tiktok) while type has to match exactly (TikTok Trending Hashtags). Get either wrong and the call returns 400. Missing TRENDSAPI_KEY gives 401, and a 404 for an unknown keyword is not worth retrying. Publishing videos is out of scope here — this is demand data only.
What it helps with
- chart how interest in a hashtag moved over a year
- compare growth of two topics across windows
- load a series into pandas and average it monthly
- fetch today's hot hashtags
- check demand for a niche before filming
Example prompts for the agent
- Show me the matcha hashtag trend for the last 12 months
- Compare matcha growth over 3M and 12M and tell me the direction
- List the top 10 trending TikTok hashtags
How to install TikTok Trends API
Platform CLI: remote server
claude mcp add --transport http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcpPlatform CLI: remote server
codex mcp add tiktok-trends-api --url https://tiktok.api.trendsapi.ai/mcpConfig file
{
"mcpServers": {
"tiktok-trends-api": {
"url": "https://tiktok.api.trendsapi.ai/mcp"
}
}
}Config file
{
"servers": {
"tiktok-trends-api": {
"type": "http",
"url": "https://tiktok.api.trendsapi.ai/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about TikTok Trends API
How do I install TikTok Trends API in Claude Code?
Run claude mcp add --transport http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcp. The server is then available to your agent.
What does TikTok Trends API do?
It returns hashtag interest history, growth percentages for selected periods, and a live feed of trending TikTok hashtags.
What do I need before using it?
A TRENDSAPI_KEY from trendsapi.ai. The Python client needs Python 3.9+, the JS one needs Node 18+.
