{"id":"838e64eb-84a0-4832-a9fc-099d274d08a7","slug":"smithery-top-yappers","name":"TopYappers","description":"# TopYappers\n\nSocial 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.\n\n## What it does\n\nTopYappers gives AI agents real-time access to social media data across three domains:\n\n- **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.\n- **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.\n- **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.\n\n## Tools\n\n| Tool | Description | Cost |\n|------|-------------|------|\n| `search_viral_content` | Find viral TikTok posts by category, country, views, virality score, dates, music, hooks | 1 credit/result |\n| `search_creators` | Search influencers across TikTok, Instagram, YouTube with 20+ filters | **Free** |\n| `get_creator_profiles` | Fetch full creator profiles — followers, engagement, email, bio, niches, promoted products | 1 credit/creator |\n| `search_videos` | Search videos by engagement metrics, hashtags, text in descriptions | 1 credit/video |\n| `get_song_rankings` | Country or global trending song chart rankings | 10 credits |\n| `get_new_song_entries` | Newly charting songs that just entered rankings | 10 credits |\n| `search_songs` | Search songs by title or artist name | 10 credits |\n| `get_song_history` | Track a song's chart performance over time | 10 credits |\n| `compare_song_rankings` | Compare song charts between two weeks | 10 credits |\n| `get_song_countries` | List available countries for song data | 10 credits |\n| `get_song_weeks` | List available weeks for a country | 10 credits |\n\n## Use cases\n\n- **Influencer marketing** — Find creators in specific niches who match a brand's target audience, with contact emails and engagement data\n- **Content strategy** — Analyze what's going viral in your category to inform content creation\n- **Trend monitoring** — Track trending songs and sounds before they peak, ideal for music marketing and content timing\n- **Competitive intelligence** — Discover which products competitors are promoting through influencers\n- **Market research** — Understand engagement patterns across countries, categories, and platforms\n\n## Key features\n\n- **Credit-efficient design** — Creator search is free; agents find matching IDs first, then only fetch profiles for relevant creators\n- **Rich filtering** — 20+ filters for creators including AI-analyzed `nichesToPromote` for semantic niche matching\n- **Cross-platform** — Single interface for TikTok, Instagram, and YouTube data\n- **Built-in agent guidance** — Includes detailed instructions and prompt templates to help agents use tools effectively\n- **No data stored** — API keys are forwarded as Bearer tokens; nothing is stored on the server\n\n## Authentication\n\nRequires 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).\n\n## Links\n\n- [TopYappers Platform](https://www.topyappers.com)\n- [API Documentation](https://docs.topyappers.com)\n- [MCP Documentation](https://www.topyappers.com/mcp)\n- [GitHub](https://github.com/topyappers/topyappers-mcp)\n","capabilities":[],"protocols":["MCP"],"safetyScore":86,"overallRank":34.9,"trustScore":null,"trust":null,"source":"SMITHERY","updatedAt":"2026-05-22T06:55:50.886Z"}