API Documentation

Access game statistics programmatically through our REST API endpoints.

Base URL

Database Access

For personal projects or offline analysis, you can download the complete SQLite database directly:

/games.db

The database is updated hourly and contains all game statistics, rankings, and analytics data. You can use any SQLite client to query the database directly.

Authentication

No authentication is required to access the API. All endpoints are publicly available.

Rate Limiting

Please be mindful of our rate limits:

  • 100 requests per minute per IP address
  • Analytics data is cached for 5 minutes
  • Game data is cached for 1 hour
  • Rankings are updated hourly

Endpoints

Analytics Endpoints

Endpoints for retrieving analytics and statistics

Games Endpoints

Endpoints for retrieving game information

Rankings Endpoints

Endpoints for retrieving game rankings and leaderboards

System Endpoints

Endpoints for retrieving system information

Error Handling

The API uses standard HTTP status codes to indicate the success or failure of requests:

  • 200 - Success
  • 400 - Bad Request
  • 404 - Not Found
  • 429 - Too Many Requests (Rate limit exceeded)
  • 500 - Internal Server Error

Data Availability

Please note that our data collection has the following characteristics:

  • Initial tracking: September 28-29, 2024
  • Continued tracking until December 14, 2024
  • Full system deployment: January 5, 2025 onwards
  • Data is updated in real-time
  • Analytics are pre-calculated hourly
  • Rankings are updated hourly

Support

For support or questions, please visit our GitHub repository.