ViralApp icon

ViralApp

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

Video Data → Get Many

AI-generated

Summary

Retrieves a paginated list of tracked video analytics records.

Inputs

  • Return All — Whether to return all results or only up to a given limit.
  • Limit — Max number of results to return (default 50, max 100 when not using Return All).
  • Filters — Collection of filters to narrow results.
  • Expand — Select related resources to expand in the response (e.g., projects).
  • Simplify Output — Whether to return a simplified version of the response instead of raw data.

Output shape

a list of items, each containing video analytics data.

When 'Simplify Output' is enabled, items contain only core fields (id, platformVideoId, platform, title, accountUsername, viewCount, likeCount, commentCount, shareCount, publishedAt). Expanded projects return full project objects instead of IDs.

Examples

Example 1: Retrieve the top 25 tracked videos sorted by view count.

Set Limit to 25, Sort Column to 'View Count', Sort Direction to 'Descending'.

Example 2: Fetch all tracked videos from the last 7 days for a specific project.

Set Date Range From/To, add Project ID to filters, and check 'Return All'.

Example 3: Get a simplified list of videos for Instagram accounts only.

Set Platforms to 'Instagram', check 'Simplify Output' to reduce payload size.

Links

Discussion