REST · one endpoint · three modes

API Reference

Every call is POST https://api.trendsapi.ai/api with a Bearer token. Set mode in the JSON body. Replace YOUR_API_KEY and you should see a 200 in about a minute.

curl -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_time_series","source":"google search","keyword":"bitcoin"}'

import json, requests

res = requests.post(
    "https://api.trendsapi.ai/api",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"mode": "get_time_series", "source": "google search", "keyword": "bitcoin"},
)
payload = res.json()
data = json.loads(payload["body"]) if isinstance(payload.get("body"), str) else payload

const res = await fetch("https://api.trendsapi.ai/api", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ mode: "get_time_series", source: "google search", keyword: "bitcoin" })
});
const payload = await res.json();
const data = typeof payload.body === "string" ? JSON.parse(payload.body) : payload;

If the payload includes statusCode and a string body, parse body once more. Only HTTP 200 counts against quota.

Modes

Pick the operation with mode. Same URL and header every time.

get_trends is accepted as an alias of get_time_series. Prefer get_time_series.

Time series

Weekly history for one source + keyword. Scores are normalized 0-100. About 261 points.

Request body

Response

{
  "mode":    "get_time_series",
  "source":  "google search",
  "keyword": "bitcoin"
}

[
  {
    "date":    "2026-03-21",
    "value":   47,
    "volume":  25853617,
    "keyword": "bitcoin",
    "source":  "google search"
  }
]

Growth

Point-to-point % change for one keyword. Pass presets or custom date pairs. percent_growth defaults to ["12M"]. Comma-separated sources are allowed for comparison.

Request body

Presets

Custom range

{
  "mode":           "get_growth",
  "source":         "google search",
  "keyword":        "bitcoin",
  "percent_growth": ["12M"]
}

{
  "mode":    "get_growth",
  "source":  "amazon",
  "keyword": "nike",
  "percent_growth": [
    { "name": "Last Year", "recent": "2025-12-31", "baseline": "2024-12-31" }
  ]
}

{
  "search_term": "nike",
  "data_source": "google search",
  "results": [
    {
      "period":         "12M",
      "growth":         -12.31,
      "direction":      "decrease",
      "recent_date":    "2026-03-21",
      "baseline_date":  "2025-03-22",
      "recent_value":   57,
      "baseline_value": 65
    }
  ]
}

Top trends

Live ranked leaderboard for one feed. No keyword. type must match a feed label exactly. Omit type on REST to return every feed. Default limit is 25, max 200.

Request body

{
  "mode":  "get_top_trends",
  "type":  "Google Trends",
  "limit": 10
}

{
  "as_of_ts": "2026-03-26T22:22:25Z",
  "type":     "Google Trends",
  "limit":    10,
  "count":    10,
  "data": [
    [1, "chuck norris"],
    [2, "project hail mary"]
  ]
}

Authentication

Get a free key (100 requests/month, no card). Send it on every request:

Authorization: Bearer YOUR_API_KEY

Sources

Keyword sources take source + keyword. Live feeds take type and no keyword. Per-source notes live on /trends.

Keyword sources

Live feeds

What counts as a request

One successful POST is one quota unit, any mode. Failed calls (4xx/5xx) are free. Quotas reset on the first of the month and do not roll over. Hitting the cap returns 429 until you upgrade or the month resets.

Free plan: 100 requests/month. Pricing

Errors

Errors are JSON with error and message. Use message as the operator-facing detail.

{
  "error":   "missing_parameter",
  "message": "The 'keyword' parameter is required."
}

MCP

Same key, same data, from Claude, ChatGPT, Cursor, or VS Code. Endpoint: https://api.trendsapi.ai/mcp.

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