google_trends
Returns the Google Trends interest-over-time series for one phrase: one row per point in time
with the interest value (0-100). Use it to see whether demand for a product or a topic grows,
falls or is seasonal, in one country or worldwide. The rows come back in the answer at once;
nothing is saved to the account.
Price: 10 credits per call. Send quote_only=true to get the exact price in money
and the wallet balance without spending anything.
Args:
- query (required): the phrase.
- geo (optional): ISO country code such as US or EE. Omit for worldwide. A name ("Estonia")
is refused - a wrong region would silently answer the worldwide series.
- date (optional): now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m
(default), today 5-y or all.
- idempotency_key (optional): send the same value when you retry; answered and charged once.
- quote_only (optional): true = price only.
Returns:
status DONE with `rows` (text values are wrapped as {type: "scraped", content, origin,
truncated}; numbers are plain), `rowCount`, `costMicros`, `quote`, `walletBalanceMicros`,
`freeRequestsLeft`, `truncated`, `replayed`. With quote_only: status QUOTE and no rows.
Examples:
- Use when: "is interest in e-bikes growing in Germany" -> query "e-bike", geo "DE", date
"today 5-y".
- Use when: checking seasonality before a campaign -> date "today 12-m".
- Don't use when: you want what is trending right now in a country -> not in this list yet.
- Don't use when: you want search results for the phrase -> use google_search.
Error Handling:
- 400 INVALID_QUERY / INVALID_GEO / INVALID_DATE: the named input is wrong; nothing was
charged.
- 402: the wallet has no balance and no free requests.
- 403: the API key is read-only.
- 409 MCP_REQUEST_IN_PROGRESS / IDEMPOTENCY_KEY_REUSED: see idempotency_key.
- 429 MCP_QUICK_BUSY: too many calls at the same moment; wait Retry-After.
- 401 Unauthorized.[runtime hint] This tool returns JSON-as-text — its response shape is dynamic (per-scraper itemsConfig, file binary, etc.) so the MCP outputSchema is omitted. Do not rely on the presence of any specific field in the response; treat the result as a string-or-object blob and parse defensively.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"body": "<body>"
},
"name": "google_trends"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | Google Trends interest over time for one phrase. |