REST API Access
Every subscription tier unlocks our REST API. Search players, browse clans, analyze matches, explore ladder stats — all programmatically.
# Search players by nickname
curl -s "https://peluka.info/voobly/api/v1/players/search?q=demo_user" \
-H "Authorization: Bearer <your_jwt>"
# Response
[
{
"idPlayer": 123428969,
"nickname": "demo_player",
"clanTag": "CSA",
"lastOnline": "2026-06-10",
"active": true
}
]
What you get with API access
| Endpoint |
Free |
Noob |
Rook |
Inter |
XP |
| Players search + list | — | Yes | Yes | Yes | Yes |
| Clans + matches | — | Yes | Yes | Yes | Yes |
| Stats overview | — | Yes | Yes | Yes | Yes |
| Player profile + match details | — | Yes | Yes | Yes | Yes |
| Civilization stats per player | — | — | Yes | Yes | Yes |
| Ladder rating history | — | — | — | Yes | Yes |
| Swagger documentation | Yes | Yes | Yes | Yes | Yes |
Explore the API documentation (Swagger)
FAQ
How do I get API access?
After subscribing (Noob tier or above), you'll receive an onboarding email within 48 hours with your Application ID, the API base URL, and examples on how to authenticate and make your first API call.
How does authentication work?
The API uses JWT tokens via FusionAuth. You authenticate once with your credentials and Application ID to get a token, then include it as a Bearer token in all API requests.
What about the Voobly API cache?
Data from Voobly's API is cached for the number of days specified by your tier (3-5 days). This means your first search for a player calls Voobly live, but subsequent searches are instant from our cache. This keeps the service fast and within Voobly's API limits.
Can I get Noob tier for free?
Yes! If you have a Voobly developer API key, register it in your profile to unlock Noob tier at no cost. Your key helps us increase the global API limit for everyone.
Get your Voobly API key at: voobly.com
Subscriptions
Subscriptions are managed through Patreon. Coming soon.