Downloads API - Overview

The Statsly Downloads API provides programmatic access to download the Statsly plugin for your Minecraft server. All endpoints are public and require no authentication, making it easy to integrate plugin downloads into scripts, automation tools, or server management systems.

What is the Downloads API?

The Downloads API allows you to:

Download the latest plugin version for your server software
Get metadata about available plugin versions
Download specific plugin versions by ID
Filter by server software and Java version
Automate plugin updates

Public API (no authentication required)
Latest version detection
Server software filtering
Java version filtering
Direct JAR file downloads
Metadata endpoints for integration

Base URL

All API requests should be made to:

https://api.statsly.org

Quick Start

Download the latest plugin for PaperMC:

curl -O -J "https://api.statsly.org/api/plugin-versions/download/latest/PaperMC"

Get metadata about the latest version:

curl "https://api.statsly.org/api/plugin-versions/latest/PaperMC"

API Structure

The Downloads API is organized into several endpoint categories:

Download Endpoints

Direct file downloads for plugin JAR files:

Download latest version by server software
Download latest version by server software + Java version
Download specific version by ID

Metadata Endpoints

Get information about plugin versions without downloading:

List all plugin versions
Get latest version metadata
Query version information

Authentication

No authentication required! All Downloads API endpoints are public and accessible without any API keys or tokens.

Response Formats

File Downloads

Download endpoints return JAR files with the following headers:

Content-Type: application/java-archive
Content-Disposition: attachment; filename="Statsly-1.0.jar"
Content-Length: <file-size>

JSON Responses

Metadata endpoints return JSON with version information:

{
  "version": {
    "id": "plugin-1234567890-abc123",
    "serverSoftware": ["PaperMC", "Spigot"],
    "pluginVersion": "1.0.0",
    "javaVersion": "17",
    "minecraftVersion": "1.20.1",
    "fileName": "Statsly-1.0.jar",
    "fileSize": 1024000,
    "isLatest": {
      "PaperMC": true
    }
  }
}

Rate Limiting

The Downloads API is subject to rate limiting:

100 requests per 15 minutes per IP address
Rate limit headers included in responses
429 Too Many Requests if exceeded

Next Steps

Support

For questions or issues: