# TrendsConnector

Last updated: 2026-10-17

> TrendsConnector is an MCP server and REST API for live trend data across search, social, commerce, news, and developer platforms (Google Search/Images/News/Shopping, YouTube, TikTok, Reddit, Amazon, Wikipedia, news volume/sentiment, app downloads/rankings, npm, PyPI (python), Steam, plus 24 live feeds). ~5 years of weekly history where available. One account covers MCP and REST.

Two MCP hosts (not interchangeable):
- `https://api.trendsconnector.com/mcp` — Bearer API key (Cursor, VS Code, Claude Desktop, Claude Code, most clients)
- `https://trendsconnector.com/mcp` — OAuth 2.0 for Claude.ai Connectors only (do not “correct” this to api.)

- REST: `POST https://api.trendsconnector.com/api` with `Authorization: Bearer <key>` (the `Bearer ` prefix is optional; the bare key works too)
- Free: 100 requests/month, no credit card
- Paid: Starter $19/mo (1,000 req), Pro $49/mo (5,000), Business $199/mo (25,000). Annual saves 20%.

## Docs

- [Docs (markdown)](https://trendsconnector.com/docs.md): Agent-readable MCP + API reference
- [OpenAPI spec](https://trendsconnector.com/openapi.json): Machine-readable REST contract (OpenAPI 3.1)
- [MCP & API reference (HTML)](https://trendsconnector.com/docs): Full product documentation
- [Data sources (markdown)](https://trendsconnector.com/data-sources.md): Keyword sources and live feeds
- [Data sources (HTML)](https://trendsconnector.com/data-sources): All keyword sources and live feeds
- [Pricing (markdown)](https://trendsconnector.com/pricing.md): Plans and request limits
- [Get API key](https://trendsconnector.com/account): Free email signup — key sent instantly
- [Homepage](https://trendsconnector.com/): Product overview and connect flow

## MCP tools

Three tools. Human titles and wire names:

| MCP tool name | Title | REST `mode` | What it returns |
| --- | --- | --- | --- |
| `get_time_series` | Get Time Series | `get_time_series` (aliases: `get_trends`, `trends`, `time_series`, `lookup`) | ~5 years weekly series for one source + keyword |
| `get_growth` | Get Growth | `get_growth` (alias: `growth`) | % change over one or more periods |
| `get_top_trends` | Get Top Trends | `get_top_trends` (alias: `top_trends`) | Live ranked feed (no keyword) |

Canonical names match the MCP tools. Prefer `get_time_series` in examples on both REST and MCP. Tools are read-only.

## Get an API key

1. Open [Account](https://trendsconnector.com/account).
2. Enter your email and submit. No credit card, no password.
3. Enter the 8-digit code we email you (subject "Your authentication code").
4. Your key is then revealed on the page; it was also emailed to you (format `tmcp_live_…`).
5. Replace `YOUR_API_KEY` in the client configs below with that key.
6. Use it as `Authorization: Bearer <key>` for REST and for MCP on `api.trendsconnector.com`.

Claude.ai Connectors use OAuth against `www.trendsmcp.ai/mcp` — no API key in that connector config.

## Setup

Primary UI (MCP + REST): [Docs → Connect](https://trendsconnector.com/docs#connect)

### Claude (claude.ai — OAuth connector, recommended)
Uses the **www** OAuth endpoint, not api.
Claude.ai → Settings → Customize → Connectors → Add custom connector
- Name: TrendsConnector
- Server URL: `https://trendsconnector.com/mcp` (OAuth — intentional; different from api.)
Claude handles OAuth automatically — no API key in the connector config.
Deep link: `https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=TrendsConnector&connectorUrl=https%3A%2F%2Fwww.trendsmcp.ai%2Fmcp`
- [MCP setup for Claude](https://trendsconnector.com/for-claude): Desktop, claude.ai connector, and Claude Code

### Claude Desktop
User → Settings → Developer → Edit Config — add inside `mcpServers` (Bearer on **api**)
```json
"trends-mcp": {
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://api.trendsconnector.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
  "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" }
}
```
Mac: `~/Library/Application Support/Claude/claude_desktop_config.json`
Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Fully quit and restart Claude Desktop after saving.

### Claude Code (CLI)
```
claude mcp add --transport http trends-mcp https://api.trendsconnector.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
```

### Cursor
Cursor Settings → Tools & MCP → Add a Custom MCP Server (or use the Add to Cursor deep link on docs)
```json
"trends-mcp": {
  "url": "https://api.trendsconnector.com/mcp",
  "transport": "http",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
```
Mac/Linux: `~/.cursor/mcp.json` — Windows: `%USERPROFILE%\.cursor\mcp.json`
- [MCP setup for Cursor](https://trendsconnector.com/for-cursor)

### Windsurf
Cascade MCP panel → Configure / Add custom server (or Command Palette → `Windsurf: Configure MCP Servers`).
Windsurf remote HTTP uses `serverUrl` (not Cursor’s `url` + `transport`).
```json
"trends-mcp": {
  "serverUrl": "https://api.trendsconnector.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
```
Mac/Linux: `~/.codeium/windsurf/mcp_config.json`
Windows: `%USERPROFILE%\.codeium\windsurf\mcp_config.json`
- [MCP setup for Windsurf](https://trendsconnector.com/for-windsurf)

### VS Code
Use the Add to VS Code install button on docs, or paste into `.vscode/mcp.json` inside `servers` (Command Palette → `MCP: Add Server`):
```json
"trends-mcp": {
  "type": "http",
  "url": "https://api.trendsconnector.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
```
- [MCP setup for VS Code](https://trendsconnector.com/for-vs-code)

### Cline (VS Code extension)
MCP Servers tab → Remote Server → paste URL and header
```json
"trends-mcp": {
  "url": "https://api.trendsconnector.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
```
- [MCP setup for Cline](https://trendsconnector.com/for-cline)

### GitHub Copilot
VS Code Command Palette → MCP: Add Server → paste URL and header
- [MCP setup for GitHub Copilot](https://trendsconnector.com/for-copilot)

### Raycast
Raycast Settings → Extensions → MCP → Add Server → HTTP → paste URL and header
- [MCP setup for Raycast](https://trendsconnector.com/for-raycast)

### ChatGPT (OpenAI)
ChatGPT Settings → Connectors → Add custom connector → paste MCP URL (`https://api.trendsconnector.com/mcp` with your key, or follow the setup page)
- [MCP setup for ChatGPT](https://trendsconnector.com/for-chatgpt)

### n8n
HTTP Request node or MCP Community node → paste URL and Bearer token
- [TrendsConnector with n8n](https://trendsconnector.com/docs)

### Make (Integromat)
HTTP module → POST https://api.trendsconnector.com/api → Authorization: Bearer YOUR_API_KEY
- [TrendsConnector with Make](https://trendsconnector.com/docs)

### Zapier
Webhooks by Zapier → POST https://api.trendsconnector.com/api → Authorization header
- [TrendsConnector with Zapier](https://trendsconnector.com/docs)

### LangChain
```python
from langchain_mcp_adapters.client import MultiServerMCPClient
client = MultiServerMCPClient({"trends-mcp": {"url": "https://api.trendsconnector.com/mcp", "transport": "streamable_http", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}})
```
- [TrendsConnector with LangChain](https://trendsconnector.com/docs)

## Authentication

- REST + most MCP clients: `Authorization: Bearer <key>` against `api.trendsconnector.com` (the `Bearer ` prefix is optional; the bare key works too)
- Claude.ai Connectors: OAuth 2.0 against `www.trendsmcp.ai/mcp` (consent flow; no Bearer key in connector config)
Never expose your API key in client-side code or public repositories.

## Pricing

| Plan | Monthly requests | Price |
| --- | --- | --- |
| Free | 100 / month | $0 |
| Starter | 1,000 / month | $19 / month |
| Pro | 5,000 / month | $49 / month |
| Business | 25,000 / month | $199 / month |

Annual billing saves 20%. Same sources on every plan. Details: [Pricing](https://trendsconnector.com/#pricing)

## What counts as a request

Only successful (2xx) calls count against the monthly quota; failed requests are free.

- `get_trends` / `get_time_series`: 1 source + keyword per call = 1 request
- `get_growth`: 1 source + keyword per call = 1 request (all `percent_growth` periods in that call included)
- `get_top_trends`: MCP costs 1 credit per 10 requested rows (max 10 credits per call); REST is 1 request per call

## Data Sources

### Keyword sources — use with Get Trends & Get Growth

Pass the source value alongside keyword. On REST, set mode to "get_time_series" (time series) or "get_growth" (period-over-period %). Scores use a 0–100 index where the pipeline supports it.

| source          | Description                                | Keyword format                                                |
|-----------------|--------------------------------------------|---------------------------------------------------------------|
| google search   | Google search volume                       | Any keyword or phrase                                         |
| google images   | Google image search volume                 | Any keyword or phrase                                         |
| google news     | Google News search volume                  | Any keyword or phrase                                         |
| google shopping | Google Shopping search volume              | Any keyword or phrase                                         |
| youtube         | YouTube search volume                      | Any keyword or phrase                                         |
| tiktok          | TikTok hashtag volume                      | Hashtag or topic                                              |
| reddit          | Subreddit subscribers                      | Subreddit name only, no r/ prefix                             |
| amazon          | Amazon product search volume               | Product name or category                                      |
| wikipedia       | Wikipedia page views                       | Article title or topic                                        |
| news volume     | News article mention volume                | Any keyword or phrase                                         |
| news sentiment  | News sentiment score (positive / negative) | Any keyword or phrase                                         |
| app downloads   | Android app downloads                      | Android bundle ID e.g. com.openai.chatgpt                     |
| app rankings    | Android app store ranking charts           | Android bundle ID e.g. com.himshers.hims                      |
| npm             | npm package weekly downloads               | Exact package name, case-sensitive e.g. react, @babel/core    |
| steam           | Steam concurrent players (monthly)         | Game display name e.g. Elden Ring (first Steam search result) |
| python          | PyPI project downloads                     | Exact PyPI project name e.g. pandas, requests                 |

### Live feeds — use with Get Top Trends (no keyword needed)

Pass the type value with mode: "get_top_trends". Returns the current ranked leaders on that platform. Feed labels are case-sensitive and must match exactly.

| type                                 | Platform / feed                                     |
|--------------------------------------|-----------------------------------------------------|
| Google Trends                        | Top trending search terms on Google right now       |
| Google Trends by Category            | Google trending searches split by topic board       |
| Google News Top News                 | Top news stories from Google News                   |
| TikTok Trending Hashtags             | Top trending hashtags on TikTok                     |
| TikTok Trending Hashtags by Category | TikTok trending hashtags split by industry board    |
| TikTok Trending Searches             | Top trending search terms on TikTok                 |
| YouTube Trending                     | Top trending videos on YouTube                      |
| X (Twitter) Trending                 | Top trending topics on X                            |
| Reddit Hot Posts                     | Hottest posts on Reddit's front page                |
| Reddit World News                    | Top posts in r/worldnews                            |
| Wikipedia Trending                   | Most-viewed Wikipedia articles today                |
| Amazon Best Sellers Top Rated        | Amazon top-rated best sellers across all categories |
| Amazon Best Sellers by Category      | Amazon best sellers filtered by product category    |
| App Store Top Free                   | Top free apps on the iOS App Store                  |
| App Store Top Paid                   | Top paid apps on the iOS App Store                  |
| Google Play                          | Top apps on Google Play                             |
| Top Websites                         | Most-visited websites globally by traffic rank      |
| Spotify Top Podcasts                 | Top podcasts on Spotify                             |
| Steam Most Played                    | Top games by concurrent live players                |
| Substack                             | Top Substack newsletters overall                    |
| Substack by Category                 | Top Substack newsletters by category                |
| GitHub                               | Daily trending repositories across all languages    |
| IMDb MOVIEmeter                      | Top 100 most-popular movies by user activity        |
| Open Library Trending Books          | Daily trending books from Open Library              |
### Amazon Best Sellers by Category categories
Pass `category` with this type. Official names:
`Appliances`, `Apps Games`, `Arts Crafts Sewing`, `Automotive`, `Baby`, `Beauty Personal Care`, `Books`, `Camera Photo`, `Clothing Shoes Jewelry`, `Computers Accessories`, `Electronics`, `Grocery Gourmet Food`, `Handmade Products`, `Health Household`, `Home Kitchen`, `Industrial Scientific`, `Kitchen Dining`, `Musical Instruments`, `Office Products`, `Patio Lawn Garden`, `Pet Supplies`, `Software`, `Sports Outdoors`, `Tools Home Improvement`, `Toys Games`, `Video Games`

### Google Trends by Category categories
Pass `category` with this type. Official names:
`Autos and Vehicles`, `Beauty and Fashion`, `Business and Finance`, `Climate`, `Entertainment`, `Food and Drink`, `Games`, `Health`, `Hobbies and Leisure`, `Jobs and Education`, `Law and Government`, `Other`, `Pets and Animals`, `Politics`, `Science`, `Shopping`, `Sports`, `Technology`, `Travel and Transportation`

### Top Websites categories
Pass `category` with this type. Official names:
`adult`, `arts-and-entertainment`, `business-and-consumer-services`, `community-and-society`, `computers-electronics-and-technology`, `e-commerce-and-shopping`, `finance`, `food-and-drink`, `gambling`, `games`, `health`, `heavy-industry-and-engineering`, `hobbies-and-leisure`, `home-and-garden`, `jobs-and-career`, `law-and-government`, `lifestyle`, `news-and-media`, `pets-and-animals`, `reference-materials`, `science-and-education`, `sports`, `travel-and-tourism`, `vehicles`

### Substack by Category categories
Pass `category` with this type. Official names:
`Art & Illustration`, `Business`, `Climate & Environment`, `Comics`, `Crypto`, `Culture`, `Design`, `Education`, `Faith & Spirituality`, `Fashion & Beauty`, `Fiction`, `Film & TV`, `Finance`, `Food & Drink`, `Health & Wellness`, `Health Politics`, `History`, `Home & Garden`, `Humor`, `International`, `Literature`, `Music`, `News`, `Parenting`, `Philosophy`, `Science`, `Sports`, `Technology`, `Travel`, `U.S. Politics`, `World Politics`

### TikTok Trending Hashtags by Category categories
Pass `category` with this type. Official names:
`Academic Resources`, `Animation and Comics`, `Apparel and Accessories`, `Art`, `Automotive`, `Baby Care`, `Baby Kids and Maternity`, `Beauty`, `Beauty and Personal Care`, `Beauty Services`, `Business and Finance`, `Business Services`, `Card and Board Games`, `Career and Professional Growth`, `College`, `Comedy`, `Community Updates and Issues`, `Conventional and Mainstream Sports`, `Cooking`, `Crafting and Creations`, `Culture`, `Dance`, `Diary and Vlog`, `Drinks`, `Eating Experiences`, `Education`, `Entertainment and Sports News`, `Environment`, `Exercise and Fitness`, `Extreme and Adventure Sports`, `Family`, `Financial Services`, `Food`, `Food and Beverage`, `Food Recommendations`, `Gadgets and Innovation`, `Games`, `General Travel`, `Hair Care`, `Health`, `Health and Wellness`, `History and Literature`, `Home and Garden`, `Home Improvement`, `Household Products`, `Learning and Development`, `Leisure and Recreation Facilities`, `Life Services`, `Livestock and Farming`, `Miscellaneous Performances`, `Movies and TV`, `Music`, `News and Entertainment`, `Other Beauty`, `Other Fashion`, `Other Transportation`, `Outdoor Recreation`, `Outfits`, `Performing Arts`, `Personal Photography`, `Pet Care and Accessories`, `Pets`, `Photography`, `Productivity and Efficiency`, `Romance`, `Science`, `Sensory Experiences`, `Shows Festivals and Exhibitions`, `Software and Apps`, `Special Effects`, `Sports`, `Sports and Outdoor`, `Supernatural and Horror`, `Technology`, `Toys Collectibles and Memorabilia`, `Travel`, `Vehicle and Transportation`, `Video Games`, `Wildlife and Exotic Pets`


## API Reference

All requests go to POST https://api.trendsconnector.com/api. Pick the operation with the mode field in the JSON body:

| mode               | What it returns                         | Required fields                                              |
|--------------------|-----------------------------------------|--------------------------------------------------------------|
| get_time_series    | ~5 years of weekly points for a keyword | source, keyword                                              |
| get_growth         | % change over one or more periods       | source, keyword (percent_growth optional, defaults to ["12M"]) |
| get_top_trends     | Live ranked leaderboard for a feed      | type (limit, category, sort, window, country optional)       |

Canonical mode names match the MCP tools. Aliases: get_trends, trends, time_series, and lookup all mean get_time_series; growth means get_growth; top_trends means get_top_trends. Prefer the canonical names everywhere.

### get_time_series (REST + MCP)

Returns a full historical time series for a keyword from a single source. Approximately 5 years of weekly data. Specify one source per request.

Request body:
- mode (string, required): "get_time_series" (aliases: "get_trends", "trends", "time_series", "lookup")
- source (string, required): one source per request
- keyword (string, required)

Response fields (array of data points):
- date (string): ISO 8601 e.g. "2026-03-21"
- value (number): trend score 0–100
- volume (number|null): absolute volume where available
- keyword (string)
- source (string)

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

### get_growth (MCP + REST)

Calculates point-to-point percentage growth over one or more time windows. Supports window strings or, on REST only, exact custom date pairs. Pass one source or a comma-separated list (e.g. "amazon, tiktok, youtube"). One request per source + keyword regardless of how many periods are in percent_growth.

Request body:
- mode (string, required): "get_growth" (alias: "growth")
- source (string, required): one source or comma-separated list
- keyword (string, required)
- percent_growth (array, optional): window strings or, on REST only, custom date objects; defaults to ["12M"]. window is accepted as a REST alias.

Growth windows: any whole number plus a D, W, M, or Y suffix, up to 5 years (e.g. 7D, 17D, 45D, 3M, 18M, 2Y), plus MTD, QTD, and YTD. Common examples: 7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD

Custom date range object (REST only; MCP accepts the string windows): {"name": "optional label", "recent": "YYYY-MM-DD", "baseline": "YYYY-MM-DD"}

Response fields:
- search_term, data_source
- results (array, one per period): period, growth (%), direction, recent_date, baseline_date, recent_value, baseline_value, volume_available, recent_volume, baseline_volume, volume_growth
- metadata: total_data_points, calculations_completed, all_successful

Example:
```json
{"mode": "get_growth", "source": "google search", "keyword": "nike", "percent_growth": ["12M", "3M", "YTD"]}
```
```json
{
  "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}
}
```

### get_top_trends (MCP + REST)

Returns ranked items from live platform feeds. type is required on both REST and MCP (one feed per call); omitting it returns a 400 missing_parameter error.

Request body:
- mode (string, required): "get_top_trends" (alias: "top_trends")
- type (string, required): feed name — required on both REST and MCP
- category (string): required 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 on /data-sources.
- sort (string, optional): "rank" (default) returns the current board; "rank_change" returns the biggest climbers vs a baseline snapshot
- window (string, optional, only with sort="rank_change"): "1d", "3d", "7d", "14d", or "30d" (default). Short windows only have baselines on daily feeds; slower feeds return a note pointing to a longer window
- country (string, optional): ISO 3166-1 alpha-2 (US, GB, JP). Aliases like USA or United States resolve to US. Omit for the default US board. Only for Google Trends, Google Trends by Category, YouTube Trending, TikTok Trending Hashtags, TikTok Trending Hashtags by Category, and X (Twitter) Trending. If that board is not in the database yet, the handler fetches it live.
- limit (integer, default 25): max items per feed, up to 200. Free plan boards return the top 10 only.
- offset (integer, default 0): pagination. Pinned to 0 on the Free plan; pagination is a paid feature.

Example:
```json
{"mode": "get_top_trends", "type": "Google Trends", "limit": 10}
{"mode": "get_top_trends", "type": "Google Trends by Category", "category": "Games", "limit": 10}
```
```json
{"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"]]}
```

Example (biggest climbers this week in one Amazon category):
```json
{"mode": "get_top_trends", "type": "Amazon Best Sellers by Category", "category": "Toys Games", "sort": "rank_change", "window": "7d", "limit": 10}
```
```json
{"as_of_ts": "2026-08-24T04:00:00Z", "baseline_ts": "2026-08-17T04:00:00Z",
 "type": "Amazon Best Sellers by Category", "category": "Toys Games",
 "sort": "rank_change", "window": "7d", "limit": 10, "count": 10,
 "data": [{"rank": 4, "keyword": "example toy", "prev_rank": 31, "rank_change": 27, "category_path": "Toys Games"}]}
```

With sort="rank_change", rows are objects with rank, keyword, prev_rank, and rank_change (positions climbed). If the feed has no baseline snapshot within tolerance of the requested window (e.g. monthly Top Websites with "7d"), or the board turned over completely versus the baseline, the response returns count 0 with a note explaining why and what to do next.

## MCP Prompts — Example AI queries

Always include "using TrendsConnector" or "via TrendsConnector" so the AI routes to the MCP instead of a web search.

Get Time Series:
- "Using TrendsConnector, show me the Google Search trend for nvidia over the past 5 years."
- "Via TrendsConnector, show me the download trend for Android app com.openai.chatgpt."
- "Using TrendsConnector, show me the YouTube and TikTok trend history for Stanley cup."
- "Via TrendsConnector, get the Wikipedia page view history for Bitcoin weekly."
- "Using TrendsConnector, show me the Amazon search trend for air fryer over 5 years."
- "Via TrendsConnector, pull the npm download trend for langchain weekly."
- "Using TrendsConnector, show me Steam concurrent player data for Elden Ring."
- "Via TrendsConnector, show the news volume trend for Tesla over the last year."
- "Using TrendsConnector, show subscriber history for subreddit wallstreetbets on Reddit."

Get Growth:
- "Using TrendsConnector, how has Google Search interest in GLP-1 grown over the past 12 months?"
- "Via TrendsConnector, show me 3M, 6M, and 1Y growth for Anthropic on Google Search."
- "Using TrendsConnector, what's the YTD Google Search growth for Duolingo?"
- "Via TrendsConnector, compare 6-month growth for weight loss drugs across Google, TikTok, and Amazon."
- "Using TrendsConnector, how has news sentiment for Meta changed over the past 6 months?"
- "Via TrendsConnector, show Google Search growth for AI agents from Jan 2025 to Jan 2026."
- "Via TrendsConnector, show me 12M Google Shopping growth for running shoes."

Get Top Trends:
- "Using TrendsConnector, what's trending on Google right now?"
- "Via TrendsConnector, show me the top TikTok trending hashtags today."
- "Using TrendsConnector, what are the hottest Reddit posts right now?"
- "Via TrendsConnector, what are the top trending Wikipedia articles today?"
- "Using TrendsConnector, show me what's trending on X right now."
- "Via TrendsConnector, what apps are topping the App Store Free charts today?"
- "Using TrendsConnector, what are the top-rated Amazon best sellers right now?"
- "Via TrendsConnector, show Amazon best sellers for category Electronics."
- "Using TrendsConnector, what are the fastest-climbing Amazon best sellers in Toys Games this week?"
- "Via TrendsConnector, what's trending on YouTube right now?"

## Errors

The REST transport always returns HTTP 200. The real outcome is in the payload envelope: {"statusCode": <int>, "body": <json string>}. Check statusCode, then parse body. Error bodies carry one of these codes:

| Error code               | Meaning                                                                  |
|--------------------------|--------------------------------------------------------------------------|
| missing_parameter        | Required field missing from the request body (e.g. type on get_top_trends) |
| invalid_source           | Unrecognized source value                                                |
| invalid_mode             | Unrecognized mode value                                                  |
| invalid_request          | Malformed body or invalid parameter combination                          |
| no_data                  | No data matched this keyword/source                                      |
| source_unavailable       | The upstream source could not be reached; retry later                    |
| growth_calculation_failed | Growth could not be computed for the requested window                   |
| internal_error           | Unexpected server error; the body includes a request_id to quote when contacting support |

On MCP, tool failures set isError=true on the tool result.

Error envelope: {"statusCode": 400, "body": "{"error": "missing_parameter", "message": "The 'type' parameter is required"}"}

## Key pages

- [Homepage](https://trendsconnector.com/): Connect your AI to live trend data
- [All connectors](https://trendsconnector.com/connectors): Every source and AI client on this door
- [About](https://trendsconnector.com/about): Who runs this product and how to reach a human
- [Docs](https://trendsconnector.com/docs): Full MCP and API reference
- [Docs (markdown)](https://trendsconnector.com/docs.md): Agent-readable docs mirror
- [Data sources](https://trendsconnector.com/data-sources): All supported data sources
- [Data sources (markdown)](https://trendsconnector.com/data-sources.md): Sources and feeds table
- [Pricing](https://trendsconnector.com/#pricing): Free, Starter, Pro, and Business plans
- [Pricing (markdown)](https://trendsconnector.com/pricing.md): Plans and limits
- [Account](https://trendsconnector.com/account): Get your free API key
- [Sitemap](https://trendsconnector.com/sitemap.xml): Current pages
- [llms.txt](https://trendsconnector.com/llms.txt): Full agent guide
- [llms-full.txt](https://trendsconnector.com/llms-full.txt): Alias of llms.txt

### Client setup pages

- [Claude](https://trendsconnector.com/for-claude): TrendsConnector setup for Claude
- [ChatGPT](https://trendsconnector.com/for-chatgpt): TrendsConnector setup for ChatGPT
- [Perplexity](https://trendsconnector.com/for-perplexity): TrendsConnector setup for Perplexity
- [Gemini](https://trendsconnector.com/for-gemini): TrendsConnector setup for Gemini
- [Grok](https://trendsconnector.com/for-grok): TrendsConnector setup for Grok
- [Grok Bot](https://trendsconnector.com/for-grok-bot): TrendsConnector setup for Grok Bot
- [Muse](https://trendsconnector.com/for-muse): TrendsConnector setup for Muse
- [Cursor](https://trendsconnector.com/for-cursor): TrendsConnector setup for Cursor
- [VS Code](https://trendsconnector.com/for-vs-code): TrendsConnector setup for VS Code
- [GitHub Copilot](https://trendsconnector.com/for-copilot): TrendsConnector setup for GitHub Copilot
- [Windsurf](https://trendsconnector.com/for-windsurf): TrendsConnector setup for Windsurf
- [Cline](https://trendsconnector.com/for-cline): TrendsConnector setup for Cline
- [Roo Code](https://trendsconnector.com/for-roo-code): TrendsConnector setup for Roo Code
- [Claude Code](https://trendsconnector.com/for-claude-code): TrendsConnector setup for Claude Code
- [Codex](https://trendsconnector.com/for-codex): TrendsConnector setup for Codex
- [Kiro](https://trendsconnector.com/for-kiro): TrendsConnector setup for Kiro
- [Replit](https://trendsconnector.com/for-replit): TrendsConnector setup for Replit
- [JetBrains](https://trendsconnector.com/for-jetbrains): TrendsConnector setup for JetBrains
- [Zed](https://trendsconnector.com/for-zed): TrendsConnector setup for Zed
- [Warp](https://trendsconnector.com/for-warp): TrendsConnector setup for Warp
- [Raycast](https://trendsconnector.com/for-raycast): TrendsConnector setup for Raycast
- [Continue](https://trendsconnector.com/for-continue): TrendsConnector setup for Continue
- [Amazon Q](https://trendsconnector.com/for-amazon-q): TrendsConnector setup for Amazon Q
- [Trae](https://trendsconnector.com/for-trae): TrendsConnector setup for Trae
- [Augment](https://trendsconnector.com/for-augment): TrendsConnector setup for Augment

## Optional

- [Terms of Service](https://trendsconnector.com/terms)
- [Privacy Policy](https://trendsconnector.com/privacy)

- [Google Trends](https://trendsconnector.com/google-trends-connector): Search volume
- [Google Shopping](https://trendsconnector.com/google-shopping-connector): Shopping search
- [YouTube](https://trendsconnector.com/youtube-connector): Search volume
- [TikTok](https://trendsconnector.com/tiktok-connector): Hashtag volume
- [Reddit](https://trendsconnector.com/reddit-connector): Subscribers
- [Amazon](https://trendsconnector.com/amazon-connector): Product search
- [Wikipedia](https://trendsconnector.com/wikipedia-connector): Page views
- [News](https://trendsconnector.com/news-connector): Volume and sentiment
- [Web Traffic](https://trendsconnector.com/web-traffic-connector): Site visits
- [App Downloads](https://trendsconnector.com/app-downloads-connector): Android installs
- [App Store](https://trendsconnector.com/app-store-connector): iOS rankings
- [Steam](https://trendsconnector.com/steam-connector): Players
- [npm](https://trendsconnector.com/npm-connector): Downloads
- [PyPI](https://trendsconnector.com/pypi-connector): Downloads
- [X](https://trendsconnector.com/x-connector): Trending topics
- [Spotify](https://trendsconnector.com/spotify-connector): Podcasts
- [GitHub](https://trendsconnector.com/github-connector): Repositories
- [IMDb](https://trendsconnector.com/imdb-connector): Movies
- [Open Library](https://trendsconnector.com/open-library-connector): Books
- [Substack](https://trendsconnector.com/substack-connector): Newsletters