Docs

Trends MCP docs

Live trend data from 27 platforms through 5 tools, over MCP in your AI assistant or the REST API in your code. One key for both.

MCP, sign inhttps://www.trendsmcp.ai/mcpClaude, ChatGPT: sign in, no key to paste
MCP, API keyhttps://api.trendsmcp.ai/mcpCursor, VS Code and other clients
RESTPOST https://api.trendsmcp.ai/apiJSON body with mode

From zero to your first answer

Get a free API key

Email and an 8-digit code. No password, no card. 100 requests a month on Free.

Get my free API key

No credit cardInstant delivery100 free requests/mo

Connect your AI, or call the API

Pick your assistant to add Trends MCP as an MCP server, or copy a request for your code.

MCPIn your AI assistant

Ask Claude, ChatGPT or Cursor about trends in plain language. They fetch the data from Trends MCP for you. No code.

Connect with your Trends MCP account. No API key to copy.

  1. Add the connector below. The name and URL are prefilled.
  2. Sign in to Trends MCP and approve access.
  3. Start a chat with Trends MCP enabled and ask a trend question.
Add to Claude ↗

Using Claude Code? Run this in your terminal, then type /mcp in Claude Code to sign in.

claude mcp add --transport http --scope user trends-mcp https://www.trendsmcp.ai/mcp
Set up manually

In Claude, open Settings → Connectors and add a custom connector named Trends MCP. Enter this URL, then connect and sign in.

https://www.trendsmcp.ai/mcp
Full setup guide →
Test your connection

Once connected, paste this into your AI and check that it uses Trends MCP to fetch results.

Using Trends MCP, what is trending on Google right now?

API key setup / other AI clients

Two addresses, same data. Clients that sign in (Claude, ChatGPT, Claude Code) use https://www.trendsmcp.ai/mcp. Clients that send an API key (Cursor, VS Code, others) use https://api.trendsmcp.ai/mcp with the config below.

