ViralAppInstall

Summary

Retrieves a paginated list of tracked individual videos from ViralApp, supporting filtering by search terms, platform, and sorting options.

Inputs

• returnAll — Whether to return all results. If true, the node will paginate through all pages automatically.
• limit — Maximum number of results to return when returnAll is false. Default is 50. Minimum value is 1.
• filters — A collection of filters to narrow down results. Supports search by video ID or title, filtering by platform (Instagram, TikTok, YouTube), and sorting by various columns (e.g., platform, username, tracking date).
• options — A collection of options. Currently supports 'simplifyOutput', which returns a simplified version of the response data instead of the raw API payload.

Output shape

A list of items, each representing a tracked video with fields such as id, platform, platformVideoId, username, status, trackingSince, analyticsLoadAt, lastErrorCode, and addedBy.

If 'simplifyOutput' is enabled in options, the returned data is reduced to core fields (id, platformVideoId, platform, status, lastSyncedAt, createdAt, viewCount, engagementRate). Large datasets may take time to process. The API uses page-based pagination.

Examples

Example 1: Retrieve a list of all tracked TikTok videos sorted by platform in descending order, returning all results.

Resource: Tracked Individual Video, Operation: Get Many, Filters: Platforms=['tiktok'], Sort Column='platform', Sort Direction='desc', Return All=true

Example 2: Get up to 20 tracked videos, filtering by a search term and sorting by the username.

Resource: Tracked Individual Video, Operation: Get Many, Filters: Search='viral video', Sort Column='username', Sort Direction='desc', Limit=20

Links

• n8n community nodes installation guide