Superdemands

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
View by
49 of 49Open a row for parameters and a call to copy

Google

Search

1 Data page
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)
MCP · get_time_series
{
  "keyword": "electric vehicles",
  "source": "Google Search"
}
REST · POST
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"}'
More about Google data

Google Images

Search

1 Data page
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)
MCP · get_time_series
{
  "keyword": "electric vehicles",
  "source": "Google Images"
}
REST · POST
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"}'
More about Google Images data

Google News

News

3
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)
MCP · get_time_series
{
  "keyword": "electric vehicles",
  "source": "Google News"
}
REST · POST
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.
MCP · get_top_trends
{
  "type": "Google News Top News",
  "limit": 10
}
REST · POST
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.
MCP · get_context
{
  "keyword": "nvidia",
  "source": "News"
}
REST · POST
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

1
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)
MCP · get_time_series
{
  "keyword": "running shoes",
  "source": "Google Shopping"
}
REST · POST
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

3
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)
MCP · get_time_series
{
  "keyword": "stanley cup",
  "source": "YouTube"
}
REST · POST
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"}'
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "YouTube"
}
REST · POST
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

2
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
MCP · get_time_series
{
  "keyword": "Bitcoin",
  "source": "Wikipedia"
}
REST · POST
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"}'

TikTok

Social

6
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
MCP · get_time_series
{
  "keyword": "booktok",
  "source": "TikTok"
}
REST · POST
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"}'
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "TikTok"
}
REST · POST
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.
MCP · get_top_posts
{
  "keyword": "booktok",
  "source": "TikTok",
  "limit": 10
}
REST · POST
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

3 Data page
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
MCP · get_time_series
{
  "keyword": "air fryer",
  "source": "Amazon"
}
REST · POST
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"}'
More about Amazon data
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.
MCP · get_top_trends
{
  "type": "Amazon Best Sellers Top Rated",
  "limit": 10
}
REST · POST
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}'
More about Amazon data
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

AppliancesApps & GamesArts, Crafts & SewingAutomotiveBabyBeauty & Personal CareBooksCamera & PhotoClothing, Shoes & JewelryComputers & AccessoriesElectronicsGrocery & Gourmet FoodHandmade ProductsHealth & HouseholdHome & KitchenIndustrial & ScientificKitchen & DiningMusical InstrumentsOffice ProductsPatio, Lawn & GardenPet SuppliesSoftwareSports & OutdoorsTools & Home ImprovementToys & GamesVideo Games
MCP · get_top_trends
{
  "type": "Amazon Best Sellers by Category",
  "category": "Toys Games",
  "limit": 10
}
REST · POST
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}'
More about Amazon data

npm

Developer

1
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
MCP · get_time_series
{
  "keyword": "langchain",
  "source": "npm"
}
REST · POST
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

1
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
MCP · get_time_series
{
  "keyword": "pandas",
  "source": "Python"
}
REST · POST
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

2
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
MCP · get_time_series
{
  "keyword": "Elden Ring",
  "source": "Steam"
}
REST · POST
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.
MCP · get_top_trends
{
  "type": "Steam Most Played",
  "limit": 10
}
REST · POST
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

3
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
MCP · get_time_series
{
  "keyword": "com.openai.chatgpt",
  "source": "App Downloads"
}
REST · POST
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
MCP · get_time_series
{
  "keyword": "com.openai.chatgpt",
  "source": "App Rankings"
}
REST · POST
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.
MCP · get_top_trends
{
  "type": "Google Play",
  "limit": 10
}
REST · POST
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

2
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.
MCP · get_top_trends
{
  "type": "App Store Top Free",
  "limit": 10
}
REST · POST
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.
MCP · get_top_trends
{
  "type": "App Store Top Paid",
  "limit": 10
}
REST · POST
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

2
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.
MCP · get_top_trends
{
  "type": "GitHub",
  "limit": 10
}
REST · POST
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.
MCP · get_context
{
  "keyword": "nvidia",
  "source": "GitHub"
}
REST · POST
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

2 Data page

IMDb

Media

1
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.
MCP · get_top_trends
{
  "type": "IMDb MOVIEmeter",
  "limit": 10
}
REST · POST
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

1

Reddit

Social

3
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.
MCP · get_top_trends
{
  "type": "Reddit Hot Posts",
  "limit": 10
}
REST · POST
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.
MCP · get_top_trends
{
  "type": "Reddit World News",
  "limit": 10
}
REST · POST
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "Reddit"
}
REST · POST
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

1
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

adultarts-and-entertainmentbusiness-and-consumer-servicescommunity-and-societycomputers-electronics-and-technologye-commerce-and-shoppingfinancefood-and-drinkgamblinggameshealthheavy-industry-and-engineeringhobbies-and-leisurehome-and-gardenjobs-and-careerlaw-and-governmentlifestylenews-and-mediapets-and-animalsreference-materialsscience-and-educationsportstravel-and-tourismvehicles

Top-level categories. Subcategories use the parent/child format, e.g. finance/investing. Matching is case-insensitive.

MCP · get_top_trends
{
  "type": "Top Websites",
  "category": "finance",
  "limit": 10
}
REST · POST
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

1
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.
MCP · get_top_trends
{
  "type": "Spotify Top Podcasts",
  "limit": 10
}
REST · POST
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

2
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.
MCP · get_top_trends
{
  "type": "Substack",
  "limit": 10
}
REST · POST
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

Art & IllustrationBusinessClimate & EnvironmentComicsCryptoCultureDesignEducationFaith & SpiritualityFashion & BeautyFictionFilm & TVFinanceFood & DrinkHealth & WellnessHealth PoliticsHistoryHome & GardenHumorInternationalLiteratureMusicNewsParentingPhilosophyScienceSportsTechnologyTravelU.S. PoliticsWorld Politics
MCP · get_top_trends
{
  "type": "Substack by Category",
  "category": "Finance",
  "limit": 10
}
REST · POST
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

2
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "X"
}
REST · POST
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"}'

Instagram

Social

2
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "Instagram"
}
REST · POST
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.
MCP · get_top_posts
{
  "keyword": "booktok",
  "source": "Instagram",
  "limit": 10
}
REST · POST
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

1
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "Bluesky"
}
REST · POST
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

1
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)
MCP · get_context
{
  "keyword": "nvidia",
  "source": "Hacker News"
}
REST · POST
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

1
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.
MCP · get_context
{
  "keyword": "nvidia",
  "source": "Polymarket"
}
REST · POST
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"}'