Operators who live in Retool, Bubble, or Make still need trustworthy trend JSON. POST the same body the docs show to https://api.trendsmcp.ai/api and map fields into tables without running a scraper or juggling one key per vendor.
Free API access
Enter your email and we'll send your key instantly. No setup, no configuration.
By continuing you agree to our Terms & Privacy Policy.
Keyword trend reports for clients. Free tier forces us to batch for weekly digests, which turned out fine. Upgrade path exists when we outgrow it.
~20 min to a working mcp hook. json shape is sane, docs match what ships
We pipe weekly series into BigQuery for a few brand cohorts. The old Selenium path was mostly babysitting selectors when Google moved something. This is boring in the best way. Uptime's been solid.
When leadership asks why we're shipping something, these screenshots land. Wish the dashboard had saved views; API's the strong half.
Cursor + MCP, one try. Not a trends person; my side project emails me when a niche term spikes week over week and that's all I wanted.
Multi-source ranked lists into a notebook, straightforward. When I typo a param the error payload is readable. Sounds small. It isn't.
Does what it says. I knocked a star because onboarding assumed I already knew MCP wiring; a copy-paste block for Claude Desktop would have saved me 15 minutes.
tiktok momentum vs paid spend in one looker sheet. unglamorous tbh — first rollout we didn't fight over about halfway through…
Retries: predictable. No random HTML in responses (scrapers, I'm looking at you). Team key rotation would be nice; we rotate keys manually for now.
Meme or real trend? One call usually tells me. Still spot-check Search Console when it matters.
Workshops: how do you ground LLMs in something fresher than training data? I show this. Engineers who hate glue code actually nod at the MCP bit.
Client reporting. Finance finally stopped asking which line item this maps to. Peak hours can drag a little. Acceptable.
I wired this behind a small CLI for contributors who want trend context in issues. Keeping the surface area tiny matters for OSS, and the schema has not churned on me yet.
30-day window, daily pull, internal scoreboard. The screenshot-from-Trends fight in Slack basically ended.
We are pre-revenue, so free tier discipline matters. I hit the cap once during a brainstorm where everyone wanted to try random keywords. Learned to batch smarter.
Security review: HTTPS, scoped keys, no sketchy redirect hops we could find. Sounds basic. It isn't, in this category.
I do not need this daily, but when App Store rank shifts look weird, having Reddit and news context in one place saves me from context switching across six apps.
Blowing up for real vs loud on one platform. Doesn't replace reporting. Keeps my ledes from lying.
playwright job died every time google sneezed. same shape every week now.
Seasonal demand spikes line up with what we see in Amazon search interest here. Merch team stopped sending me screenshots from random tools that never matched.
Decks: fine. I still export to Sheets by hand so minus one star. Direct connector someday maybe.
Steam concurrents plus Reddit chatter in one workflow beats our old spreadsheet ritual before milestone reviews.
Quick pulse on whether a feature name is confusing people in search before we ship copy. Cheap sanity check compared to a full survey.
Monitored from Grafana via a thin wrapper. p95 stayed under our SLO budget last month. One noisy day during a holiday but nothing alarming.
Narrative fights in meetings got shorter once we could point at the same trend line everyone agreed on. Sounds silly until you have lived through it.
Using normalized series as a weak prior in a forecasting experiment. Citation-friendly timestamps in the payload made reproducing runs less painful.
Approved for our pilot group after a quick vendor review. Would love SAML, not a blocker for our size.
YouTube interest + TikTok hashtags in one view. Makes sponsor conversations less hand-wavy. I can point at something.
Cron before standup, Slack gets a blurb. Afternoon to wire. Two quarters without drama.
Public-interest stuff: search interest is a rough attention proxy. I still hit primary sources. One signal among several, not the whole story.
Runs in a VPC egress-only subnet with allowlisted domains. Fewer exceptions to explain to auditors than our last vendor.
Spotting when a topic is about to flood Discord saves my team from reactive moderation fires. Not perfect, but directionally right often enough.
Lean team. ROI isn't subtle. I wouldn't rebuild our old scraper unless legal made us.
Examples in the docs match what the MCP actually returns. You would be surprised how rare that is in this category.
Pager stayed quiet. When something upstream flaked once, the error string told me which parameter to fix without opening logs first.
Students use it for coursework demos. Budget is tight so free tier matters; we coach them to cache aggressively.
Rolled into our internal CLI. On-call hasn't paged for this integration once.
claude reads the json, i fix the content. split workflow that actually works
Mostly lines up with what we hear on weekly sales calls. I still check inventory before I trust it for a buy.
Pulled a trend summary into ChatGPT for ad copy angles. Corny but it saved a two-hour brainstorm.
Client asked for a trend slide Thursday 5pm. This existed so I didn't have to fake it.
Windsurf picked up the MCP manifest without me hand-editing JSON. Small win, I'll take it.
We stopped exporting from five different tools. One chart now goes in the Monday deck and nobody argues about whose export is newer.
Webhook → trend pull → Slack. Boring pipeline. That's the whole compliment.
Copilot suggested a call pattern that matched your error schema. Saved me a round trip to the docs.
Solid API. Dinged for dashboard polish. I'm not an engineer, I live in the UI half the day.
Serde-friendly enough I didn't write a custom deserializer. High praise from a grumpy systems person.
Response sizes stay small enough for mobile hotspots. I hate APIs that dump megabytes for a sparkline.
Almost there. Two quick questions so we can optimize your setup.
What are you working on?
How will you connect?
No code teams win when data arrives as predictable JSON and auth stays boring. Trends MCP exposes exactly that: one HTTPS API, one bearer token, and response shapes that map cleanly to tables, repeaters, and time series charts.
This page is for builders who think in Retool apps, Bubble pages, or stack glue such as Make and Zapier. The mental model matches what Dataslayer and other marketing ops writers describe about fragmented exports, except here the consolidation is on the trend side before the row hits a sheet.
Documentation at https://trendsmcp.ai/docs lists required fields for each operation. Get Trends needs source and keyword. Get Growth adds percent_growth arrays. Get Top Trends sets mode to top_trends and passes a feed type string for MCP; REST can batch feeds when the integration allows.
Responses return arrays of dated points with normalized values where the pipeline supports them, plus optional absolute volume fields depending on source coverage. Top trend calls return ranked rows with positions suitable for simple tables.
Create a REST query resource pointed at https://api.trendsmcp.ai/api. Method POST. Headers include Authorization: Bearer <<token>> and Content-Type: application/json. Body can be JSON with bound text inputs for keyword and source.
Bind the response array to a chart component after a small transformer that casts date strings to dates. Add a second resource for Get Growth when stakeholders ask for explicit percent change labels instead of reading the slope by eye.
Security note: keep tokens in Retool secrets or server side resources. Public apps should never embed a bearer key in client bundles.
Bubble workflows can call the API Connector or a plugin that wraps arbitrary HTTPS. The same JSON bodies apply. Map response fields into custom states, then drive repeating groups for top trends or line charts for series.
Because Bubble pages often face end users, prefer server side scheduling or admin only pages for anything that touches paid tiers. The free tier allowance is published on https://trendsmcp.ai/pricing and should be read before automating wide keyword lists.
Make and Zapier guides already live on site for teams that want scheduled pulls instead of interactive dashboards. Start from https://trendsmcp.ai/make-com-trend-automation or https://trendsmcp.ai/zapier-trend-workflows, then promote stable outputs into Airtable or Sheets if that is where approvals happen. https://trendsmcp.ai/airtable-trends-automation covers the database angle.
Operators who later adopt Cursor or Claude do not need a second vendor. The MCP endpoint and REST endpoint share the documented auth model described in https://www.trendsmcp.ai/llms.txt. That continuity matters when a dashboard prototype graduates into an assistant led workflow owned by engineering.
Trends MCP answers public demand and ranked feed questions. It does not replace finance systems, warehouse inventory, or private ad network reporting. The right dashboard combines internal metrics from those systems with external interest curves from here.
Pick one keyword the business already argues about weekly. Ship a single chart sourced from google search weekly pulls. When that chart matches intuition, add a second panel from TikTok or Amazon for the same phrase so the table tells a fuller story.
Connect
An API key is required to connect. Get your free key above, then copy the pre-filled config for your client.
Or configure manually
Cursor Settings → Tools & MCP → Add a Custom MCP Server
"trends-mcp": { "url": "https://api.trendsmcp.ai/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } }
Mac / Linux — ~/.cursor/mcp.json
Windows — %USERPROFILE%\.cursor\mcp.json
↑ Get your free key above first — the config won't work without it.
Or configure manually
User → Settings → Developer → Edit Config — add inside mcpServers
"trends-mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://api.trendsmcp.ai/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" } }
Mac — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json
Fully quit and restart Claude Desktop after saving.
Claude Code (CLI)
claude mcp add --transport http trends-mcp https://api.trendsmcp.ai/mcp \ --header "Authorization: Bearer YOUR_API_KEY"
Windsurf
Settings → Advanced Settings → Cascade → Add custom server +
"trends-mcp": { "url": "https://api.trendsmcp.ai/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } }
Mac / Linux — ~/.codeium/windsurf/mcp_config.json
Windows — %USERPROFILE%\.codeium\windsurf\mcp_config.json
Or: Command Palette → Windsurf: Configure MCP Servers
VS Code
Extensions sidebar → search @mcp trends-mcp → Install — or paste manually into .vscode/mcp.json inside servers
"trends-mcp": { "type": "http", "url": "https://api.trendsmcp.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } }
Paste into .vscode/mcp.json, or:
Command Palette (⇧⌘P / Ctrl+Shift+P) → MCP: Add Server
See it in action
Watch Claude call TrendsMCP and get back live trend data.
Data Sources
All data is normalized to a 0-100 scale for consistent cross-platform comparison.
Two types of sources are available, accessed via different operations. Keyword sources return a historical time series or growth metric for a specific keyword. Live feeds return the top-ranked items on a platform right now — no keyword needed.
Pass the source value below in your request body alongside keyword.
Scores are normalized to a 0–100 scale where the pipeline supports it.
| source | Description | Keyword format |
|---|---|---|
google search | Google search volume | Any keyword or phrase |
google images | Google image search volume | Any keyword or phrase |
google news | Google News search volume | Any keyword or phrase |
google shopping | Google Shopping search volume | Any keyword or phrase |
youtube | YouTube search volume | Any keyword or phrase |
tiktok | TikTok hashtag volume | Hashtag or topic |
reddit | Subreddit subscribers | Subreddit name only, no r/ prefix |
amazon | Amazon product search volume | Product name or category |
wikipedia | Wikipedia page views | Article title or topic |
news volume | News article mention volume | Any keyword or phrase |
news sentiment | News sentiment score (positive / negative) | Any keyword or phrase |
app downloads | Mobile app download / install estimates (Android track) | Package id or app identifier |
npm | npm package weekly downloads | Exact package name e.g. react |
steam | Steam concurrent players (monthly) | Game display name e.g. Elden Ring |
Pass the type value below with mode: "top_trends". No keyword needed.
Returns the current ranked leaders on that platform (e.g. the top 25 trending hashtags on TikTok right now).
| type | Platform / feed |
|---|---|
Google Trends | Top trending search terms on Google right now |
Google News Top News | Top news stories from Google News |
TikTok Trending Hashtags | Top trending hashtags on TikTok |
YouTube Trending | Top trending videos on YouTube |
X (Twitter) Trending | Top trending topics on X |
Reddit Hot Posts | Hottest posts on Reddit's front page |
Reddit World News | Top posts in r/worldnews |
Wikipedia Trending | Most-viewed Wikipedia articles today |
Amazon Best Sellers Top Rated | Amazon top-rated best sellers across all categories |
Amazon Best Sellers by Category | Amazon best sellers filtered by product category |
App Store Top Free | Top free apps on the iOS App Store |
App Store Top Paid | Top paid apps on the iOS App Store |
Google Play | Top apps on Google Play |
Top Websites | Most-visited websites globally by traffic rank |
Spotify Top Podcasts | Top podcasts on Spotify |
Steam Most Played | Top games by concurrent live players |
GitHub Trending Repos | Daily trending repositories across all languages |
IMDb MOVIEmeter | Top 100 most-popular movies by user activity |
Trending Books | Daily trending books |
Tools
Three tools. Track any keyword through time, measure its growth across sources, or discover what is trending right now. No keyword needed.
source=all
Outputs
FAQ