{"mcpServers": {"trends-mcp": {"url": "https://api.trendsmcp.ai/mcp","headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}

APIIn your own code

Send requests from Python, JavaScript or any HTTP tool with your API key, and get JSON back.

import requestsresponse = requests.post("https://api.trendsmcp.ai/api",headers={"Authorization": "Bearer YOUR_API_KEY"},json={"mode": "","source": ,"keyword": "artificial intelligence","window": []})print(response.json())

Ask

In your assistant: “How has interest in electric vehicles changed over the last 5 years?” It picks the tool and the source. In code, pick a tool below.

One key for MCP and REST

Send your key in the Authorization header: Bearer YOUR_API_KEY (the bare key works too). Claude and ChatGPT connectors sign in through https://www.trendsmcp.ai/mcp instead, so there is no key to paste.

Keep the key on the server side: never in browser code or a public repository. If it leaks, make a new one on your account page.

Time Series

1 request per source (data type) in the call; 'all' = every keyword source

get_time_series · Full history for one topic.

About five years of weekly history for one keyword on one source, as a 0 to 100 index plus volume where the source has it.

Parameters

NameTypeDescription
mode RESTstringget_time_series. MCP clients call the tool by name instead.
keyword requiredstringFormat depends on the source.
source requiredstringOne source, several separated by commas, or 'all'.
country optionalstringISO 3166-1 alpha-2 country code (US, GB, JP). Boards, TikTok and review stores default to US; Google time series and growth default to worldwide.Works with Google Search, Google Images, Google News, Google Shopping, YouTube, TikTok, Pinterest.
language optionalstringWikipedia language edition (en, de, ja, pt); defaults to en.Works with Wikipedia.
resolution optionalstring'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live).Works with Google Search, Google Images, Google News, Google Shopping, YouTube.
Works with 14 data sourcesSee them all →

Example

curl -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "get_time_series", "keyword": "electric vehicles", "source": "Google Search"}'

Response

A list of points, oldest first (weekly for most sources, daily or monthly for some). About 260 weekly points (5 years) per call.

FieldTypeDescription
datestringISO 8601 date of the point, e.g. 2026-03-21.
valuenumberInterest on a 0 to 100 index.
volumenumber | nullAbsolute volume where the source has it (searches, views, downloads).
keywordstringThe keyword you asked for.
sourcestringThe source used.
Example response (inside body)
[
  {
    "date": "2026-10-17",
    "value": 47,
    "volume": 25853617,
    "keyword": "bitcoin",
    "source": "google search"
  },
  {
    "date": "2026-10-24",
    "value": 52,
    "volume": 28012440,
    "keyword": "bitcoin",
    "source": "google search"
  }
]

Growth

1 request per source (data type) in the call, every window included; 'all' = every keyword source

get_growth · How fast something is rising.

Point-to-point growth over one or more windows, on one source or several in the same call.

Parameters

NameTypeDescription
mode RESTstringget_growth. MCP clients call the tool by name instead.
keyword requiredstringFormat depends on the source.
source requiredstringOne source, several separated by commas, or 'all'.
percent_growth optionalstring[]Window presets such as 3M, 12M or YTD. Default 12M.
country optionalstringISO 3166-1 alpha-2 country code (US, GB, JP). Boards, TikTok and review stores default to US; Google time series and growth default to worldwide.Works with Google Search, Google Images, Google News, Google Shopping, YouTube, TikTok, Pinterest.
language optionalstringWikipedia language edition (en, de, ja, pt); defaults to en.Works with Wikipedia.
resolution optionalstring'weekly' (about 5 years, default) or 'daily' (last 90 days, fetched live).Works with Google Search, Google Images, Google News, Google Shopping, YouTube.

Windows

Any number with D, W, M or Y up to 5 years, plus MTD, QTD and YTD. Default 12M. Common:

7D1W14D2W30D1M2M3M6M9M12M1Y18M24M2Y36M3Y48M4Y60M5YMTDQTDYTD

REST also takes a custom range: an object in percent_growth with

namestringOptional label, returned as period.
recentstringThe more recent date, YYYY-MM-DD.
baselinestringThe date to compare with, YYYY-MM-DD.
Works with 14 data sourcesSee them all →

Example

curl -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "get_growth", "keyword": "electric vehicles", "source": "Google Search", "percent_growth": ["3M", "12M"]}'

Response

One result per window you asked for.

FieldTypeDescription
search_termstringThe keyword you asked for.
data_sourcestringThe source used.
results[].periodstringThe window, e.g. 12M, or your custom name.
results[].growthnumberChange in percent, positive or negative.
results[].directionstringincrease or decrease.
results[].recent_date / baseline_datestringThe two dates compared.
results[].recent_value / baseline_valuenumberThe 0 to 100 index at those dates.
results[].volume_growthnumber | nullChange in absolute volume, where the source has volume.
Example response (inside body)
{
  "search_term": "nike",
  "data_source": "google search",
  "results": [
    {
      "period": "12M",
      "growth": -12.31,
      "direction": "decrease",
      "recent_date": "2026-10-24",
      "baseline_date": "2025-10-25",
      "recent_value": 57,
      "baseline_value": 65,
      "volume_growth": -12.31
    }
  ]
}

Context

1 request per source (data type) in the call; 'all' = every context source

get_context · What people are saying.

What people are posting, reading and betting about a keyword right now: posts, videos, stories, comments and markets from each source, with engagement.

Parameters

NameTypeDescription
mode RESTstringget_context. MCP clients call the tool by name instead.
keyword requiredstringAny name or phrase.
source requiredstringOne source, several separated by commas, or 'all'.
days optionalintegerLook back 1 to 30 days. Default 7.
limit optionalintegerItems per source, 1 to 20. Default 10.
hashtag optionalbooleantrue: the keyword is an exact hashtag; TikTok and Instagram return their top posts for it.
hashtag optionalbooleantrue = the keyword is an exact hashtag: return the platform's own top posts for it (official APIs) instead of a keyword search.Works with TikTok, Instagram.
comments optionalintegerTop comments or replies for the first N items of each source (0 to 5, default 2).Works with YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News.
Works with 10 data sourcesSee them all →

Example

curl -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "get_context", "keyword": "nvidia", "source": "News"}'

Response

