Subscription & usage

ViralQuery has one product with two capacity tiers:

• Standard: $59 per month or $590 per year ($49 per month equivalent).
• Pro: $199 per month or $1,990 per year ($166 per month equivalent), with 3x the daily research capacity.

Both tiers include one private workspace and result feeds capped at 25 videos per read. Normal reads do not consume research capacity. Pro adds capacity; it does not expose a different data model.

Checking access and usage

curl https://api.viralquery.com/v1/usage -H "Authorization: Bearer $KEY"
# → {
#     "plan": "viralquery", "billingInterval": "annual", "status": "active", "active": true,
#     "usage": { "daily": { "usedPct": 42 }, "monthly": { "usedPct": 18 } }
#   }

Usage is reported as percentages of your AI budget, never as a scroll allowance: daily.usedPct is live AI spend against the day's budget (it resets at 00:00 UTC), and monthly.usedPct is accumulated spend against roughly 30 days of that budget. There is no per-scroll quota to count down, so normal reads and reused idempotency keys never "use up" a scroll.

GET /v1/usage returns 200 for any valid key; an inactive subscription reports active: false and its status. Plan-gated research calls receive 402 subscription_required. Research capacity refreshes daily; a day that reaches its capacity (100%) resumes at the reset rather than billing extra. Only one scroll runs or queues per workspace at a time.