ai.trendsapi/npm MCP Server

The ai.trendsapi/npm Model Context Protocol server provides npm package download interest and adoption growth over time via the Trends API. It returns a normalized 0–100 history and growth metrics for exact package names, using an HTTP contract. The service is documented with a key endpoint at trendsapi.ai.

🛠️ Key Features

npm package download interest and adoption growth over time
Normalized 0–100 history
Growth for exact package names
HTTP contract; source reference to trendsapi-ai/trendsapi

🚀 Use Cases

Market research on package adoption
Trend data for open-source ecosystems
Time-series analysis of npm-download interest

⚡ Developer Benefits

REST API access to trend-history and growth data
JSON-based trend data and time-series support

⚠️ Limitations

Requires an API key from trendsapi.ai (see “get key” endpoint)
Authentication details are only partially shown in the available excerpt

Supported Topics

alternative-data, developer-tools, github-trending, javascript, json-api, market-research, no-scraping, nodejs, npm, npm-downloads, open-source, package-downloads, python, rest-api, time-series, trend-data, trends-api, mcp, mcp-server, model-context-protocol

npm package-download trends API

npm download interest via the Trends API. Normalized 0-100 history and growth for exact package names.

PyPI Python

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

Authentication

bash

pip install trendsapi-npm
export TRENDSAPI_KEY=your_key

Python 3.9+. Same key as the HTTP API.

python

from trendsapi_npm import TrendsAPI

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

Keyword helpers default to source: "npm". 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_top_trends(type=, ...)`	`get_top_trends`	`GetTopTrendsResponse`

source is lowercase (npm). type is exact (Google Trends). Mixing them is a 400.

python

from trendsapi_npm import TrendsAPI

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

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

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

get_time_series

python

points = client.get_time_series("vite")

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("vite", 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.

Async

python

import asyncio
from trendsapi_npm import AsyncTrendsAPI

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

asyncio.run(main())

Each 200 is one billed request.

Pandas

python

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

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

Call (curl)

Field	Value
Endpoint	`POST https://api.trendsapi.ai/api`
Auth	`Authorization: Bearer $TRENDSAPI_KEY`
History	`source: npm` with `get_time_series` or `get_growth`
Keyword	Exact package name, case-sensitive: vite, @tanstack/react-query
Live `type`	n/a

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":"npm","keyword":"vite"}'

Source notes

Do not URL-encode @ or / inside JSON.
One package per request.
For exact integer counts use api.npmjs.org/downloads.

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/npm-trends.

License

MIT. See LICENSE.

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.

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.

npm Trends API

ai.trendsapi/npm MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Supported Topics

Topics

trends___get_growth

trends___get_time_series

trends___get_top_trends

npm package-download trends API

Authentication

Methods

get_time_series

get_growth

Async

Pandas

Call (curl)

Source notes

Errors

License

Install

Remote endpoint

Related servers