llms.txt Content
# Virlo API
> Social media intelligence API for TikTok, YouTube Shorts, and Instagram Reels. Track viral content, hashtags, trends, and creators with real-time analytics across 21K+ creators daily.
Virlo provides programmatic access to social media analytics data through a REST API. The API supports keyword-based social listening (Orbit), automated niche monitoring (Comet), creator analysis (Satellite), and real-time hashtag/trend/video analytics across three major short-form video platforms.
Base URL: https://api.virlo.ai/v1
Authentication: Bearer token in Authorization header (format: virlo_tkn_<your_key>)
Get your API key: https://dev.virlo.ai/dashboard
All parameter names and response fields use snake_case.
All responses are wrapped in a { "data": { ... } } envelope.
## Billing
Pay-as-you-go prepaid balance. Add funds (minimum $5), use the API, auto top-up keeps you running. No subscriptions. Balance never expires.
Response headers on every request: X-Credits-Used, X-Credits-Remaining, X-Cost, X-Balance-Remaining.
- $0.05: Hashtag endpoints (list, performance, platform-specific)
- $0.25: Video digest endpoints, Trends endpoints, Tracking creation (creator/video)
- $0.50: Orbit queue, Comet creation, Satellite creator lookup, Video Outlier analysis
- Free: Orbit/Comet data retrieval (videos, ads, outliers), Tracking reads, status polling
When balance reaches zero, API returns 402 Payment Required. Auto top-up is enabled by default.
Add funds at https://dev.virlo.ai/dashboard/billing
## Guides
- [Quickstart](https://dev.virlo.ai/docs/quickstart): Get your API key and make your first request
- [Authentication](https://dev.virlo.ai/docs/authentication): API key format and Bearer token usage
- [Pagination](https://dev.virlo.ai/docs/pagination): Offset-based pagination with limit and page params
- [Billing & Pricing](https://dev.virlo.ai/docs/credits): Pay-as-you-go pricing, auto top-up, per-endpoint costs
- [Rate Limits](https://dev.virlo.ai/docs/rate-limits):