ViralApp icon

ViralApp

Interact with ViralApp API for video analytics on TikTok, Instagram, and YouTube

General Data → Get Top Accounts

AI-generated

Summary

Retrieves a list of the highest-performing tracked accounts within a specified date range and metric.

Inputs

  • dateRangeFrom (required) — Start date (YYYY-MM-DD) for the analytics period. Defaults to 14 days ago.
  • dateRangeTo (required) — End date (YYYY-MM-DD) for the analytics period. Defaults to today.
  • filters — Optional filters to narrow results. Includes Account Names or IDs, Content Types (video/slideshow), Limit (max results), Metric (e.g., viewCount, engagementRate), Only Published toggle, Platforms (Instagram, TikTok, YouTube), and Project Names or IDs.
  • options.simplifyOutput — If true, returns a simplified list of top accounts containing ID, platform, username, follower count, total videos, total views, and engagement rate.

Output shape

A list of top performing accounts

Returns raw data by default; enabling 'Simplify Output' returns a reduced set of fields. Results are sorted based on the selected metric.

Examples

Example 1: Get top 10 accounts by view count over the last 30 days

Set date range to 30 days ago to today, Metric to 'View Count (Lifetime)', Limit to 10, and leave other filters empty.

Example 2: Find top accounts by engagement rate on TikTok within a specific project

Set Date Range, Metric to 'Engagement Rate (Lifetime)', Platforms to 'tiktok', and select the desired Project from the list.

Links

Discussion