X (Twitter) Trends API
Server Details
X trending topics and discussion volume over time. Free key at trendsapi.ai
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-03-26
- URL
- Repository
- trendsapi-ai/trends-mcp
- GitHub Stars
- 0
- Server Listing
- trend-feeds
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 6 tools
Each tool targets a distinct output shape: live boards (get_top_trends), qualitative conversation (get_context), reviews (get_reviews), growth deltas (get_growth), full series (get_time_series), and account quota (get_usage). The only real overlap is get_growth vs get_time_series, but the descriptions explicitly cross-reference each other and state which to pick ('for charting or custom math, get_time_series'). That resolves the boundary well enough to avoid misselection.
Every tool follows the identical pattern: trends___get_<noun> (context, growth, reviews, time_series, top_trends, usage). Single consistent verb, consistent namespace prefix, consistent snake_case for multi-word nouns. Fully predictable.
Six tools is well within the ideal range and each maps to a genuinely different query type an agent would ask for. There is no filler: even get_usage earns its place as the quota/rate-limit recovery path referenced by every other tool.
Core data retrieval is covered (trends, series, growth, context, reviews, usage), but there is no tool to enumerate the valid inputs that nearly every other tool requires — the list of sources, boards, and the full set of preset periods ('the other listed periods'), leaving the agent to guess and burn charged requests on invalid combinations. There is also no keyword/search discovery tool to find valid keywords before querying. These are notable gaps rather than fatal ones, since descriptions do partially enumerate values.
Available Tools
6 toolstrends___get_contextARead-onlyIdempotentInspect
What people are posting, reading and betting about a keyword right now, or with hashtag=true the top TikTok and Instagram posts on one hashtag. Returns recent posts, videos, news stories, discussions and prediction markets per source, with engagement (views, likes, score) and top comments. Use it to explain why something is trending or what the conversation says; get_time_series and get_growth measure how much. Costs 1 request per data type (source or board) in the call; boards cost 1 request per 10 rows. Only data types that answer are charged; the answer says requests_charged. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.
Inputs: source (required), keyword (required), days, limit, +2 more.
trends___get_growthARead-onlyIdempotentInspect
Point-to-point growth for a keyword on one or more sources. Each window is a preset string (12M, 3M, YTD, and the other listed periods). Values are on a 0-100 scale, plus absolute volume when available. Designed for growth questions; for charting or custom math, get_time_series provides the full series. App Downloads and App Rankings are keyword sources (Android bundle ID). They are not the App Store / Google Play live boards on get_top_trends. Costs 1 request per data type (source or board) in the call; boards cost 1 request per 10 rows. Only data types that answer are charged; the answer says requests_charged. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.
Inputs: source (required), keyword (required), country, language, +2 more.
trends___get_reviewsAInspect
What customers say about a brand, app, product or place. Returns, per source, the matched listing with its all-time rating and review count, the newest reviews (stars, text, the company's reply) and a summary (average stars, star counts, share negative, share replied). Use it for brand sentiment and complaints; get_context covers social posts. Costs 1 request per data type (source or board) in the call; boards cost 1 request per 10 rows. Only data types that answer are charged; the answer says requests_charged. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.
Inputs: source (required), keyword (required), days, limit, +1 more.
trends___get_time_seriesARead-onlyIdempotentInspect
Full historical series for one keyword on one or more sources (0-100 values, plus volume when available). Suited for charting or custom math. Live 'what's trending now' boards are on get_top_trends. get_growth answers most growth questions with less data. Costs 1 request per data type (source or board) in the call; boards cost 1 request per 10 rows. Only data types that answer are charged; the answer says requests_charged. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.
Inputs: source (required), keyword (required), country, language, +1 more.
trends___get_top_trendsARead-onlyIdempotentInspect
Live top-trending boards: one feed type, several, or 'all'. No keyword. For 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Pinterest Trending by Category', 'Top Websites', 'Substack by Category', and 'TikTok Trending Hashtags by Category', category selects the board. Default sort is current rank. Use sort='rank_change' for climbers vs a prior snapshot (window 1d, 3d, 7d, 14d, or 30d). If the requested board is not in the database yet (for example a country that is not collected on the schedule), the board is fetched live. App Store Top Free, App Store Top Paid, and Google Play are live store boards, not keyword lookups. App history is available via get_growth or get_time_series with source App Downloads or App Rankings and an Android bundle ID. Live boards are only available here, not via get_time_series. Costs 1 request per data type (source or board) in the call; boards cost 1 request per 10 rows. Only data types that answer are charged; the answer says requests_charged. Returns a plan-limit message when the request is rate limited or the monthly quota is used up.
Inputs: type (required), sort, limit, offset, +3 more.
trends___get_usageARead-onlyIdempotentInspect
Shows your plan, requests used this month, requests left, and when it resets. Free: does not use a request. Call it when the user asks about their limit or after a limit error.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Twitter (X) trends over time, with growth for any keyword. Free key at trendsmcp.ai
YouTube search volume and trending videos over time. Free key at trendsapi.ai
News article mention volume trends for any topic. Free key at trendsapi.ai
Reddit discussion volume and subreddit growth over time. Free key at trendsapi.ai
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceRead-only X research for AI agents: search posts, track JST trends, compare topics, inspect coverage, and export reports.MIT
- AlicenseNot gradedqualityCmaintenanceProvides Reddit discussion volume trends, growth rates, and top trending topics for any keyword, accessible via MCP tools and Python client.1MIT
- AlicenseAqualityCmaintenanceLive trend data for your AI. 25+ platforms. One connection.348MIT
- AlicenseNot gradedqualityDmaintenanceReal-time X/Twitter social intelligence for AI agents and developers, powered by Grok's live search capabilities.3MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.