Quickstart
Make your first viralquery call in under a minute.
You'll need a key (see Get an API key).
export KEY=sk_viralquery_...
# Check your balance (free op)
curl https://api.viralquery.com/v1/balance \
-H "Authorization: Bearer $KEY"
# → { "accountId": "acc_...", "creditsCents": 2000, "spentCents": 0 }
# Search the library by meaning
curl -G https://api.viralquery.com/v1/library/search \
-H "Authorization: Bearer $KEY" \
--data-urlencode "query=skincare routine hook" \
--data-urlencode "limit=5"
# → { "results": [ { "id": "vid_...", "score": 0.82, ... } ] }Out of credits? The next call returns 402 with a topupUrl — see Credits & billing.