# Trends API

> Trends API normalizes trend data from Google, TikTok, Amazon, Reddit, YouTube,
> Steam, npm and 30+ other sources into a single 0-100 trend score, served as
> JSON from one REST endpoint. One API key covers every source and feed.

Base URL: POST https://api.trendsapi.ai/api
Auth: header `Authorization: Bearer <api_key>` (get a free key at https://trendsapi.ai/#get-key)
Content-Type: application/json

## Response envelope (read first)

Every response is a JSON object `{"statusCode": int, "body": string}`. The
`body` value is a JSON *string*, so parse it a second time before reading data:

- Python: `data = json.loads(res.json()["body"])`
- Node: `const data = JSON.parse((await res.json()).body)`

Only successful 200 responses count against the monthly quota; 4xx/5xx are free.

## Modes

- get_time_series: `{"mode":"get_time_series","source":"google search","keyword":"bitcoin"}`
  Returns a JSON array of `{"date","value","keyword","source"}` points.
- get_growth: `{"mode":"get_growth","source":"google search","keyword":"bitcoin","percent_growth":["3M","12M"]}`
  Returns `{"search_term","data_source","results":[{"period","growth","direction",...}]}`.
  Windows: 3M / 6M / 12M / 5Y (subject to available history per source).
- get_top_trends: `{"mode":"get_top_trends","type":"Google Trends","limit":10}`
  Live trending feeds, no keyword needed. Returns `{"type","count","data":[[rank,label],...]}`.

## Keyword sources (use as the "source" value)

google search, google images, google news, google shopping, youtube, tiktok,
reddit, amazon, wikipedia, news volume, news sentiment, app downloads,
app rankings, npm, steam

## Live feeds (use as the "type" value, no keyword)

- Google Trends: Top trending search terms on Google right now
- Google News Top News: Top news stories from Google News
- TikTok Trending Hashtags: Top trending hashtags on TikTok
- TikTok Trending Searches: Top trending search terms on TikTok
- TikTok Shop Hot Products: Top hot products on TikTok Shop
- 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
- GitHub Trending Repos: 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

## Source docs

Per-source guides with examples, comparison tables and FAQs:

- [Google Trends](https://trendsapi.ai/trends/google-trends)
- [pytrends alternative](https://trendsapi.ai/trends/pytrends-alternative)
- [Google Images](https://trendsapi.ai/trends/google-images)
- [Google News](https://trendsapi.ai/trends/google-news)
- [Google Shopping](https://trendsapi.ai/trends/google-shopping)
- [TikTok](https://trendsapi.ai/trends/tiktok-trends)
- [YouTube](https://trendsapi.ai/trends/youtube-trends)
- [Reddit](https://trendsapi.ai/trends/reddit-trends)
- [X (Twitter)](https://trendsapi.ai/trends/x-twitter)
- [Amazon](https://trendsapi.ai/trends/amazon-trends)
- [Wikipedia](https://trendsapi.ai/trends/wikipedia-trends)
- [News](https://trendsapi.ai/trends/news-trends)
- [News Sentiment](https://trendsapi.ai/trends/news-sentiment)
- [App Store](https://trendsapi.ai/trends/app-store-trends)
- [npm](https://trendsapi.ai/trends/npm-trends)
- [Steam](https://trendsapi.ai/trends/steam-trends)
- [GitHub](https://trendsapi.ai/trends/github-trends)
- [Spotify](https://trendsapi.ai/trends/spotify-trends)
- [Web Traffic](https://trendsapi.ai/trends/web-traffic)
- [IMDb](https://trendsapi.ai/trends/imdb-trends)
- [Open Library](https://trendsapi.ai/trends/open-library)

## Docs

- [Quickstart](https://trendsapi.ai/#quickstart): cURL, Python and Node first-call examples
- [Pricing](https://trendsapi.ai/#pricing): free tier is 100 requests/month, no credit card
- [Get an API key](https://trendsapi.ai/#get-key): email in, key out, about 60 seconds
- [MCP server](https://trendsapi.ai/#agents): query the same data from Claude, ChatGPT, Cursor
- [All trend sources](https://trendsapi.ai/trends): hub page listing every source and feed
- [Sitemap](https://trendsapi.ai/sitemap.xml)