# Trends API

> Trends API gives AI assistants and code live trend data: 49 data sets from 26 platforms (Google, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon, npm, PyPI, Steam, Google Play, App Store, GitHub, Google Trends, IMDb, Open Library, Reddit, Web, Spotify, Substack, X, Instagram, Bluesky, Hacker News, Polymarket), through 5 tools over MCP or a REST API. About five years of weekly history where the source has it. One free API key for both.

- MCP, sign in (Claude, ChatGPT): `https://trendsapi.ai/mcp`. No key to paste.
- MCP, API key (Cursor, VS Code, Claude Code, other clients): `https://api.trendsapi.ai/mcp`
- REST: `POST https://api.trendsapi.ai/api` with a JSON body; `mode` picks the tool
- Auth: `Authorization: Bearer YOUR_API_KEY` (the bare key works too). Free key: https://trendsapi.ai/account (email and an 8-digit code, no card)

## Tools

- `get_time_series`: Full history for one topic. About five years of weekly history for one keyword on one source, as a 0 to 100 index plus volume where the source has it. Cost: 1 request per call.
- `get_growth`: How fast something is rising. Point-to-point growth over one or more windows, on one source or several in the same call. Cost: 1 request per call, every window included.
- `get_top_trends`: What's moving right now. A live ranked board with no keyword: the current leaders, or the biggest climbers against an earlier snapshot. Cost: MCP: 1 request per 10 rows, at most 10 per call. REST: 1 request per call.
- `get_context`: What people are saying. What people are posting, reading and betting about a keyword right now: posts, videos, stories, comments and markets from each source, with engagement. Cost: MCP: 1 request per source, at most 5 per call. REST: one source per call, 1 request.
- `get_top_posts`: Top posts for one hashtag. Live top posts for one hashtag, fetched on every call. Business plan. Cost: 1 request per call.
- `get_usage`: Free. MCP only: your plan, requests used and left, reset date.

## Plans

| Plan | Monthly | Billed yearly | Requests a month | Keyword alerts | Top trends rows | Top Posts |
|---|---|---|---|---|---|---|
| Free | $0 | - | 100 | - | Top 10, 24h delay | - |
| Starter | $19/mo | $16/mo ($192 a year) | 1,000 | 10 | Full board | - |
| Pro | $49/mo | $39/mo ($468 a year) | 5,000 | 50 | Full board | - |
| Business | $199/mo | $159/mo ($1,910 a year) | 25,000 | 250 | Full board | yes |

## Docs

- [Everything in one file](https://trendsapi.ai/llms-full.txt): setup per client, every tool, data set, plan and error
- [API reference](https://trendsapi.ai/docs.md): tools, parameters, examples, responses, errors
- [Data catalog](https://trendsapi.ai/data-catalog.md): every data set, keyword format, option and category
- [Pricing](https://trendsapi.ai/pricing.md): plans, prices and what counts as a request
- [OpenAPI](https://trendsapi.ai/openapi.json): the REST contract
- [Get a free API key](https://trendsapi.ai/account)

## Optional

- [Homepage](https://trendsapi.ai/)
- [Google Trends API guide](https://trendsapi.ai/trends/google-trends)
- [pytrends alternative API guide](https://trendsapi.ai/trends/pytrends-alternative)
- [Google Images API guide](https://trendsapi.ai/trends/google-images)
- [Google News API guide](https://trendsapi.ai/trends/google-news)
- [Google Shopping API guide](https://trendsapi.ai/trends/google-shopping)
- [TikTok API guide](https://trendsapi.ai/trends/tiktok-trends)
- [YouTube API guide](https://trendsapi.ai/trends/youtube-trends)
- [Reddit API guide](https://trendsapi.ai/trends/reddit-trends)
- [X (Twitter) API guide](https://trendsapi.ai/trends/x-twitter)
- [Amazon API guide](https://trendsapi.ai/trends/amazon-trends)
- [Wikipedia API guide](https://trendsapi.ai/trends/wikipedia-trends)
- [App Store API guide](https://trendsapi.ai/trends/app-store-trends)
- [npm API guide](https://trendsapi.ai/trends/npm-trends)
- [PyPI API guide](https://trendsapi.ai/trends/pypi-trends)
- [Steam API guide](https://trendsapi.ai/trends/steam-trends)
- [GitHub API guide](https://trendsapi.ai/trends/github-trends)
- [Spotify API guide](https://trendsapi.ai/trends/spotify-trends)
- [Substack API guide](https://trendsapi.ai/trends/substack-trends)
- [Web Traffic API guide](https://trendsapi.ai/trends/web-traffic)
- [IMDb API guide](https://trendsapi.ai/trends/imdb-trends)
- [Open Library API guide](https://trendsapi.ai/trends/open-library)
- [Terms](https://trendsapi.ai/terms)
- [Privacy](https://trendsapi.ai/privacy)
- [Sitemap](https://trendsapi.ai/sitemap.xml)