# TopYappers

> TopYappers — top-yappers. Use this tool when you need to discover viral content, find influencers, or track trending songs across TikTok, Instagram, and YouTube. It provides real-time social media intelligence through a single interface, solving problems in influencer marketing, content strategy, trend monitoring, competitive intelligence, and market research. With a credit-efficient design and rich filtering options, TopYappers offers a powerful solution for AI agents to inform their decisions and actions.

Canonical page: https://skillsregistry.net/skills/top-yappers  
JSON: https://api.skillsregistry.net/v1/skills/top-yappers

## Description

# TopYappers

Social media intelligence for AI agents. Access viral content discovery, influencer search across TikTok, Instagram & YouTube, and trending song charts — all through a single MCP connection.

## What it does

TopYappers gives AI agents real-time access to social media data across three domains:

- **Viral Content** — Discover trending TikTok posts filtered by category, country, virality score (views÷followers), date range, music/sound, and opening hooks. Understand what's going viral and why.
- **Creators & Influencers** — Search a database of 30M+ creators across TikTok, Instagram, and YouTube using 20+ filters including AI-analyzed niches, promoted products, follower ranges, engagement rates, country, language, and hashtags. Creator search is free — you only pay when fetching full profiles.
- **Trending Songs** — Access weekly song chart rankings by country, track new chart entries, search by title or artist, view historical performance, and compare charts week-over-week.

## Tools

| Tool | Description | Cost |
|------|-------------|------|
| `search_viral_content` | Find viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result |
| `search_creators` | Search influencers across TikTok, Instagram, YouTube with 20+ filters | **Free** |
| `get_creator_profiles` | Fetch full creator profiles — followers, engagement, email, bio, niches, promoted products | 1 credit/creator |
| `search_videos` | Search videos by engagement metrics, hashtags, text in descriptions | 1 credit/video |
| `get_song_rankings` | Country or global trending song chart rankings | 10 credits |
| `get_new_song_entries` | Newly charting songs that just entered rankings | 10 credits |
| `search_songs` | Search songs by title or artist name | 10 credits |
| `get_song_history` | Track a song's chart performance over time | 10 credits |
| `compare_song_rankings` | Compare song charts between two weeks | 10 credits |
| `get_song_countries` | List available countries for song data | 10 credits |
| `get_song_weeks` | List available weeks for a country | 10 credits |

## Use cases

- **Influencer marketing** — Find creators in specific niches who match a brand's target audience, with contact emails and engagement data
- **Content strategy** — Analyze what's going viral in your category to inform content creation
- **Trend monitoring** — Track trending songs and sounds before they peak, ideal for music marketing and content timing
- **Competitive intelligence** — Discover which products competitors are promoting through influencers
- **Market research** — Understand engagement patterns across countries, categories, and platforms

## Key features

- **Credit-efficient design** — Creator search is free; agents find matching IDs first, then only fetch profiles for relevant creators
- **Rich filtering** — 20+ filters for creators including AI-analyzed `nichesToPromote` for semantic niche matching
- **Cross-platform** — Single interface for TikTok, Instagram, and YouTube data
- **Built-in agent guidance** — Includes detailed instructions and prompt templates to help agents use tools effectively
- **No data stored** — API keys are forwarded as Bearer tokens; nothing is stored on the server

## Authentication

Requires a TopYappers API key passed as a Bearer token in the `Authorization` header. Get a key at [topyappers.com/profile](https://www.topyappers.com/profile).

## Links

- [TopYappers Platform](https://www.topyappers.com)
- [API Documentation](https://docs.topyappers.com)
- [MCP Documentation](https://www.topyappers.com/mcp)
- [GitHub](https://github.com/topyappers/topyappers-mcp)

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** database
- **Updated:** 2026-07-12

## Source

- **Source listing:** [Smithery](https://smithery.ai/server/top/yappers)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "top-yappers"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/top-yappers` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/top-yappers/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt