get_top_trends offset and limit pagination

Raise limit up to 200 and page with offset on get_top_trends, then read the count the feed actually returned next to the default 25-row window from the same Trends MCP account.

Live data as of 2026-08-25

get_top_trends pagination on Trends MCP is limit plus offset on one feed type. From the August 25, 2026 pull, Google Trends, Wikipedia Trending, and Spotify Top Podcasts each returned 200 rows at limit 200, then count 0 at offset 200. IMDb MOVIEmeter and App Store Top Free capped at 100 even when limit was 200. YouTube Trending returned 199. Steam Most Played, GitHub Trending Repos, and Reddit Hot Posts returned 25 and empty pages at offset 25. App Store rank 26 was TikTok - Videos, Shop & LIVE, invisible at the default limit of 25. Counter-Strike 2 on steam printed 1,420,896 peak players on 2026-07-01. Free tier access is 100 requests per month.

From the Trends MCP scan of August 25, 2026, raising get_top_trends limit from the default 25 to 200 changed the returned count by feed: 200 for Google Trends, Wikipedia Trending, and Spotify Top Podcasts; 100 for IMDb MOVIEmeter and App Store Top Free; 199 for YouTube Trending; 25 for Steam Most Played.

Shared as_of 2026-08-25T02:01:58 UTC unless noted:

Feedlimit 200 countoffset 25 countoffset past endEnd rank
Google Trends20025 (ranks 26-50)offset 200 count 0200
Wikipedia Trending20025 (ranks 26-50)offset 200 count 0200
Spotify Top Podcasts20025 (ranks 26-50)offset 200 count 0200
YouTube Trending19925 (ranks 26-50)offset 199 count 0199
IMDb MOVIEmeter10025 (ranks 26-50)offset 100 count 0100
App Store Top Free10025 (ranks 26-50)offset 75 still 25100
Steam Most Played25 at limit 250n/a25
GitHub Trending Reposn/a at 200 in this run0n/a25
Reddit Hot Postsn/a at 200 in this run0n/a25

Amazon Best Sellers Top Rated at offset 25 returned 25 rows (ranks 26-50) with as_of 2026-08-24T04:01:39 UTC, a day behind the 02:01:58 cluster. Reddit Hot Posts offset 25 was empty and stamped 2026-08-25T00:01:40 UTC.

IMDb page 2 versus Wikipedia later pages on the same stamp:

IMDb rankTitleWikipedia rank if present
1The Odyssey (2026)4 as The Odyssey (2026 film)
2Spider-Man: Brand New Day (2026)1
3The End of Oak Street (2026)28
5Insidious: Out of the Further (2026)22
11Project Hail Mary (2026)112 as Project Hail Mary (film)
26Spider-Man: No Way Home (2021)150
30Coyote vs. Acme (2026)89
43Awarapan 2 (2026)10
52Niu Lai (2026)68
100The High and the Mighty (1954)148 as The High and the Mighty (film)

App Store Top Free first 12 plus the ranks default limit 25 hides:

RankApp Store Top Free
1ChatGPT
2NBA 2K HQ
37 Brew Coffee
4Vinted: Pre-loved marketplace
5TikTok Pro - Events
13WhatsApp Messenger
17Google Gemini
18Claude by Anthropic
24X
26TikTok - Videos, Shop & LIVE
29Instagram
41YouTube
61Grok AI
80Google Docs

Growth follow-ups attached to paginated ranks:

