Amazon Trends API

Official3 toolsLive

by trendsapi-ai · Python

Amazon product search volume and best-seller trends. Free key at trendsapi.ai

ai.trendsapi/amazon MCP Server

This Model Context Protocol (MCP) server provides Amazon product-search demand data, including search interest and bestseller feeds via the Trends API. It is positioned for ecommerce and product research without scrapers, with a free key available at trendsapi.ai.

🛠️ Key Features

Amazon search volume and best-seller trends
Trends API feeds for ecommerce research
3 tools exposed by the server

🚀 Use Cases

Product-research and market-research based on Amazon demand signals
Time-series trend-data analysis for shopping trends
Alternative-data workflows using JSON/REST API sources

⚡ Developer Benefits

Supports MCP integration with topic coverage for trends and search-volume data
Fits REST API and HTTP-contract consumption patterns
Language ecosystems referenced: Python and JavaScript

⚠️ Limitations

Requires an API key from trendsapi.ai (“trendsapi.ai/#get-key” is referenced)
Described as “Amazon product-search demand”; other data sources are not indicated

Topics

alternative-dataamazonamazon-apiamazon-best-sellersecommercejavascriptjson-apimarket-researchno-scrapingproduct-researchpythonrest-apisearch-volumeshopping-trendstime-seriestrend-datatrends-apimcpmcp-servermodel-context-protocol

Captured live from the server via tools/list.

trends___get_growth

Point-to-point growth for a keyword on one or more sources. Each window is a preset string (12M, 3M, YTD, and the other listed periods). Values are on a 0-100 scale, plus absolute volume when available. Prefer this over get_time_series for growth questions. app downloads and app rankings are keyword sources (Android bundle ID). They are not the App Store / Google Play live boards on get_top_trends. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters3

source	string	required	One source, or comma-separated sources (e.g. 'amazon, tiktok, youtube'). Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.
keyword	string	required	What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): any name or phrase, e.g. 'nike'. npm: exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. python: exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. steam: game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. app downloads and app rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. If the request includes app downloads or app rankings with other sources, keyword must still be the Android bundle ID.
percent_growth	array	optional	Growth windows. Default if omitted: ['12M']. Each item must be a preset string: '7D', '1W', '14D', '2W', '30D', '1M', '2M', '3M', '6M', '9M', '12M', '1Y', '18M', '24M', '2Y', '36M', '3Y', '48M', '4Y', '60M', '5Y', 'MTD', 'QTD', 'YTD'. Every preset is a two-date comparison.

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "description": "One source, or comma-separated sources (e.g. 'amazon, tiktok, youtube'). Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.",
      "type": "string"
    },
    "keyword": {
      "description": "What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): any name or phrase, e.g. 'nike'. npm: exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. python: exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. steam: game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. app downloads and app rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. If the request includes app downloads or app rankings with other sources, keyword must still be the Android bundle ID.",
      "type": "string"
    },
    "percent_growth": {
      "description": "Growth windows. Default if omitted: ['12M']. Each item must be a preset string: '7D', '1W', '14D', '2W', '30D', '1M', '2M', '3M', '6M', '9M', '12M', '1Y', '18M', '24M', '2Y', '36M', '3Y', '48M', '4Y', '60M', '5Y', 'MTD', 'QTD', 'YTD'. Every preset is a two-date comparison.",
      "type": "array",
      "items": {
        "description": "A preset period such as '12M', '3M', or 'YTD'.",
        "type": "string"
      }
    }
  },
  "required": [
    "keyword",
    "source"
  ]
}

trends___get_time_series

Full historical series for one keyword and one source (0-100 values, plus volume when available). Use for charting or custom math. Not for live 'what's trending now' boards (use get_top_trends). For most growth questions, use get_growth. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters2

source	string	required	Exactly one source per request. Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.
keyword	string	required	What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): any name or phrase, e.g. 'tesla'. npm: exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. python: exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. steam: game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. app downloads and app rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART.

Raw schema

{
  "type": "object",
  "properties": {
    "source": {
      "description": "Exactly one source per request. Valid: 'google search', 'google images', 'google news', 'google shopping', 'youtube', 'wikipedia', 'tiktok', 'reddit', 'amazon', 'news sentiment', 'news volume', 'npm', 'python', 'steam', 'app downloads', 'app rankings'.",
      "type": "string"
    },
    "keyword": {
      "description": "What to look up. The string format is required by source. Standard sources (google search, google images, google news, google shopping, youtube, wikipedia, tiktok, reddit, amazon, news sentiment, news volume): any name or phrase, e.g. 'tesla'. npm: exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. python: exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. steam: game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. app downloads and app rankings: Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART.",
      "type": "string"
    }
  },
  "required": [
    "keyword",
    "source"
  ]
}

trends___get_top_trends

Live top-trending board for exactly one feed type. No keyword. For 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', and 'TikTok Trending Hashtags by Category', always pass category. Default sort is current rank. Use sort='rank_change' for climbers vs a prior snapshot (window 1d, 3d, 7d, 14d, or 30d). App Store Top Free, App Store Top Paid, and Google Play are live store boards, not keyword lookups. For an app's history use get_growth or get_time_series with source app downloads or app rankings and an Android bundle ID. Do not use get_time_series for live boards. If the request is rate limited or the monthly quota is used up, tell the user their plan limit is reached.

