Overview

Discover viral TikTok content with powerful filtering options

Viral Content API

The Viral Content API allows you to discover and analyze viral TikTok content. Filter by categories, countries, view counts, virality scores, date ranges, and music to find trending content that matches your criteria.

Key Features

Category Filtering

Filter viral posts by content categories like comedy, dance, food, and more.

Geographic Targeting

Find viral content from specific countries and regions.

Virality Scoring

Filter by our proprietary virality score to find the most engaging content.

Music Discovery

Search for viral posts using specific trending sounds and music.

Authentication

All requests require an API key passed in the x-ty-api-key header.

curl -X POST https://www.topyappers.com/api/v1/viral-content \
  -H "x-ty-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": ["comedy"],
    "viewsMin": 100000,
    "page": 1,
    "pageSize": 12
  }'

Request Parameters

Parameter	Type	Description
categories	string[]	Filter by content categories: Arts, Automotive, Beauty & Personal Care, Business, Comedy, Education, Entertainment, Fashion, Film, Fitness, Food, Gaming, Health, Humor, Lifestyle, Music, News & Media, Pets, Science, Sports, Technology, Travel, and more (57 total)
countries	string[]	Filter by countries (full names): United States, United Kingdom, France, Germany, Japan, India, Brazil, Canada, Australia, and 134 more
viewsMin	integer	Minimum number of views
viewsMax	integer	Maximum number of views
viralityScoreMin	float	Minimum virality score (0-1)
viralityScoreMax	float	Maximum virality score (0-1)
dateCreatedFrom	string	Posts created on or after this date (YYYY-MM-DD)
dateCreatedTo	string	Posts created on or before this date (YYYY-MM-DD)
musicTitle	string	Filter by music/sound title
page	integer	Page number (default: 1)
pageSize	integer	Results per page (default: 12, max: 100)

Sorting

The Viral Content API does not take sortBy / sortOrder in the request body. Results are always returned in a fixed order:

• Primary: post creation time (date_created on the post), newest first (descending).

So the first items on page 1 are the most recently created viral posts that match your filters. Use dateCreatedFrom / dateCreatedTo to narrow the time window; ordering within that window remains newest first.

Pricing

Each request costs 1 credit per returned content. For example, if you request pageSize: 12 and receive 12 results, that costs 12 credits.

Rate Limits

The Viral Content API is subject to rate limits. If you exceed the limit, you’ll receive a 429 response with a retryAfter field indicating how long to wait before retrying.