Public API Documentation

REST API for accessing RuneScape 3 player statistics, clan data, leaderboards, and competitions. All endpoints are public - no authentication required!

Quick Reference

Base URL

https://runestats.info/api/v1

Authentication

None required

Response Format

{ success: true, data: {...} }

Error Format

{ success: false, error: {...} }

Rate Limits

Tier	Rate Limit	How to Get
No API Key	`10 req/min`	Anyone
With API Key	`100 req/min`	Premium + API subscribers

To use an API key, include the X-API-Key header in your requests.

Endpoints

Players

Player stats, snapshots, XP gains, and achievements

5 endpoints

Clans

Clan info, members, gains, and hiscores

5 endpoints

Leaderboards

Skill leaderboards and XP gains rankings

3 endpoints

Competitions

Public competitions and rankings

3 endpoints

Events

HCIM deaths and name changes

2 endpoints

Interactive API Docs

Try the API directly in your browser with our interactive playground.