KeywordSourceWindowRecentChange
Counter-Strike 2steam30D76.3 / 1,420,896 vs 82.0 / 1,573,727 on 2026-06-01-6.95% index, -9.71% volume
Counter-Strike 2steam3M76.3 vs 87.2 / 1,564,830 on 2026-04-01-12.5% index, -9.2% volume
Counter-Strike 2steam6M76.3 vs 95.8 / 1,654,355 on 2026-01-01-20.35% index, -14.11% volume
Counter-Strike 2steam12M76.3 vs 82.3 / 1,427,300 on 2025-07-01-7.29% index, -0.45% volume
com.openai.chatgptapp downloads7D6.9 / 4,975,458 vs 13.5 / 9,825,168 on 2026-08-16-48.89% index, -49.36% volume
com.openai.chatgptapp downloads14D6.9 vs 10.5 / 7,621,945 on 2026-08-09-34.29% index, -34.72% volume
com.openai.chatgptapp downloads30D6.9 vs 8.5 / 6,149,476 on 2026-07-24-18.82% index, -19.09% volume
heroesgoogle search7D100.0 vs 81.0+23.46%
bitcoingoogle search7D34.0 vs 27.0+25.93%
bitcoingoogle searchYTD34.0 vs 36.0 on 2026-01-03-5.56%
insidiousgoogle search7D61.0 vs 19.0+221.05%
Zendayawikipedia30D72.3 / 2,191,805 vs 36.8 / 1,173,776+96.47%

Steam volume is peak players. Counter-Strike 2 at Steam rank 1 carried 1,420,896 peak players on 2026-07-01 across 169 monthly points. ChatGPT at App Store rank 1 is not that Android series; com.openai.chatgpt printed 4,975,458 estimated downloads on 2026-08-24. For the Google board without paging, see the Google Trends Trending Now API.

Exact offset and limit calls

One get_top_trends call takes a single type. Set limit up to 200 and offset to skip rows already seen. On August 25, 2026 a Google Trends call with limit 200 and offset 0 returned ranks 1 through 200 at as_of 2026-08-25T02:01:58 UTC. Offset 200 then returned count 0.

{
  "mode": "get_top_trends",
  "type": "Google Trends",
  "limit": 200,
  "offset": 0
}
{
  "mode": "get_top_trends",
  "type": "IMDb MOVIEmeter",
  "limit": 25,
  "offset": 75
}
{
  "mode": "get_growth",
  "source": "steam",
  "keyword": "Counter-Strike 2",
  "percent_growth": ["30D", "3M", "12M"]
}

IMDb offset 75 returned ranks 76 through 100, ending at The High and the Mighty (1954). Offset 100 returned data: [] and count 0. A limit 50 call on IMDb returned the same ranks 1-50 as offset 0 plus offset 25 concatenated. Prefer one limit 200 call when the feed supports it; paging 25 at a time costs extra units. For the IMDb board itself, see the IMDb MOVIEmeter API.

Feeds that stop at 25 versus 100 versus 200

Feed length is not documented as a single number. IMDb advertised as Top 100 returned count 100 at limit 200. Steam Most Played, GitHub Trending Repos, and Reddit Hot Posts returned count 0 at offset 25. YouTube stopped at 199 rather than 200.

Steam limit 10 returned Counter-Strike 2, Dota 2, FiveM, Bongo Cat, Palworld, Marvel Rivals, How to Fish, PUBG: BATTLEGROUNDS, Tom Clancy's Rainbow Six Siege, and EA SPORTS FC 26. Limit 25 added Rust through Terraria at rank 25. Offset 25 was empty. GitHub Trending Repos offset 25 was empty on the same 02:01:58 stamp.

Wikipedia Trending filled 200 rows, so Zendaya at rank 36, Tom Holland at 45, ChatGPT at 49, and Anne Hathaway at 61 are missing from any default 25-row sample. Spotify Top Podcasts filled 200, with The Joe Rogan Experience at rank 2, Crime Junkie at 3, Huberman Lab at 28, and Lex Fridman Podcast at 99. Offset 50 still returned 25 rows (ranks 51-75). Read count, not the limit argument. For Wikipedia ranks that only appear after offset 25, see the Wikipedia Trending API.

Why default limit 25 hides TikTok on the App Store

App Store Top Free rank 1 was ChatGPT and rank 26 was TikTok - Videos, Shop & LIVE. Default limit 25 therefore omits the main TikTok iOS app while including TikTok Pro - Events at rank 5. Android follow-up on com.openai.chatgpt printed 4,975,458 estimated downloads on 2026-08-24.

Instagram sat at 29, Facebook at 31, YouTube at 41, Reddit at 62, Google Docs at 80, Netflix at 71, and Duolingo at 77. None of those appear in a default 25-row pull. ChatGPT at rank 1 is the iOS chart label; the Android series for com.openai.chatgpt fell 48.89% over 7D from 13.5 / 9,825,168 on 2026-08-16 to 6.9 / 4,975,458 on 2026-08-24, then 18.82% over 30D from 8.5 / 6,149,476 on 2026-07-24. Chart rank and download estimates are different series. For the iOS free chart without paging notes, see the App Store Top Free API.

When labels repeat and as_of lags

Google Trends listed jake lang at rank 44 and again at rank 130 on the same 200-row stamp. Amazon Best Sellers Top Rated lagged to 2026-08-24T04:01:39 UTC and duplicated listing titles at ranks 10 and 11. Reddit Hot Posts used a different as_of than the 02:01:58 cluster.

jake lang Google Search sat at 19.0 on 2026-08-22, up 280.0% from 5.0, and Wikipedia had Jake Lang at rank 18. A unique-token join on the 200-row Google board is therefore 199 names, not 200. Amazon ranks 10 and 11 were both "blink plus plan with monthly auto-renewal". Offset 25 on Amazon still worked (Stanley tumbler at 26 and 27, a second duplicate pair) on that lagged stamp.

Reddit Hot Posts offset 25 returned count 0 with as_of 2026-08-25T00:01:40 UTC, two hours earlier than Google, Wikipedia, IMDb, App Store, Spotify, Steam, YouTube, and GitHub on 2026-08-25T02:01:58 UTC. Do not join Reddit Hot Posts to those boards as a same-minute cut on this pull. For Steam's 25-row live board, see the Steam Most Played API.

Pricing for paginated board pulls

Each get_top_trends call is billed per type and per page, so limit 200 at offset 0 is one unit while eight pages of limit 25 would be eight units. Free covers 100 requests per month. Starter is $19 for 1,000 requests.

Pro is $49 for 5,000. Business is $199 for 25,000. Annual billing saves 20%. Check current pricing on the site before budgeting. A daily job that pulls Google Trends, Wikipedia Trending, IMDb, and App Store at limit 200 uses 4 requests and still sees TikTok at App Store rank 26. Paging those four feeds 25 rows at a time would be 4 times 4 pages on the 100-row feeds plus 8 pages on the 200-row feeds, a much larger bill for the same rows. Extra percent_growth windows inside one get_growth call still count as a single request.

For a same-stamp Wikipedia versus Google join that needs those later pages, see Wikipedia Trending vs Google Trends.

Common questions

Yes on several feeds. Default limit is 25 and max is 200. On August 25, 2026 a Google Trends call with limit 200 returned count 200 at as_of 2026-08-25T02:01:58 UTC. Wikipedia Trending and Spotify Top Podcasts also returned 200. Offset 200 then returned count 0 on those three feeds.
Steam Most Played, GitHub Trending Repos, and Reddit Hot Posts returned count 0 at offset 25 on this pull. Steam with limit 10 returned 10 rows (Counter-Strike 2 at rank 1), and limit 25 returned 25. Asking for limit 200 does not invent extra Steam rows.
No. IMDb MOVIEmeter returned count 100 at limit 200, matching offset 100 returning empty. App Store Top Free also capped at 100. YouTube Trending returned 199. Read the count field instead of assuming the limit you sent.
get_top_trends is counted per feed type and per page. One call with limit 200 and offset 0 is one request. Eight calls of limit 25 would be eight requests. Free covers 100 requests per month. Starter is $19 for 1,000.