vvvs.uk API

Build bots, widgets and tools on top of vvvs.uk: read profiles and stats, update your status from anywhere, upload files.

$10per month

How it works

SubscribePay $10 with PayPal or crypto (30 days each time — renew whenever you want), or open a ticket for other ways.

Make a keyDashboard → Developer → Create key. It's shown once — keep it secret.

Call the APISend Authorization: Bearer vv_live_… with every request.

Renew monthlyWhen it ends, calls return 402 until you renew.

Endpoints

Method	Path	What it does
GET	`/api/v1/me`	Your account: profile, views, likes, badges, subscription end
PATCH	`/api/v1/me`	Change displayName, bio, bios[], status or location `{"status":"🎮 live on twitch","bio":"hello world"}`
GET	`/api/v1/me/stats`	Your analytics: visitors per day, link clicks, countries, referrers
GET	`/api/v1/users/{username}`	Anyone's public profile (private pages are hidden)
GET	`/api/v1/explore?sort=views\|likes\|new&limit=25`	The leaderboard
GET	`/api/v1/templates?sort=top\|new\|used`	Community templates
GET	`/api/v1/giveaways`	Live and past giveaways
GET	`/api/v1/stats`	Site numbers: members, VIP, visitors, version
POST	`/api/v1/upload`	Upload a file (multipart, field "file") to your storage

Example

curl https://vvvs.uk/api/v1/users/snow \
  -H "Authorization: Bearer vv_live_your_key"

curl -X PATCH https://vvvs.uk/api/v1/me \
  -H "Authorization: Bearer vv_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"status":"🎧 listening to music"}'

Limits: 120 requests per minute per key (see the X-RateLimit-* headers). Errors come back as {"error": "…"}. Don't share keys; abuse gets the subscription removed.