Nexscope
Start free

Keyword & Search Demand

Google Trends By Keywords MCP Tool

Google Trends keyword search popularity comparison and trend analysis, supporting global regions and custom time ranges. Triggered by: Google Trends, keyword popularity over time, search interest comparison, keyword trend analysis, seasonal trend detection, regional search popularity, keyword heatmap, multi-keyword comparison on Google, keyword research, market trend analysis, search trends, seasonal analysis, regional popularity.

MCP tool name
nexscope_google_trends_by_keywords
Legacy MCP endpoint
/api/skill-api/v1/mcp
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "google-trends-by-keywords-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_google_trends_by_keywords",
    "arguments": {
      "keyword": "phone case",
      "region": "US"
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/google-trends-by-keywords

Arguments

NameTypeRequiredMeaning
keywordstringrequired
Keyword (the keyword must be in the language of the target country! For example, use English keywords for the US, German keywords for Germany. If not in the corresponding country's language, please translate first.) Max length 100 characters
Example: phone case
regionstringoptional
Country/region, default US. Options: US, GB, JP, CA, MX, DE, FR, IT, ES, NL, AU, SG, AE, BR, IN, TR, PL, SE
Example: US
dayRangeStartstringoptional
Time range start (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004
Example: {}
dayRangeEndstringoptional
Time range end (use when you want to freely specify the time range; custom time range takes priority), format YYYY-MM-DD, starting from 2004
Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

NameTypeRequiredDescription
dataanyrequired
Data value used by this API operation.
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
msgstring | nullrequired
Msg value used by this API operation.
tsstringrequired
Epoch milliseconds.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
traceIdstring | nullrequired
Trace id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.trendInfoForKeysarrayoptional
Keyword trend info array
Example: []
data.trendInfoForKeys[].keywordstringoptional
Keyword
Example: phone case
data.trendInfoForKeys[].trendValuesarrayoptional
Trend value array
Example: []
data.trendInfoForKeys[].trendValues[].timeRangestringoptional
Time, format yyyy-MM-dd
Example: null
data.trendInfoForKeys[].trendValues[].valuestringoptional
Value (normalized search interest, 0-100)
Example: null
data.chartOptionobjectoptional
Chart rendering metadata
Example: {}
data.chartOption.typestringoptional
Data type
Example: null
data.chartOption.fieldXstringoptional
X-axis field
Example: null
data.chartOption.fieldYarrayoptional
Y-axis fields
Example: []
data.chartOption.dataarrayoptional
Data
Example: []
data.costTokenintegeroptional
Token consumption
Example: 1
data.typestringoptional
Provider-specific render or payload type.
Example: null
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.costTimeintegeroptional
Execution time reported by the upstream provider.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "keyword": "phone case",
  "region": "US"
}

Example structuredContent

{
  "data": {
    "trendInfoForKeys": [
      {
        "keyword": "phone case",
        "trendValues": []
      }
    ],
    "chartOption": {
      "fieldY": [],
      "data": []
    },
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}