Virlo

Quickstart

Check your API key with a free request, then pull today's top trends.

At a glance
What it does
Gets you from sign-up to your first results.
You send
Two requests with your API key.
You get back
Your balance, then today's top trends.
Cost
$0.25 total. The balance check is free.

Before you start

Someone gave you a key? Skip steps 1 to 3.

  1. Create an account at dev.virlo.ai/signup.
  1. Add funds on the Billing page. You need a balance to generate a key.
  2. Click Generate Key on the API keys page and copy the key. It is shown only once.

Paste your whole key over YOUR_API_KEY; it already starts with virlo_tkn_. Mac: cURL tab in Terminal. Windows: the Windows tab here, in PowerShell. For cURL examples on other pages, use Git Bash.

Rather not use a terminal? Once you have a key, pick Trends Digest in the dashboard playground. Same request, same $0.25.

Check your balance

This free call tests your key. If you see your balance, it works.

You send
GET
/v1/account/balance
curl https://api.virlo.ai/v1/account/balance \
  -H "Authorization: Bearer YOUR_API_KEY"
You get back
{
  "data": {
    "balance": "$25.00",
    "credits_remaining": 2500,
    "status": "active"
  }
}

balance is in dollars; credits_remaining is the same in credits (1 credit = $0.01). A 401 means the key is missing, mistyped, or revoked: see Authentication.

Returns today's top worldwide trends, ranked, in about a second. It costs $0.25 each time. Under $0.25 left? You get an insufficient_credits error.

You send
GET
/v1/trends/digest
curl https://api.virlo.ai/v1/trends/digest \
  -H "Authorization: Bearer YOUR_API_KEY"
You get back
{
  "data": [
    {
      "id": "0a3dd8f0-7bb2-4de0-a7e2-74eb82d851ae",
      "title": "Trends for Sep 24",
      "region": "global",
      "local_date": "2026-09-24",
      "trends": [
        {
          "ranking": 1,
          "trend": {
            "id": "503b791b-663a-4ae0-bccc-6d3329707f1e",
            "name": "Meta's new VR glasses lineup (Ray-Ban Audio + no camera + 5K micro OLED visuals) & Meta Connect 2026 reveals",
            "description": "On September 23, 2026, Meta unveiled its latest VR wearables at the Meta Connect conference, including the Ray-Ban Meta Audio glasses, which lack a camera and focus on audio capabilities, and the advanced Meta VR Glasses featuring 5K micro-OLED visuals."
          },
          "momentum": {
            "status": "new",
            "views_per_hour": 131006
          },
          "top_exemplars": [
            {
              "url": "https://www.youtube.com/shorts/p4BUXLcRvKk",
              "platform": "youtube",
              "views": 3660687,
              "author": {
                "username": "@actuallycarterpcs"
              }
            }
          ]
        }
      ]
    }
  ]
}
  • data: one daily list of 15 to 20 topics, up to 5 example videos each.
  • A new worldwide list starts at 7:00 New York time; trends are added at 13:00 and 19:00. Before 7:00 you get yesterday's, even if title says today; check local_date.
  • momentum.status is new, rising, steady, or fading (momentum is null until measured).
  • top_exemplars are sorted by all-time views, so older videos can appear. Paid posts come last with is_paid: true; treat them as ads, not organic wins.

Add ?region=us for one country (or gb, au, sg), or ?top_exemplars=0 for a shorter reply. See Pop culture & News.

See what you paid

To see the charge, add -i after curl. Look for these (curl may print them in lowercase):

Response headers

X-Cost: 0.25
X-Credits-Used: 25
X-Balance-Remaining: 24.75
X-Credits-Remaining: 2475
  • X-Cost is the charge in dollars, with no $. Free calls show 0.00.
  • X-Balance-Remaining is your balance afterward; the Credits headers repeat both in credits.
  • Remaining headers can appear on free calls too (never on the balance check), so only X-Cost shows what you paid.
  • Failed requests are never charged and carry none of these headers.

What's next?

Was this page helpful?