> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topyappers.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TopYappers API

> Build creator search, viral content discovery, media remixing, CRM, and outreach workflows with the TopYappers API.

# TopYappers API

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

<CardGroup cols={2}>
  <Card title="Creators API" icon="users" href="/creators-api/v2">
    Search creators for free, then fetch full profiles for the creators you need.
  </Card>

  <Card title="Viral Content API" icon="flame" href="/viral-content-api/overview">
    Find viral posts, creative patterns, and content ideas for research workflows.
  </Card>

  <Card title="Media Remix" icon="wand-sparkles" href="/remix-api/overview">
    Process video and image URLs through the Remix API with optional transformation parameters.
  </Card>

  <Card title="CRM API" icon="database" href="/crm-api/overview">
    Manage creator lists, check membership, and update contact records.
  </Card>

  <Card title="Agent Outreach" icon="send" href="/agent-api/overview">
    Retrieve outreach projects, contacted creators, and saved email messages.
  </Card>

  <Card title="Songs API" icon="music" href="/songs-api/overview">
    Discover trending songs and audio context for content research.
  </Card>
</CardGroup>

## Quickstart

1. Create or copy an API key from your [TopYappers dashboard](https://www.topyappers.com/profile).
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.

```bash theme={null}
curl "https://api.topyappers.com/api/v2/creators/search?mainCategory=technology&followersMin=10000" \
  -H "x-ty-api-key: YOUR_API_KEY"
```

<Tip>
  Use `GET /api/v2/creators/search` to discover creator IDs for free, then call `POST /api/v2/creators/get` when you need full profiles.
</Tip>

## Common Paths

<CardGroup cols={2}>
  <Card title="Search creators" icon="magnifying-glass" href="/creators-api/endpoint/v2-search">
    Free creator discovery with filters for niche, source, country, follower count, and more.
  </Card>

  <Card title="Fetch full creators" icon="user-round-search" href="/creators-api/endpoint/v2-get">
    Retrieve complete creator profiles by ID.
  </Card>

  <Card title="Process videos" icon="video" href="/remix-api/endpoint/get">
    Submit a public video URL for Remix API processing.
  </Card>

  <Card title="Process images" icon="images" href="/remix-api/endpoint/image-rewrite">
    Submit one image URL or a batch of image URLs for Remix API processing.
  </Card>
</CardGroup>

## Usage

<CardGroup cols={2}>
  <Card title="Rate limits and credits" icon="gauge" href="/reference/rate-limits-credits">
    Understand credit costs, rate-limit headers, and retry behavior.
  </Card>

  <Card title="Enums" icon="list-tree" href="/reference/enums">
    Reference supported enum values used across filters and request bodies.
  </Card>
</CardGroup>