# Socialytics

> Socialytics gives AI assistants and code live trend data: 53 data sets from 27 platforms (Google, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon, Pinterest, npm, PyPI, Steam, Google Play, App Store, GitHub, Google Trends, IMDb, Open Library, Polymarket, Reddit, Web, Spotify, Substack, X, Instagram, Bluesky, Hacker News), 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://socialytics.dev/mcp`. No key to paste.
- MCP, API key (Cursor, VS Code, Claude Code, other clients): `https://api.trendsmcp.ai/mcp`
- REST: `POST https://api.trendsmcp.ai/api` with a JSON body; `mode` picks the tool
- Auth: `Authorization: Bearer YOUR_API_KEY` (the bare key works too). Free key: https://socialytics.dev/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 | Top 25 | - |
| Pro | $49/mo | $39/mo ($468 a year) | 5,000 | 50 | Top 100 | - |
| Business | $199/mo | $159/mo ($1,910 a year) | 25,000 | 250 | Full board | yes |

## Pay as you go

One-time packs, no subscription. 1 credit = 1 request. Credits never expire and are used after a plan's monthly requests run out, on any plan.

| Pack | Credits | Per credit |
|---|---|---|
| $15 | 600 | 2.5¢ |
| $49 | 2,500 | 1.96¢ |
| $199 | 12,000 | 1.66¢ |

Buy credits: https://socialytics.dev/account?tab=billing

## Docs

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

## Optional

- [Socialytics](https://socialytics.dev/): The social data layer for AI agents: posts, comments, hashtags, engagement and trending boards
- [Platforms](https://socialytics.dev/platforms): Every platform and what each one returns
- [Use cases](https://socialytics.dev/use-cases): What teams build with it, with the exact calls
- [MCP server](https://socialytics.dev/mcp-server): Connect Claude, ChatGPT, Cursor and other clients
- [Socialytics vs SocialCrawl](https://socialytics.dev/compare/socialcrawl): Where each one fits
- [Data catalog](https://socialytics.dev/data-catalog): Every data set, parameter and category
- [Docs](https://socialytics.dev/docs): API reference
- [Pricing](https://socialytics.dev/pricing): Plans and credit packs
- [TikTok data API](https://socialytics.dev/platforms/tiktok): Which hashtags are rising, how many views they pull each day, and the videos winning on them.
- [Pinterest data API](https://socialytics.dev/platforms/pinterest): Two years of Pinterest search interest, and the searches trending this month by country and category.
- [Reddit data API](https://socialytics.dev/platforms/reddit): The Reddit front page as it ranks, and the threads and comments behind a keyword.
- [X data API](https://socialytics.dev/platforms/x): What is trending on X by country, and the posts and replies behind a keyword.
- [Instagram data API](https://socialytics.dev/platforms/instagram): The reels people post about a keyword, and the top posts on any hashtag.
- [Bluesky data API](https://socialytics.dev/platforms/bluesky): The posts about a keyword on Bluesky, with likes, reposts and top replies.
- [YouTube data API](https://socialytics.dev/platforms/youtube): Five years of YouTube search interest, the trending chart, and the videos and comments behind a topic.
- [Google data API](https://socialytics.dev/platforms/google): Search interest for any phrase, about five years weekly or the last 90 days daily, by country.
- [Google Images data API](https://socialytics.dev/platforms/google-images): Image search interest for any phrase, the visual side of demand.
- [Google Trends data API](https://socialytics.dev/platforms/google-trends): The searches trending on Google right now, by country and by topic board.
- [Google News data API](https://socialytics.dev/platforms/google-news): News search interest, the top stories right now, and stories grouped by event.
- [Google Shopping data API](https://socialytics.dev/platforms/google-shopping): Shopping search interest for any product, about five years weekly.
- [Amazon data API](https://socialytics.dev/platforms/amazon): Amazon product search volume with raw counts, and the best sellers by category.
- [Google Play data API](https://socialytics.dev/platforms/google-play): Daily Android downloads and chart rank for any app, and the Google Play top chart.
- [App Store data API](https://socialytics.dev/platforms/app-store): The App Store top free and top paid charts, as they rank today.
- [Steam data API](https://socialytics.dev/platforms/steam): Concurrent players for any game, and the most played games right now.
- [npm data API](https://socialytics.dev/platforms/npm): Weekly npm downloads for any package, with raw counts.
- [PyPI data API](https://socialytics.dev/platforms/pypi): Weekly PyPI downloads for any Python project, with raw counts.
- [GitHub data API](https://socialytics.dev/platforms/github): The repositories trending on GitHub today, and active repositories for a keyword.
- [Hacker News data API](https://socialytics.dev/platforms/hacker-news): The Hacker News stories about a keyword, with points and top comments.
- [Wikipedia data API](https://socialytics.dev/platforms/wikipedia): Wikipedia pageviews with raw counts, in any language, and the most-viewed articles today.
- [IMDb data API](https://socialytics.dev/platforms/imdb): The most popular movies by user activity, from IMDb MOVIEmeter.
- [Open Library data API](https://socialytics.dev/platforms/open-library): The books trending on Open Library today.
- [Spotify data API](https://socialytics.dev/platforms/spotify): The top podcasts on Spotify, ranked daily.
- [Substack data API](https://socialytics.dev/platforms/substack): The top newsletters on Substack, overall and by category.
- [Web data API](https://socialytics.dev/platforms/web): The most visited websites by traffic rank, by category.
- [Polymarket data API](https://socialytics.dev/platforms/polymarket): The prediction markets with the most money traded, and the open markets for a keyword.