get_top_trends is the board mode. Send mode get_top_trends and a type string from the MCP feed list. Do not send keyword. The HTTP call is POST https://api.trendsapi.ai/api with a Bearer key. Parse the string body. The inner object is a snapshot, not a time series. Feed labels sit on the sources reference. Official docs: the API reference.
No keyword
POST https://api.trendsapi.ai/api
Authorization: Bearer <api_key>
Content-Type: application/json
{"mode":"get_top_trends","type":"Google Trends","limit":10}
Google Trends is a live type. google search is a keyword source. They are not interchangeable. Other live labels include YouTube Trending, TikTok Trending Hashtags, TikTok Trending Searches, and Steam Most Played. Copy the cell.
Optional fields: limit (default 25, max 200), offset (default 0), sort (rank or rank_change), window (only with rank_change), and category on four types. Pagination is on feed pagination. Climbers are on rank_change sort.
The board object
After the second parse:
| Field | Meaning |
|---|---|
as_of_ts |
Snapshot time |
type |
The feed that was asked for |
limit / offset / count |
Page size, skip, and rows returned |
data |
Default [rank, label] rows |
sort rank_change returns objects with rank, keyword, prev_rank, and rank_change. Default sort is current rank.
On REST, omit type to ask for every feed. The MCP tool in this session still requires type.
Store charts versus keyword sources
App Store Top Free, App Store Top Paid, and Google Play are boards on this mode. They are not source app downloads or app rankings. Those two sources take an Android bundle ID on get_growth or get_time_series.
Four types need category or they mix every board. That list is on category feeds. Caps stay on pricing.