# Subscription & usage (/docs/credits-and-billing)



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 [#checking-access-and-usage]

```bash
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.