Virlo terms in plain words. Three change meaning between pages.

Research

• Content Research Agent: collects short-form videos on your topic from TikTok, YouTube, and Instagram, then reports what's working.
• One-time or recurring (is_recurring): a one-time agent runs once, for $0.50 at creation. A recurring agent costs $0.50 per run.
• Cadence: how often a recurring agent runs: daily, weekly, monthly, or a cron schedule up to once a day. Tracking uses scrape_cadence.
• Data Intelligence: an AI breakdown of each video, like its hook, format, and tone. It adds $1.00 per agent run, or $0.25 per creator lookup.

Lookups

• Lookup: a one-off deep dive on a creator, sound, hashtag, or video, for $0.50 to $2.50. Paths say satellite, the API's name for lookups.

Tracking

• Check (also cycle or scrape): one $0.25 round where Virlo fetches a tracked creator's or video's latest numbers and writes an AI report.
• Snapshot: the numbers saved at one check. An audience snapshot is different: a $0.50 profile of a creator's commenters.

Billing

• Credit: 1 credit = $0.01. Some headers and fields count in credits: X-Credits-Used: 50 equals X-Cost: 0.50.

Technical

• Job ID: the ID you get right away when you start background work (a lookup's job_id, an agent's id), used to check on it.
• Polling: checking every 15 seconds, or whatever retry_after_seconds says, until the job is done. It's free.
• Finalized: finalized: true means the results are ready, including follow-ups like an agent's AI report. status: "completed" alone isn't enough.
• Webhook: a message Virlo sends to your web address when something happens, like an agent run finishing, so you don't have to poll.
• Response envelope: successful responses wrap results in {"data": ...}. Errors, and calls under /v1/webhooks, aren't wrapped.

Words that change meaning

Outlier: far more views than expected, and "expected" differs by page. The median is a creator's typical views.

• Content Research Agents and hooks: outlier_ratio is views ÷ followers. Hooks use one video's views, creator outliers a creator's average.
• Creator lookup: a video over outlier_threshold times the median (default 2).
• Video outlier check: outlier_score is views ÷ median. 3 or more is viral, 10 or more mega_viral.
• Tracking and webhooks: a video over 3 times the median (a breakout video).

weighted_score: two different scores share this name, so never compare them.

• On Content Research Agents and hooks, it's the Virality Score: how far views beat followers, with extra credit for big accounts. 18 or more is strong, 35 or more exceptional.
• On lookups, tracking, and webhooks, it ranks outlier videos, giving big creators more credit.

For developers: the formulas

Virality Score: ln(views ÷ followers) × ln(followers). Lookups and tracking: ln(views ÷ median) × ln(median).

Run: on Content Research Agents, one round of collecting videos. On lookups, a saved result, free to re-read any time. Each paid lookup makes a new run. Its run_id is the job_id.