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 Data page

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"}'

More about Google News data

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}'

More about Google News data

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"}'

More about Google News data

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 Data page

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"}'

More about YouTube data

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"}'

More about YouTube data

Wikipedia

Reference

2 Data page

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"}'

More about Wikipedia data

TikTok

Social

6 Data page

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"}'

More about TikTok data

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

Academic ResourcesAnimation and ComicsApparel and AccessoriesArtAutomotiveBaby CareBaby Kids and MaternityBeautyBeauty and Personal CareBeauty ServicesBusiness and FinanceBusiness ServicesCard and Board GamesCareer and Professional GrowthCollegeComedyCommunity Updates and IssuesConventional and Mainstream SportsCookingCrafting and CreationsCultureDanceDiary and VlogDrinksEating ExperiencesEducationEntertainment and Sports NewsEnvironmentExercise and FitnessExtreme and Adventure SportsFamilyFinancial ServicesFoodFood and BeverageFood RecommendationsGadgets and InnovationGamesGeneral TravelHair CareHealthHealth and WellnessHistory and LiteratureHome and GardenHome ImprovementHousehold ProductsLearning and DevelopmentLeisure and Recreation FacilitiesLife ServicesLivestock and FarmingMiscellaneous PerformancesMovies and TVMusicNews and EntertainmentOther BeautyOther FashionOther TransportationOutdoor RecreationOutfitsPerforming ArtsPersonal PhotographyPet Care and AccessoriesPetsPhotographyProductivity and EfficiencyRomanceScienceSensory ExperiencesShows Festivals and ExhibitionsSoftware and AppsSpecial EffectsSportsSports and OutdoorSupernatural and HorrorTechnologyToys Collectibles and MemorabiliaTravelVehicle and TransportationVideo GamesWildlife and Exotic Pets

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.

MCP · get_top_trends

{
  "type": "TikTok Trending Hashtags by Category",
  "category": "History and Literature",
  "country": "US",
  "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": "TikTok Trending Hashtags by Category", "category": "History and Literature", "country": "US", "limit": 10}'

More about TikTok data

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"}'

More about TikTok data

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}'

More about TikTok data

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 Data page

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"}'

More about Steam data

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}'

More about Steam data

Google Play

Apps

3 Data page

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"}'

More about Google Play data

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"}'

More about Google Play data

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}'

More about Google Play data

App Store

Apps

2 Data page

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}'

More about App Store data

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}'

More about App Store data

GitHub

Developer

2 Data page

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}'

More about GitHub data

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"}'

More about GitHub data

Google Trends

Search

2 Data page

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

MCP · get_top_trends

{
  "type": "Google Trends",
  "country": "US",
  "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 Trends", "country": "US", "limit": 10}'

More about Google Trends data

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

Autos and VehiclesBeauty and FashionBusiness and FinanceClimateEntertainmentFood and DrinkGamesHealthHobbies and LeisureJobs and EducationLaw and GovernmentOtherPets and AnimalsPoliticsScienceShoppingSportsTechnologyTravel and Transportation

Google Trending Now topics. There is no Books topic. Matching is case-insensitive.

MCP · get_top_trends

{
  "type": "Google Trends by Category",
  "category": "Games",
  "country": "US",
  "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 Trends by Category", "category": "Games", "country": "US", "limit": 10}'

More about Google Trends data

IMDb

Media

1 Data page

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}'

More about IMDb data

Open Library

Media

1 Data page

Reddit

Social

3 Data page

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}'

More about Reddit data

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}'

More about Reddit data

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"}'

More about Reddit data

Web

1 Data page

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}'

More about Web data

Spotify

Media

1 Data page

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}'

More about Spotify data

Substack

Media

2 Data page

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}'

More about Substack data

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}'

More about Substack data

X

Social

2 Data page

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"}'

More about X data

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"}'

49 data sets from 26 platforms. 5 tools. One key.