REST API Reference

import requests

res = requests.post(
    "https://api.trendsmcp.ai/api",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"mode": "get_time_series", "source": "google search", "keyword": "bitcoin"}
)
res.raise_for_status()
data = res.json()

const res = await fetch("https://api.trendsmcp.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 data = await res.json();

[
  {
    "date":    "2026-03-21",
    "value":   47,
    "volume":  25853617,
    "keyword": "bitcoin",
    "source":  "google search"
  },
  // ... up to 261 weekly data points
]

{
  "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,
      "volume_available": true,
      "recent_volume":    24158298,
      "baseline_volume":  27548936,
      "volume_growth":    -12.31
    }
  ],
  "metadata": {
    "total_data_points":      261,
    "calculations_completed": 1,
    "all_successful":         true
  }
}

{
  "mode":     "get_top_trends",
  "type":     "Google Trends by Category",
  "category": "Games",
  "limit":    10
}

Always pass category for Amazon Best Sellers by Category, Google Trends by Category, Top Websites, Substack by Category, and TikTok Trending Hashtags by Category. Case-insensitive. Official names are listed under Data Sources.

{
  "mode":     "get_top_trends",
  "type":     "Amazon Best Sellers by Category",
  "category": "Toys Games",
  "sort":     "rank_change",
  "window":   "7d",
  "limit":    10
}

sort: "rank_change" answers "what is newly trending" instead of "what is on top": items are ordered by biggest climb versus the baseline snapshot (window "1d", "3d", "7d", "14d", or "30d", the default). Rows are objects, e.g. {"rank": 4, "keyword": "…", "prev_rank": 31, "rank_change": 27}, and the response adds sort, window, and baseline_ts. Works on every feed. If a feed updates too slowly for the window (e.g. monthly Top Websites with "7d"), or the board turned over completely versus the baseline, you get count: 0 plus a note explaining why and what to do next.

{
  "as_of_ts": "2026-03-26T22:22:25Z",
  "type":     "Google Trends",
  "limit":    10,
  "count":    10,
  "data": [
    [1, "chuck norris"],
    [2, "project hail mary"],
    [3, "bachelorette cancelled"]
    // ... [rank, name] pairs
  ]
}