Skip to main content

​
TopYappers API

Use TopYappers APIs to discover creators, analyze high-performing content, remix media, manage creator CRM records, and retrieve outreach activity.

Creators API

Search creators for free, then fetch full profiles for the creators you need.

Viral Content API

Find viral posts, creative patterns, and content ideas for research workflows.

Media Remix

Process video and image URLs through the Remix API with optional transformation parameters.

CRM API

Manage creator lists, check membership, and update contact records.

Agent Outreach

Retrieve outreach projects, contacted creators, and saved email messages.

Songs API

Discover trending songs and audio context for content research.

​
Quickstart

  1. Create or copy an API key from your TopYappers dashboard.
  2. Send the key in the x-ty-api-key header.
  3. Start with the free creator search endpoint, then fetch full records only for the creators you need.
curl "https://api.topyappers.com/api/v2/creators/search?mainCategory=technology&followersMin=10000" \
  -H "x-ty-api-key: YOUR_API_KEY"
Use GET /api/v2/creators/search to discover creator IDs for free, then call POST /api/v2/creators/get when you need full profiles.

​
Common Paths

Search creators

Free creator discovery with filters for niche, source, country, follower count, and more.

Fetch full creators

Retrieve complete creator profiles by ID.

Process videos

Submit a public video URL for Remix API processing.

Process images

Submit one image URL or a batch of image URLs for Remix API processing.

​
Usage

Rate limits and credits

Understand credit costs, rate-limit headers, and retry behavior.

Enums

Reference supported enum values used across filters and request bodies.

Usage Examples

Usage examples for the TopYappers API

Rate Limits

Rate limits for the TopYappers API