# TopYappers API

## Docs

- [TopYappers API](https://docs.topyappers.com/index.md): Build creator search, viral content discovery, media remixing, CRM, and outreach workflows with the TopYappers API.
- [Usage Examples](https://docs.topyappers.com/examples.md): Usage examples for the TopYappers API
- [Rate Limits](https://docs.topyappers.com/rate-limits.md): Rate limits for the TopYappers API
- [Creators API v2](https://docs.topyappers.com/creators-api/v2.md): Search creators for free and fetch full profiles with v2 endpoints
- [Available Parameters](https://docs.topyappers.com/creators-api/parameters.md): Available creators API parameters for the TopYappers API
- [Search Creators (v2)](https://docs.topyappers.com/creators-api/endpoint/v2-search.md): Search creators using the same filters as the Creators API. Returns a list of userIds to fetch full profiles.
- [Get Creators by ID (v2)](https://docs.topyappers.com/creators-api/endpoint/v2-get.md): Fetch full creator profiles by passing userIds returned from the search endpoint.
- [Get Creators (v1)](https://docs.topyappers.com/creators-api/endpoint/get.md): Returns full creator profiles matching filters. Query parameters are identical to GET /api/v2/creators/search (search is free and returns IDs only; this endpoint costs credits per creator returned).
- [Overview](https://docs.topyappers.com/viral-content-api/overview.md): Discover viral TikTok content with powerful filtering options
- [Get Viral Posts](https://docs.topyappers.com/viral-content-api/endpoint/post.md): Retrieve viral TikTok content filtered by categories, countries, views, virality and follower ranges, dates, music and hook, AI tag arrays and text-contains fields, and boolean content flags. See `ViralPostsRequest` in components/schemas.
- [Overview](https://docs.topyappers.com/songs-api/overview.md): Access trending songs data, rankings, and chart history
- [Get Songs Data](https://docs.topyappers.com/songs-api/endpoint/get.md): Access trending songs data with various actions. Use the `action` parameter to specify what data to retrieve.
- [Remix API Overview](https://docs.topyappers.com/remix-api/overview.md): Process videos and images with the TopYappers Remix API
- [Upload Video for Remix](https://docs.topyappers.com/remix-api/endpoint/get.md): Process a video from a provided URL. The API will download the video, apply transformations, and remove invisible watermarks.
- [Upload Images for Remix](https://docs.topyappers.com/remix-api/endpoint/image-rewrite.md): Process one or more images from provided URLs. The API will download the images, apply transformations, and remove invisible watermarks.
- [CRM API v2](https://docs.topyappers.com/crm-api/overview.md): Create CRM lists and manage saved creators from your own systems
- [List CRM Lists](https://docs.topyappers.com/crm-api/endpoint/list-lists.md): Returns all active CRM lists for the API key owner's team, including creator counts.
- [Create CRM List](https://docs.topyappers.com/crm-api/endpoint/create-list.md): Creates a CRM list in the API key owner's team. Use `name` for the list name.
- [Get CRM List](https://docs.topyappers.com/crm-api/endpoint/get-list.md)
- [Update CRM List](https://docs.topyappers.com/crm-api/endpoint/update-list.md)
- [Delete CRM List](https://docs.topyappers.com/crm-api/endpoint/delete-list.md): Soft-deletes a CRM list.
- [List CRM Creators](https://docs.topyappers.com/crm-api/endpoint/list-creators.md)
- [Add Creators to CRM List](https://docs.topyappers.com/crm-api/endpoint/add-creators.md): Adds one or more creator IDs to a CRM list. Use `userIds` for all adds. Single-creator adds may include contact metadata such as `contactEmail` and `proposedRate` when `userIds` contains exactly one creator.
- [Check CRM List Membership](https://docs.topyappers.com/crm-api/endpoint/check-creators.md): Checks whether one or more creator IDs already exist in a CRM list.
- [Remove Creator from CRM List](https://docs.topyappers.com/crm-api/endpoint/remove-creator.md): Soft-removes a creator from a CRM list.
- [Update CRM Contact](https://docs.topyappers.com/crm-api/endpoint/update-contact.md): Updates a CRM contact's status and optional contact/deal details.
- [Agent Outreach API](https://docs.topyappers.com/agent-api/overview.md): Access your outreach projects, contacted creators, and email history
- [List Agent Projects](https://docs.topyappers.com/agent-api/endpoint/projects.md): List your active TopYappers outreach projects
- [List Contacted Creators](https://docs.topyappers.com/agent-api/endpoint/contacted-creators.md): List creators contacted by your TopYappers outreach agent
- [List Agent Messages](https://docs.topyappers.com/agent-api/endpoint/messages.md): List sent and received agent email messages
- [Enums](https://docs.topyappers.com/reference/enums.md): Reference lists for API filter values
- [Rate Limits & Credits](https://docs.topyappers.com/reference/rate-limits-credits.md): Understanding API pricing, credits, and rate limits

## OpenAPI Specs

- [openapi](https://docs.topyappers.com/creators-api/openapi.json)

## Optional

- [Get API key](https://www.topyappers.com/profile)