# Social Media Trends API

Query weekly trend history, percentage changes, or a live ranked feed through an MCP server. Use it to inspect signals for a keyword and source.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: trendsapi-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/trendsapi-ai/trends-mcp
- Updated: 2026-08-18
- HTML: https://affpapa.org/en/nevibecode/mcp/social-media-trends-api

## What it does

The server exposes three operations. One returns weekly history for a source and keyword; another gives the percentage change. A third fetches a live ranked feed and takes a trend type instead. Source options, feed categories, and keyword formats are described in the service catalogs.

A token is needed for requests. Claude Code connects over HTTP, while the Cursor setup uses an `mcp.json` configuration. There is one specific requirement for app data: `app downloads` and `app rankings` need an Android bundle ID, such as `com.openai.chatgpt`.

## Requirements
- Remote server: `https://social-media.api.trendsapi.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http social-media-trends-api https://social-media.api.trendsapi.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add social-media-trends-api --url https://social-media.api.trendsapi.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "social-media-trends-api": {
            "url": "https://social-media.api.trendsapi.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "social-media-trends-api": {
            "type": "http",
            "url": "https://social-media.api.trendsapi.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http social-media-trends-api https://social-media.api.trendsapi.ai/mcp
```

## When to use it
- inspect a keyword’s weekly trend history by source
- check the percentage change for a trend
- fetch a live ranked feed for a trend type
- look up app download or ranking data by Android bundle ID

## Example prompts
- Show the weekly TikTok history for the keyword “coffee”.
- Check the Reddit trend change for the keyword “local models”.
- Fetch the live `app rankings` feed for Android bundle ID `com.openai.chatgpt`.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7132
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4963
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2329
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3228
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md