Data catalog
49 data sets from 26 platforms. 5 tools. One key.
Every keyword history, live board and post source the API serves today, with the tool that reads it, the options it takes and a call you can copy. Browse by platform, category, tool or data type, or search.
- Platforms
- 26
- Keyword histories
- 13
- Live boards
- 24
- Top posts
- 2
- Context sources
- 10
- Tools
- 5
Search
Google SearchSearch interest as a 0–100 index, about 5 years Google Search Keyword history get_time_seriesget_growth WeeklyCountryDaily
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Google Search" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
resolution | string | optional | 'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live) |
{
"keyword": "electric vehicles",
"source": "Google Search"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "electric vehicles", "source": "Google Search"}'Google Images
Search
Google ImagesImage search interest as a 0–100 index, about 5 years Google Images Keyword history get_time_seriesget_growth WeeklyCountryDaily
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Google Images" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
resolution | string | optional | 'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live) |
{
"keyword": "electric vehicles",
"source": "Google Images"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "electric vehicles", "source": "Google Images"}'Google News
News
Google NewsNews search interest as a 0–100 index, about 5 years Google News Keyword history get_time_seriesget_growth WeeklyCountryDaily
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Google News" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
resolution | string | optional | 'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live) |
{
"keyword": "electric vehicles",
"source": "Google News"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "electric vehicles", "source": "Google News"}' Google News Top NewsTop news stories Google News Top News Live board get_top_trends Live
Parameters
type | string | required | "Google News Top News" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Google News Top News",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Google News Top News", "limit": 10}' NewsStories grouped by event: headline, outlet, date, outlet count News Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "News" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
{
"keyword": "nvidia",
"source": "News"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "News"}'Google Shopping
Commerce
Google ShoppingShopping search interest as a 0–100 index, about 5 years Google Shopping Keyword history get_time_seriesget_growth WeeklyCountryDaily
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Google Shopping" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
resolution | string | optional | 'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live) |
{
"keyword": "running shoes",
"source": "Google Shopping"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "running shoes", "source": "Google Shopping"}'YouTube
Video
YouTubeYouTube search interest as a 0–100 index, about 5 years YouTube Keyword history get_time_seriesget_growth WeeklyCountryDaily
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "YouTube" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
resolution | string | optional | 'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live) |
{
"keyword": "stanley cup",
"source": "YouTube"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "stanley cup", "source": "YouTube"}' YouTube TrendingTrending videos YouTube Trending Live board get_top_trends DailyCountry
Parameters
type | string | required | "YouTube Trending" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
{
"type": "YouTube Trending",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "YouTube Trending", "country": "US", "limit": 10}' YouTubeVideos: title, channel, views, likes, top comments YouTube Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "YouTube" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "YouTube"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "YouTube"}'Wikipedia
Reference
WikipediaArticle page views as a 0–100 index, plus raw views Wikipedia Keyword history get_time_seriesget_growth MonthlyLanguage
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Wikipedia" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
language | string | optional | Wikipedia language edition (en, de, ja, pt); defaults to en |
{
"keyword": "Bitcoin",
"source": "Wikipedia"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "Bitcoin", "source": "Wikipedia"}' Wikipedia TrendingMost-viewed articles today Wikipedia Trending Live board get_top_trends Daily
Parameters
type | string | required | "Wikipedia Trending" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Wikipedia Trending",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Wikipedia Trending", "limit": 10}'TikTok
Social
TikTokHashtag views as a 0–100 index, plus raw views TikTok Keyword history get_time_seriesget_growth DailyCountry
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "TikTok" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
{
"keyword": "booktok",
"source": "TikTok"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "booktok", "source": "TikTok"}' TikTok Trending HashtagsTrending hashtags TikTok Trending Hashtags Live board get_top_trends DailyCountry
Parameters
type | string | required | "TikTok Trending Hashtags" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
{
"type": "TikTok Trending Hashtags",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "TikTok Trending Hashtags", "country": "US", "limit": 10}' TikTok Trending Hashtags by CategoryTrending hashtags per industry board TikTok Trending Hashtags by Category Live board get_top_trends Daily79 categoriesCountry
Parameters
type | string | required | "TikTok Trending Hashtags by Category" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
category | string | required | One of 79 values, for example History and Literature. |
Categories 79
TikTok Discovery industries (level 1 and 2). There is no Books or Toys label; use History and Literature or Toys Collectibles and Memorabilia. Matching is case-insensitive.
{
"type": "TikTok Trending Hashtags by Category",
"category": "History and Literature",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "TikTok Trending Hashtags by Category", "category": "History and Literature", "country": "US", "limit": 10}' TikTok Trending SearchesTrending search terms TikTok Trending Searches Live board get_top_trends Daily
Parameters
type | string | required | "TikTok Trending Searches" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "TikTok Trending Searches",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "TikTok Trending Searches", "limit": 10}' TikTokVideos: text, views, likes, shares, top comments TikTok Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "TikTok" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "TikTok"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "TikTok"}' TikTok top postsTop videos on a hashtag TikTok Top posts get_top_posts Live
Parameters
keyword | string | required | Hashtag, with or without # |
source | string | required | "TikTok" |
limit | integer | optional | 1 to 20. Default 20. |
{
"keyword": "booktok",
"source": "TikTok",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_posts", "keyword": "booktok", "source": "TikTok", "limit": 10}'Amazon
Commerce
AmazonProduct search volume as a 0–100 index, plus raw volume Amazon Keyword history get_time_seriesget_growth Monthly
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Amazon" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "air fryer",
"source": "Amazon"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "air fryer", "source": "Amazon"}' Amazon Best Sellers Top RatedTop-rated best sellers across all categories Amazon Best Sellers Top Rated Live board get_top_trends Daily
Parameters
type | string | required | "Amazon Best Sellers Top Rated" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Amazon Best Sellers Top Rated",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Amazon Best Sellers Top Rated", "limit": 10}' Amazon Best Sellers by CategoryBest sellers per product category Amazon Best Sellers by Category Live board get_top_trends Daily26 categories
Parameters
type | string | required | "Amazon Best Sellers by Category" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
category | string | required | One of 26 values, for example Toys Games. |
Categories 26
{
"type": "Amazon Best Sellers by Category",
"category": "Toys Games",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Amazon Best Sellers by Category", "category": "Toys Games", "limit": 10}'npm
Developer
npmPackage downloads as a 0–100 index, plus raw downloads npm Keyword history get_time_seriesget_growth Weekly
Parameters
keyword | string | required | Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. |
source | string | required | "npm" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "langchain",
"source": "npm"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "langchain", "source": "npm"}'PyPI
Developer
PythonPackage downloads as a 0–100 index, plus raw downloads Python Keyword history get_time_seriesget_growth Weekly
Parameters
keyword | string | required | Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. |
source | string | required | "Python" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "pandas",
"source": "Python"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "pandas", "source": "Python"}'Steam
Gaming
SteamConcurrent players as a 0–100 index, plus raw players Steam Keyword history get_time_seriesget_growth Monthly
Parameters
keyword | string | required | Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. |
source | string | required | "Steam" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "Elden Ring",
"source": "Steam"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "Elden Ring", "source": "Steam"}' Steam Most PlayedGames by concurrent live players Steam Most Played Live board get_top_trends Live
Parameters
type | string | required | "Steam Most Played" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Steam Most Played",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Steam Most Played", "limit": 10}'Google Play
Apps
App DownloadsAndroid app downloads as a 0–100 index, plus raw downloads App Downloads Keyword history get_time_seriesget_growth Daily
Parameters
keyword | string | required | Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. |
source | string | required | "App Downloads" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "com.openai.chatgpt",
"source": "App Downloads"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "com.openai.chatgpt", "source": "App Downloads"}' App RankingsAndroid chart rank as a 0–100 index, plus raw rank App Rankings Keyword history get_time_seriesget_growth Daily
Parameters
keyword | string | required | Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. |
source | string | required | "App Rankings" |
percent_growth | string[] | optional | Window presets such as 3M, 12M or YTD. Default 12M. get_growth only |
{
"keyword": "com.openai.chatgpt",
"source": "App Rankings"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_time_series", "keyword": "com.openai.chatgpt", "source": "App Rankings"}' Google PlayTop Android apps Google Play Live board get_top_trends Daily
Parameters
type | string | required | "Google Play" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Google Play",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Google Play", "limit": 10}'App Store
Apps
App Store Top FreeTop free iOS apps App Store Top Free Live board get_top_trends Daily
Parameters
type | string | required | "App Store Top Free" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "App Store Top Free",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "App Store Top Free", "limit": 10}' App Store Top PaidTop paid iOS apps App Store Top Paid Live board get_top_trends Daily
Parameters
type | string | required | "App Store Top Paid" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "App Store Top Paid",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "App Store Top Paid", "limit": 10}'GitHub
Developer
GitHubDaily trending repositories GitHub Live board get_top_trends Daily
Parameters
type | string | required | "GitHub" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "GitHub",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "GitHub", "limit": 10}' GitHubActive repositories: stars, forks, language GitHub Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "GitHub" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
{
"keyword": "nvidia",
"source": "GitHub"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "GitHub"}'Google Trends
Search
Google TrendsTrending searches right now Google Trends Live board get_top_trends LiveCountry
Parameters
type | string | required | "Google Trends" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
{
"type": "Google Trends",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Google Trends", "country": "US", "limit": 10}' Google Trends by CategoryTrending searches per topic board Google Trends by Category Live board get_top_trends Live19 categoriesCountry
Parameters
type | string | required | "Google Trends by Category" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
category | string | required | One of 19 values, for example Games. |
Categories 19
Google Trending Now topics. There is no Books topic. Matching is case-insensitive.
{
"type": "Google Trends by Category",
"category": "Games",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Google Trends by Category", "category": "Games", "country": "US", "limit": 10}'IMDb
Media
IMDb MOVIEmeterMost popular movies by user activity IMDb MOVIEmeter Live board get_top_trends Daily
Parameters
type | string | required | "IMDb MOVIEmeter" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "IMDb MOVIEmeter",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "IMDb MOVIEmeter", "limit": 10}'Open Library
Media
Open Library Trending BooksDaily trending books Open Library Trending Books Live board get_top_trends Daily
Parameters
type | string | required | "Open Library Trending Books" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Open Library Trending Books",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Open Library Trending Books", "limit": 10}'Social
Reddit Hot PostsHottest posts on the front page Reddit Hot Posts Live board get_top_trends Live
Parameters
type | string | required | "Reddit Hot Posts" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Reddit Hot Posts",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Reddit Hot Posts", "limit": 10}' Reddit World NewsTop posts in r/worldnews Reddit World News Live board get_top_trends Live
Parameters
type | string | required | "Reddit World News" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Reddit World News",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Reddit World News", "limit": 10}' RedditPosts: title, subreddit, score, top comments Reddit Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Reddit" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "Reddit"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "Reddit"}'Web
Web
Top WebsitesMost-visited websites by traffic rank Top Websites Live board get_top_trends Monthly24 categories
Parameters
type | string | required | "Top Websites" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
category | string | required | One of 24 values, for example finance. |
Categories 24
Top-level categories. Subcategories use the parent/child format, e.g. finance/investing. Matching is case-insensitive.
{
"type": "Top Websites",
"category": "finance",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Top Websites", "category": "finance", "limit": 10}'Spotify
Media
Spotify Top PodcastsTop podcasts Spotify Top Podcasts Live board get_top_trends Daily
Parameters
type | string | required | "Spotify Top Podcasts" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Spotify Top Podcasts",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Spotify Top Podcasts", "limit": 10}'Substack
Media
SubstackTop newsletters overall Substack Live board get_top_trends Daily
Parameters
type | string | required | "Substack" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
{
"type": "Substack",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Substack", "limit": 10}' Substack by CategoryTop newsletters per category Substack by Category Live board get_top_trends Daily31 categories
Parameters
type | string | required | "Substack by Category" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
category | string | required | One of 31 values, for example Finance. |
Categories 31
{
"type": "Substack by Category",
"category": "Finance",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "Substack by Category", "category": "Finance", "limit": 10}'X
Social
X (Twitter) TrendingTrending topics X (Twitter) Trending Live board get_top_trends LiveCountry
Parameters
type | string | required | "X (Twitter) Trending" |
limit | integer | optional | 1 to 200. Default 25. |
offset | integer | optional | Rows to skip. Default 0. |
sort | string | optional | rank (default) or rank_change for climbers. |
window | string | optional | With rank_change: 1d, 3d, 7d, 14d, 30d. Default 30d. |
country | string | optional | ISO 3166-1 alpha-2 country code (US, GB, JP). Boards and TikTok default to US; Google time series and growth default to worldwide |
{
"type": "X (Twitter) Trending",
"country": "US",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_trends", "type": "X (Twitter) Trending", "country": "US", "limit": 10}' XPosts: text, views, likes, reposts, top replies X Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "X" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "X"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "X"}'Social
InstagramReels: caption, plays, likes, top comments Instagram Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Instagram" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "Instagram"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "Instagram"}' Instagram top postsTop posts on a hashtag Instagram Top posts get_top_posts Live
Parameters
keyword | string | required | Hashtag, with or without # |
source | string | required | "Instagram" |
limit | integer | optional | 1 to 20. Default 20. |
{
"keyword": "booktok",
"source": "Instagram",
"limit": 10
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_top_posts", "keyword": "booktok", "source": "Instagram", "limit": 10}'Bluesky
Social
BlueskyPosts: text, likes, reposts, top replies Bluesky Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Bluesky" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "Bluesky"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "Bluesky"}'Hacker News
Developer
Hacker NewsStories: title, points, top comments Hacker News Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Hacker News" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
comments | integer | optional | Top comments or replies for the first N items of each source (0 to 5, default 2) |
{
"keyword": "nvidia",
"source": "Hacker News"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "Hacker News"}'Polymarket
Markets
PolymarketOpen prediction markets: question, odds, volume Polymarket Context get_context Live
Parameters
keyword | string | required | Any name or phrase |
source | string | required | "Polymarket" |
days | integer | optional | Look back 1 to 30 days. Default 7. |
limit | integer | optional | Items per source, 1 to 20. Default 10. |
{
"keyword": "nvidia",
"source": "Polymarket"
}curl https://api.trendsmcp.ai/api \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"mode": "get_context", "keyword": "nvidia", "source": "Polymarket"}'Nothing matches.