Per source, the posts, videos, stories and markets about the keyword, best first.

FieldTypeDescription
keywordstringThe keyword you asked for.
window_daysnumberHow far back it looked.
sources[].sourcestringThe source.
sources[].items[]arrayEach item: kind, url, title, text, author, published, engagement (views, likes, comments, shares, score…), top_comments.
sources[].errorstring | nullWhy a source returned nothing, when it failed.
Example response (inside body)
{
  "keyword": "nintendo switch 2",
  "window_days": 7,
  "count": 1,
  "sources": [
    {
      "source": "YouTube",
      "count": 1,
      "error": null,
      "items": [
        {
          "kind": "video",
          "title": "Switch 2 review",
          "url": "https://youtube.com/watch?v=\u2026",
          "published": "2026-10-22T09:39:22Z",
          "engagement": {
            "views": 91542,
            "likes": 5997,
            "comments": 527
          }
        }
      ]
    }
  ]
}

Reviews

1 request per source (data type) in the call; 'all' = every review source

get_reviews · What customers say.

What customers say about a brand, app, product or place: the matched listing with its all-time rating, then the newest reviews from each source with stars, the company's reply and helpful votes.

Parameters

NameTypeDescription
mode RESTstringget_reviews. MCP clients call the tool by name instead.
keyword requiredstringA brand, app, product or place name.
source requiredstringOne source, several separated by commas, or 'all'.
days optionalintegerLook back 1 to 365 days. Default 90.
limit optionalintegerReviews per source, 1 to 20. Default 10.
country optionalstringISO 3166-1 alpha-2 country code (US, GB, JP). Boards, TikTok and review stores default to US; Google time series and growth default to worldwide.Works with App Store, Google Play, Amazon.
Works with 3 data sourcesSee them all →

Example

curl -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "get_reviews", "keyword": "notion", "source": "App Store"}'

Requests and plans

Every plan has a monthly pool of requests. Only successful calls count: errors are free.

ToolCost
get_time_series1 request per source (data type) in the call; 'all' = every keyword source
get_growth1 request per source (data type) in the call, every window included; 'all' = every keyword source
get_top_trends1 request per 10 rows per board: limit 100 (the default) = 10 requests per board
get_context1 request per source (data type) in the call; 'all' = every context source
get_reviews1 request per source (data type) in the call; 'all' = every review source
get_usageFree. MCP only: your plan, requests used and left, reset date.

Plans

FreeStarterProBusiness
Requests a month1001,0005,00025,000
Keyword alerts–1050250
Top trends rowsFull boardFull boardFull boardFull board

Prices and yearly billing: Pricing. When the monthly pool is used up, calls return a plan-limit message until the next month or an upgrade.

Errors

REST answers HTTP 200 with an envelope: {"statusCode": 400, "body": "…"}. Read statusCode, then parse body. A missing or wrong key is the exception: HTTP 401 (missing_api_key) or 403 (invalid_api_key), with the error object as the body. Errors carry an error code and a message. Over MCP, a failed call sets isError on the tool result.

CodeMeaning
missing_parameterA required field is missing, e.g. type on get_top_trends.
invalid_sourceThe source or type is not one we serve; the message lists the allowed values.
invalid_modeThe mode is not one of the tools.
invalid_requestThe body is malformed or a parameter value is not allowed.
no_dataNothing matched this keyword on this source.
source_unavailableThe upstream source did not answer; try again later.
growth_calculation_failedGrowth could not be computed for that window (e.g. not enough history).
internal_errorUnexpected error. The body has a request_id; send it to support.
missing_api_keyNo key was sent. Send it in the Authorization header as Bearer <key>. REST answers HTTP 401.
invalid_api_keyThe key is mistyped or was regenerated. Get or copy your key on /account. REST answers HTTP 403.
monthly_limit_reachedThe plan's monthly requests are used and there are no credits left. The message has links to buy credits (they never expire) or pick a plan. Over MCP the tool result has isError with the same text. get_usage shows what is left.
Error envelope
{
  "statusCode": 400,
  "body": "{\"error\": \"missing_parameter\", \"message\": \"The 'type' parameter is required\"}"
}