Parameters6

offset	integer	optional	Rows to skip for pagination. Default 0.
limit	integer	optional	Max rows to return. Default 25, min 1, max 200.
sort	string	optional	How to rank the board. 'rank' (default): current leaders. 'rank_change': biggest climbers vs a prior snapshot. Mover rows include rank, keyword, prev_rank, and rank_change.
window	string	optional	Lookback used only when sort is 'rank_change'. One of '1d', '3d', '7d', '14d', '30d'. Default '30d'. Short windows only work on daily feeds; weekly and monthly feeds return a note pointing to a longer window.
type	string	required	Exactly one live feed. Valid: 'Amazon Best Sellers Top Rated', 'Amazon Best Sellers by Category', 'App Store Top Free', 'App Store Top Paid', 'GitHub', 'Google News Top News', 'Google Play', 'Google Trends', 'Google Trends by Category', 'IMDb MOVIEmeter', 'Open Library Trending Books', 'Reddit Hot Posts', 'Reddit World News', 'Top Websites', 'Spotify Top Podcasts', 'Steam Most Played', 'Substack', 'Substack by Category', 'TikTok Trending Hashtags', 'TikTok Trending Hashtags by Category', 'TikTok Trending Searches', 'Wikipedia Trending', 'X (Twitter) Trending', 'YouTube Trending'.
category	string	optional	Pass this whenever type is 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', or 'TikTok Trending Hashtags by Category'. Use the official name. Without it those feeds mix every board. Only omit on a first pull to learn the official names.

Raw schema

{
  "type": "object",
  "properties": {
    "offset": {
      "description": "Rows to skip for pagination. Default 0.",
      "type": "integer"
    },
    "limit": {
      "description": "Max rows to return. Default 25, min 1, max 200.",
      "type": "integer"
    },
    "sort": {
      "description": "How to rank the board. 'rank' (default): current leaders. 'rank_change': biggest climbers vs a prior snapshot. Mover rows include rank, keyword, prev_rank, and rank_change.",
      "type": "string"
    },
    "window": {
      "description": "Lookback used only when sort is 'rank_change'. One of '1d', '3d', '7d', '14d', '30d'. Default '30d'. Short windows only work on daily feeds; weekly and monthly feeds return a note pointing to a longer window.",
      "type": "string"
    },
    "type": {
      "description": "Exactly one live feed. Valid: 'Amazon Best Sellers Top Rated', 'Amazon Best Sellers by Category', 'App Store Top Free', 'App Store Top Paid', 'GitHub', 'Google News Top News', 'Google Play', 'Google Trends', 'Google Trends by Category', 'IMDb MOVIEmeter', 'Open Library Trending Books', 'Reddit Hot Posts', 'Reddit World News', 'Top Websites', 'Spotify Top Podcasts', 'Steam Most Played', 'Substack', 'Substack by Category', 'TikTok Trending Hashtags', 'TikTok Trending Hashtags by Category', 'TikTok Trending Searches', 'Wikipedia Trending', 'X (Twitter) Trending', 'YouTube Trending'.",
      "type": "string"
    },
    "category": {
      "description": "Pass this whenever type is 'Amazon Best Sellers by Category', 'Google Trends by Category', 'Top Websites', 'Substack by Category', or 'TikTok Trending Hashtags by Category'. Use the official name. Without it those feeds mix every board. Only omit on a first pull to learn the official names.",
      "type": "string"
    }
  },
  "required": [
    "type"
  ]
}

README.md7 KBView on GitHub

Amazon product-search demand API

Amazon search interest and bestseller feeds via the Trends API. Ecommerce research without scrapers.

PyPI Python npm

Key: trendsapi.ai/#get-key. HTTP contract and every source: trendsapi-ai/trendsapi.

Authentication

bash

pip install trendsapi-amazon
export TRENDSAPI_KEY=your_key

Python 3.9+. Same key as the HTTP API.

python

from trendsapi_amazon import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

Keyword helpers default to source: "amazon". Pass source= to hit any other platform with the same client. Official full client (every source, no preset): trendsapi.

Methods

Method	REST `mode`	Returns
`get_time_series(keyword, source=, data_mode=)`	`get_time_series`	`list[TrendsDataPoint]`
`get_growth(keyword, percent_growth=, source=, data_mode=)`	`get_growth`	`GetGrowthResponse`
`get_live(limit=, offset=, category=)`	`get_top_trends`	`GetTopTrendsResponse`
`get_top_trends(type=, ...)`	`get_top_trends`	`GetTopTrendsResponse`

source is lowercase (amazon). type is exact (Amazon Best Sellers Top Rated). Mixing them is a 400.

python

from trendsapi_amazon import TrendsAPI

client = TrendsAPI()                    # TRENDSAPI_KEY
# client = TrendsAPI(api_key="YOUR_KEY")

series = client.get_time_series("standing desk")
print(series[-1].date, series[-1].value)

