The Viral Outliers CLI

One command per API skill, generated from the same registry as the docs, so it never lags the API. JSON on stdout, credit metering on stderr, and --wait for jobs that take a while. Built for terminals, CI, and shell-native agents such as Claude Code.

Install

npm install -g viral-outliers     # Node 20 or newer, no other dependencies
# or run it without installing:
npx viral-outliers commands

Source and issues: github.com/Viral-Outliers/cli.

Authenticate

viral-outliers login --key so_live_YOUR_KEY   # validates the key and stores it (0600) in your config dir
viral-outliers whoami                       # credit balance

The key is resolved in this order: --key, the VIRAL_OUTLIERS_API_KEY environment variable, then the stored config. No key yet? Run any billable command anyway: the API answers 402 with a payment link that gives you a key without an account (how that works), or create one at Settings, API Keys.

Examples

viral-outliers search-outliers --query "home workout" --platforms tiktok --min-outlier-score 5
viral-outliers get-post <postId> --include-transcript=false
viral-outliers request-transcript --url https://www.tiktok.com/@creator/video/123 --wait
viral-outliers compare-profiles --handles tiktok:creator_a --handles instagram:creator_b
viral-outliers create-topup-link --pack-id pack_s        # free: a Stripe link for the account owner
viral-outliers search-outliers --body '{"query":"stoic quotes","pageSize":50}' --compact --quiet

• Repeatable list flags also accept comma-separated values: --platforms tiktok,youtube.
• --body takes raw JSON and is merged over the flags, so any parameter the API accepts can be sent.
• --wait polls the free job endpoint until the job finishes, then fetches the result (a transcript fetch costs 1 credit).
• Every billable response prints credits: charged=N balance=M to stderr (silence it with --quiet). 1 credit = $0.01.

Exit codes

Commands

Flags marked * are required. Run viral-outliers help <command> for every flag with its description.

Billable

Free