Personalized results

ViralQuery reads from the calling key's personalized workspace. These endpoints do not accept an app, account, workspace, tag, platform, or ranking query. Run a scroll to update the tables, then let your agent or team filter the returned fields for the task at hand.

Every result endpoint returns at most 25 items. Pass limit only when you want fewer.

Library

GET /v1/library returns the latest videos selected for the workspace, including the original post URL, source metadata, first/last-seen times, and the latest observed public metrics.

Outliers

GET /v1/outliers returns deterministic view outliers. The score is the video's observed views divided by the median views in the scroll that found it. The response includes the baseline and sample count so an agent can judge the strength of the signal.

Trends

GET /v1/trends compares observations across completed scrolls. Before the workspace has two completed scrolls, it returns status: "insufficient_history" and an empty trends array rather than inventing a trend.

Hooks

GET /v1/hooks returns stored visual, spoken, and on-screen-text hooks only for videos already in the personalized library. A video without hook evidence is omitted.

Usage

GET /v1/usage reports the current monthly scroll period and the included, purchased, reserved, completed, and remaining counts. Starting a scroll reserves one slot. Completion converts that reservation to completed usage; dispatch or worker failure releases it.