This page is a lookup, not a tutorial. Every source and type string below is a valid value on the Trends API MCP server in this session. Copy the cell. Do not singularize it, drop a space, or change case. The HTTP contract is POST https://api.trendsapi.ai/api with a Bearer key. Modes and the string body envelope are documented on the API reference. Narrative guides for many platforms live under https://trendsapi.ai/trends.
Keyword source strings
Use these values in source on get_time_series and get_growth.
source |
Series | Keyword |
|---|---|---|
google search |
Google search interest | Any name or phrase |
google images |
Google image search | Any name or phrase |
google news |
Google News search | Any name or phrase |
google shopping |
Google Shopping search | Any name or phrase |
youtube |
YouTube search | Any name or phrase |
wikipedia |
Wikipedia page views | Any name or phrase |
tiktok |
TikTok hashtag or topic volume | Any name or phrase |
reddit |
Reddit attention for a name or phrase | Any name or phrase |
amazon |
Amazon product search | Any name or phrase |
news sentiment |
News tone, positive or negative | Any name or phrase |
news volume |
News mention volume | Any name or phrase |
npm |
npm weekly downloads | Exact npmjs.com name, case-sensitive |
python |
PyPI downloads | Exact PyPI project name |
steam |
Steam concurrent players, monthly | Game display name, not an App ID |
app downloads |
Android download series | Android bundle ID |
app rankings |
Android chart rank series | Android bundle ID |
app downloads and app rankings are keyword sources. They are not the live App Store or Google Play boards. Those boards are type values on get_top_trends.
Keyword format rules
Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume) take any name or phrase.
source |
Right | Wrong |
|---|---|---|
npm |
react, @babel/core |
React, React.js |
python |
pandas, requests |
Pandas |
steam |
Elden Ring, CS2 |
a Steam App ID |
app downloads |
com.openai.chatgpt |
ChatGPT, an iOS ID |
app rankings |
com.whatsapp |
WhatsApp |
Find an Android bundle ID in the id= query on play.google.com/store/apps/details. If get_growth mixes app downloads or app rankings with other sources, the keyword must still be that bundle ID.
Live feed type strings
Use these values in type on get_top_trends. No keyword. Labels are case-sensitive, including spaces and punctuation.
type |
Board |
|---|---|
Amazon Best Sellers Top Rated |
Amazon top-rated best sellers |
Amazon Best Sellers by Category |
Amazon best sellers for one category |
App Store Top Free |
iOS App Store free chart |
App Store Top Paid |
iOS App Store paid chart |
GitHub |
Daily trending repositories |
Google News Top News |
Google News top stories |
Google Play |
Google Play top apps |
Google Trends |
Google trending searches |
Google Trends by Category |
Google trending searches for one topic board |
IMDb MOVIEmeter |
IMDb audience-attention movies |
Open Library Trending Books |
Open Library trending books |
Reddit Hot Posts |
Reddit front-page hot posts |
Reddit World News |
r/worldnews |
Top Websites |
Most-visited sites by traffic rank |
Spotify Top Podcasts |
Spotify top podcasts |
Steam Most Played |
Games by live concurrent players |
Substack |
Top Substack newsletters |
Substack by Category |
Substack newsletters for one category |
TikTok Trending Hashtags |
TikTok trending hashtags |
TikTok Trending Searches |
TikTok trending searches |
Wikipedia Trending |
Most-viewed Wikipedia articles |
X (Twitter) Trending |
X trending topics |
YouTube Trending |
YouTube trending videos |
Default sort is current rank. sort rank_change adds prev_rank and rank_change. window then must be 1d, 3d, 7d, 14d, or 30d. Default limit is 25, max 200. offset pages.
On REST, omit type to return every feed. The MCP server requires type.
Feeds that need a category
Always pass category for these four type values. Use the official name. A first pull without category is only for learning those names.
type |
category |
|---|---|
Amazon Best Sellers by Category |
Required |
Google Trends by Category |
Required |
Top Websites |
Required |
Substack by Category |
Required |
Which mode takes which field
| Mode | Required fields | Optional fields |
|---|---|---|
get_time_series |
source, keyword |
none |
get_growth |
source, keyword |
percent_growth (default ["12M"]) |
get_top_trends |
type on MCP |
category, limit, offset, sort, window |
get_trends is accepted on REST as an alias of get_time_series. Prefer get_time_series.
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_time_series","source":"google search","keyword":"bitcoin"}
The HTTP envelope is {"statusCode": int, "body": string}. Parse body before reading points. Growth window presets accepted by the MCP server: 7D, 1W, 14D, 2W, 30D, 1M, 2M, 3M, 6M, 9M, 12M, 1Y, 18M, 24M, 2Y, 36M, 3Y, 48M, 4Y, 60M, 5Y, MTD, QTD, YTD.
Plan names and request caps stay on pricing. Language clients that already encode these strings are listed on Trends API SDKs.