growth = client.get_growth("standing desk", percent_growth=["3M", "12M"])
print(growth.results[0].growth, growth.results[0].direction)

hot = client.get_live(limit=10)
print(hot.data)                         # [[1, "..."], ...]

get_time_series

python

points = client.get_time_series("standing desk")

Each point:

Field	Always	Meaning
`date`	yes	`YYYY-MM-DD`
`value`	yes	0-100 index for this series
`keyword`	yes	Echo
`volume`	no	Absolute volume when available
`source` or `datatype`	no	Pipeline label

Python returns list[TrendsDataPoint]. Use .date and .value, not ["date"]. JS returns the same fields as object properties.

get_growth

python

g = client.get_growth("standing desk", percent_growth=["12M", "3M", "YTD"])
print(g.results[0].growth, g.results[0].direction)

percent_growth default: ["12M"]. Presets: 7D 14D 30D 1M 2M 3M 6M 9M 12M/1Y 18M 24M/2Y 36M/3Y 48M 60M/5Y MTD QTD YTD. Custom: {"name": "Launch", "recent": "2024-06-01", "baseline": "2024-01-01"}.

Field	Meaning
`search_term`	Keyword
`data_source`	Source
`results`	One object per window (`period`, `growth`, `direction`, dates, values)
`metadata`	Counts / success flag

Several windows still count as one request. Python: growth.results[0].growth. JS: growth.results[0].growth.

get_live

python

hot = client.get_live(limit=10)

Field	Meaning
`as_of_ts`	Snapshot time
`type`	Feed name
`limit`, `offset`, `count`	Pagination
`data`	`[rank, label]` rows

Python: hot.data. JS: hot.data. Optional offset= and category= (Amazon Best Sellers by Category, Top Websites only).

Async

python

import asyncio
from trendsapi_amazon import AsyncTrendsAPI

async def main():
    c = AsyncTrendsAPI()
    return await asyncio.gather(
        c.get_time_series("standing desk"),
        c.get_time_series("standing desk", source="google search"),
    )

asyncio.run(main())

Each 200 is one billed request.

Pandas

python

from dataclasses import asdict
import pandas as pd
from trendsapi_amazon import TrendsAPI

df = pd.DataFrame(asdict(p) for p in TrendsAPI().get_time_series("standing desk"))
df["date"] = pd.to_datetime(df["date"])
print(df.set_index("date")["value"].resample("ME").mean().tail())

JavaScript / TypeScript

bash

npm install trendsapi-amazon

Node 18+, Deno, Bun, Workers. Same API key. Field tables above apply.

Methods

Method	REST `mode`	Returns
`getTimeSeries(keyword, { source, data_mode })`	`get_time_series`	weekly points
`getGrowth(keyword, { percent_growth, source, data_mode })`	`get_growth`	growth object
`getLive({ limit, offset, category })`	`get_top_trends`	live feed
`getTopTrends({ type, ... })`	`get_top_trends`	live feed

import { TrendsAPI } from "trendsapi-amazon";

const client = new TrendsAPI({ apiKey: process.env.TRENDSAPI_KEY! });
const series = await client.getTimeSeries("standing desk");
console.log(series.at(-1)?.date, series.at(-1)?.value);

const growth = await client.getGrowth("standing desk", {
  percent_growth: ["3M", "12M"],
});
console.log(growth.results[0].growth, growth.results[0].direction);

const live = await client.getLive({ limit: 10 });
console.log(live.data);                 // [[1, "..."], ...]

Call (curl)

Field	Value
Endpoint	`POST https://api.trendsapi.ai/api`
Auth	`Authorization: Bearer $TRENDSAPI_KEY`
History	`source: amazon` with `get_time_series` or `get_growth`
Keyword	Product phrase, e.g. standing desk
Live `type`	Amazon Best Sellers Top Rated, Amazon Best Sellers by Category

bash

curl -sS -X POST https://api.trendsapi.ai/api \
  -H "Authorization: Bearer $TRENDSAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_time_series","source":"amazon","keyword":"standing desk"}'

Source notes

value is a 0-100 search-interest index, not units sold.
Feeds answer what is selling now. Keyword series answer what is searched.
Google Shopping is a different source (google shopping).

Errors

HTTP	Client
200	Parsed payload. Python dataclasses / JS typed objects
400	Raises. Fix `source` or `type` spelling
401	Raises. Check `TRENDSAPI_KEY`
404	Raises. No series for that keyword. Do not retry
429	Raises. Quota
5xx	Client retries, then raises

The HTTP body field is a JSON string. SDKs decode it. Raw curl must parse body a second time.

Site: https://trendsapi.ai/trends/amazon-trends.

License

MIT. See LICENSE.

Install

Tools (3)

trends___get_growthtrends___get_time_seriestrends___get_top_trends

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://amazon.api.trendsapi.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://amazon.api.trendsapi.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.trendsapi/amazon MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

trends___get_growth

trends___get_time_series

trends___get_top_trends

Amazon product-search demand API

Authentication

Methods

get_time_series

get_growth

get_live

Async

Pandas

JavaScript / TypeScript

Methods

Call (curl)

Source notes

Errors

License

Install

Remote endpoint

Related servers