ViralApp icon

ViralApp

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

Tracked Account → Get Many

AI-generated

Summary

Retrieves a paginated list of tracked social media accounts with optional filtering and sorting.

Inputs

  • returnAll — If true, retrieves all tracked accounts; otherwise, limits results to the 'Limit' value.
  • limit — Maximum number of tracked accounts to return when 'returnAll' is false. Minimum value: 1. Default: 50.
  • filters.platforms — Filter results by social media platform (instagram, tiktok, youtube).
  • filters.projects — Filter results by project using resource locator (select from list or specify ID via expression).
  • filters.sortCol — Column to sort by (e.g., username, platform, trackingSince). Default: username.
  • filters.sortDir — Sort direction (asc or desc). Default: desc.
  • filters.username — Filter results by account username.
  • options.simplifyOutput — If true, returns a simplified object instead of the full raw response.

Output shape

a list of items, each containing a tracked account object.

When 'returnAll' is true, the node uses pagination (page: 1, perPage: 100) internally. Simplified output includes only id, username, platform, status, maxVideos, lastSyncedAt, createdAt, and videoCount.

Examples

Example 1: Get all tracked accounts for TikTok, sorted by username in descending order.

Resource: Tracked Account, Operation: Get Many, Filters: platforms=[tiktok], sortCol=username, sortDir=desc, returnAll=false, limit=100

Example 2: Retrieve a list of tracked accounts from specific projects with a limit of 25 results.

Resource: Tracked Account, Operation: Get Many, Filters: projects=[project IDs], returnAll=false, limit=25

Example 3: Get all tracked accounts and simplify the output to only essential fields.

Resource: Tracked Account, Operation: Get Many, returnAll=true, options.simplifyOutput=true

Links

Discussion