Skip to main content

​
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

ParameterTypeDescription
categoriesstring[]Filter by content categories. See available categories
countriesstring[]Filter by countries (full names). See available countries
viewsMinintegerMinimum number of views
viewsMaxintegerMaximum number of views
viralityScoreMinfloatMinimum virality score (0-1)
viralityScoreMaxfloatMaximum virality score (0-1)
dateCreatedFromstringPosts created on or after this date (YYYY-MM-DD)
dateCreatedTostringPosts created on or before this date (YYYY-MM-DD)
musicTitlestringFilter by music/sound title
pageintegerPage number (default: 1)
pageSizeintegerResults per page (default: 12, max: 100)

​
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.