viral.app

Get an aggregated time series (day/week/month buckets) of a tracked account's metrics: views, likes, comments, shares, bookmarks, posts, paid/organic views, engagement rate, and follower/following levels over time.

get_account_history

Get organization-wide KPI metrics (views, likes, comments, shares, engagement) across all tracked accounts and videos for a date range. Best first call for questions like 'how did we perform last week'.

get_analytics_kpis

Get the organization's top performing tracked social accounts for a date range, ranked by metric gains.

get_top_accounts

Get the organization's top performing creators (Creator Hub) for a date range, ranked by metric gains across their accounts.

get_top_creators

Get the organization's top performing tracked videos for a date range, ranked by metric gains (e.g. views). Use to answer 'which videos popped'.

get_top_videos

List recent tracking sync runs (queued/running/completed/failed). Use after add_tracked_accounts or refresh_* tools to check whether syncs finished; filter by eventIds returned from those calls.

get_tracking_status

Get analytics detail for a single tracked video by platform (tiktok | instagram | youtube | facebook | snapchat) and the platform's native video ID.

get_video

Get the time-series metrics history (views/likes/comments/shares over time) for a single tracked video. Pass the metrics to return and, optionally, a day/week/month aggregation. Use for trend questions about one video.

get_video_history

Returns how many automated tag assignments this workflow currently owns.

get_tag_workflow_impact

Lists active account-level tag assignments managed from Accounts.

list_account_tag_rules

List tracked social accounts with aggregated analytics metrics. Supports filtering, sorting, and pagination.

list_accounts

List creator campaigns (Creator Hub), including status and configuration. Use with list_creators to answer campaign staffing questions.

list_campaigns

List creators managed in the Creator Hub, including linked user info and account assignments.

list_creators

List the organization's projects (named groupings of tracked accounts used to segment analytics).

list_projects

Retrieves paginated tags scoped to the active organization.

list_tags

Retrieves tags for up to 100 videos in one call, keyed by `platform:platformVideoId`. Videos without tags map to an empty array.

list_video_tags_bulk

List the social accounts the organization currently tracks (tracking configuration view: platform, username, max videos, competitor flag). For performance numbers use list_accounts instead.

list_tracked_accounts

List individually tracked videos (tracking configuration view). For analytics metrics use list_videos instead.

list_tracked_videos

Retrieves tags assigned to a single video.

list_video_tags

Retrieves the distinct video-level tags (tags on at least one of the account's videos that are not account-level tag rules) for up to 100 accounts in one call, keyed by account id. Accounts without such tags map to an empty array.

list_account_video_tags_bulk

List tracked videos with their analytics metrics (views, likes, comments, shares, engagement). Supports filtering, sorting, and pagination. Platforms: tiktok, instagram, youtube.

list_videos

Lists latest preview/backfill runs for an workflow.

list_tag_workflow_runs

Lists all tag workflows for the active organization.

list_tag_workflows

Fetch a fresh public account profile directly from the platform by username (any account, not just tracked ones). ⚠️ Spends 3 credits per call. Prefer list_accounts for tracked accounts. Call without confirm for a quote; re-call with confirm: true to execute.

live_get_account

Fetch an account's recent videos directly from the platform. Requires the platform-native account id (get it via live_get_account) — except Snapchat, which has no id-based lookup: pass the account handle as the id. ⚠️ Spends 3 credits per page. Quote-then-confirm.

live_get_account_videos

Search hashtags directly on TikTok or Instagram. ⚠️ Spends 3 credits per page. Quote-then-confirm.

live_search_hashtags

Search accounts/creators directly on the platform by name or handle. ⚠️ Spends 3 credits per page. Quote-then-confirm.

live_search_users

Fetch a single video's fresh metrics directly from the platform by platform-native video id. ⚠️ Spends 3 credits per call. Prefer get_video for tracked videos. Quote-then-confirm.

live_get_video

Search videos directly on TikTok, Instagram, or YouTube (fresh upstream results, e.g. for trend or competitor research). ⚠️ Spends 3 credits per page. Quote-then-confirm.

live_search_videos

Evaluates rule conditions and returns impact counts without persisting changes.

preview_tag_workflow

Trigger an immediate re-sync of tracked accounts instead of waiting for the schedule. Call without confirm to get a credit quote first; re-call with confirm: true to execute. Track progress via get_tracking_status using the returned eventIds.

refresh_tracked_accounts

Trigger an immediate re-sync of individually tracked videos (not videos that belong to tracked accounts). ⚠️ Spends 3 credits per video. Call without confirm for a quote; re-call with confirm: true to execute.

refresh_tracked_videos

Removes a video-level tag from every video of the account: manual assignments are deleted and automated ones are suppressed so rules do not re-add them.

remove_tracked_account_tag_from_all_videos

Removes tags from a single video.

remove_video_tags

Resolves tag metadata for a list of tag IDs.

resolve_tags

Returns frequently used tags plus system defaults for quick assignment.

suggest_tags

Start tracking new social media accounts for the organization. Accounts the organization already tracks are skipped and left completely unchanged (their existing video limit is kept, no re-sync, no quota consumed) and are reported under alreadyTracked with their current limit. Write operation: consumes plan quota and triggers an initial sync for newly added accounts only.

add_tracked_accounts

Updates account-level tag rules and bulk applies them to existing videos.

set_tracked_account_tags

Updates an organization tag.

update_tag

Updates an existing workflow.

update_tag_workflow