How do I list my Minecraft server on AnyServer.pro?

To list your server, sign in to your account, click on the Dashboard, and select 'Add Server'. Fill in your server's name, address, game edition (Java, Bedrock, or Cross-play), description, and categories, then submit. Once verified, your server will appear on our public lists.

How do I integrate server status widgets on my website?

AnyServer.pro provides custom HTML/iframe and image-based widgets showing real-time player counts and status. Navigate to your server detail page, click 'Embed Widget', and copy the generated snippet to paste into your website's code.

What are the API rate limits for developers?

For anonymous users, the API rate limit is 60 requests per minute and 2,000 requests per day. Registered developers with an approved API key receive custom higher quotas (typically starting at 20 requests per minute and 1,000 requests per day) managed directly through their developer settings.

Does AnyServer.pro support Votifier rewards?

Yes, we support both Votifier V1 (RSA encrypted socket payload) and V2 (HMAC-SHA256 authenticated JSON payload) protocols to deliver voting rewards directly to your Minecraft server.

AnyServer.pro

DOCUMENTATION

Guides and API references for AnyServer.pro

Documentation

Getting Started

AnyServer.pro is a high-performance Minecraft server list. Whether you're a player looking for a new community or a server owner looking to grow, our platform provides the tools you need.

For Players

Discover servers using our advanced filters, search by version or category, and vote for your top picks to help them climb the ranks.

For Owners

Add your server to our list, track uptime with our status pages, and use our API to integrate voting directly into your website.

Voting & Ranking

Ranking on AnyServer.pro is primarily determined by votes. Users can vote for a server once every 24 hours.

Daily Reset: Votes reset every 24 hours per user/IP.
Verification: We use advanced anti-bot measures to ensure all votes are legitimate.
Widget: You can embed our voting widgets on your site to make it easier for players to support you.

Widget Embeds

We provide several ways to embed your server's status and voting directly on your website without using slow iframes.

Premium Card Widget

A modern, real-time card showing live player counts and voting. Helps build your community's reputation.

Minimal Button

A simple, professional vote button. Perfect for sidebars and headers.

Tip: You can get your personalized, pre-filled code in your Server Dashboard by clicking "Create Widget".

API Reference

Our REST API allows developers to programmatically access server data and statistics.

Authentication

GET endpoints can be queried anonymously (no authentication needed) under our Anonymous rate limit tier. To increase limits or gain full access, include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can generate an API key in your Developer Portal.

Rate Limiting

To ensure platform stability, we enforce rate limits based on your access tier:

Anonymous (No Auth)

60 req/min

2,000 req/day (tracked per IP)

Standard Developer

20 req/min

1,000 req/day (tracked per key)

Approved Developer

100+ req/min

Custom daily limit

Endpoints

GET /api/configAnonymous / Authenticated

Retrieve global application configuration. Use this to fetch the list of supported Minecraft versions and categories to query/populate search filters.

Key Response Fields:

minecraft_versions: Array of all valid Minecraft versions supported on the platform (e.g. ["1.21.11", "1.21.10", ...])
minecraft_categories: Array of all valid server categories/tags (e.g. ["Survival", "Creative", ...])

GET /api/serversAnonymous / Authenticated

List and search for servers with various filters. Can be queried anonymously.

Query Parameters:

game: mc_java (Java & Cross-play), mc_bedrock (Bedrock & Cross-play), mc_crossplay (Cross-play only)
version: Specific Minecraft version (e.g. 1.20.4, 1.21). Use any to disable.
tags: Comma-separated categories to filter by (e.g. survival,skyblock)
auth_type: any, offline (cracked), online (premium)
sort: random, most_votes, most_players, recent
search: Keyword search (uses fuzzy relevancy scoring matching in name, description, address, and category)
min_players: Minimum online player count
max_players: Maximum online player count
hide_offline: Hide offline listings (default true)
hide_empty: Hide empty servers (default false)
exclude_modded: Exclude servers requiring client-side mods (default false)
verified: true to only fetch verified servers
limit: Max results per page (default: 25, max 5000)
offset: Pagination offset
random_seed: Seed string for stable pagination during random sorting
fields: Optional comma-separated response fields. Bump fields include is_bumped, bumped_at, and monthly_bumps.

Bump & backlink fields:

is_bumped: 1 while the server's two-hour promoted placement is active.
monthly_bumps: Number of successful bumps in the current monthly competition period.
has_backlink: Boolean indicating an approved backlink associated with the server. Returned to authenticated API-key users.

GET /api/servers/:idAnonymous / Authenticated

Get comprehensive details for a specific server, including reviews and screenshots. Can be queried anonymously.

GET /api/statsAnonymous / Approved Only

Retrieve global network statistics, including distribution charts and player counts. Can be queried anonymously.

Version Matching & Ranges

AnyServer features a robust automatic version detection and range expansion engine. When you register a server, our pinging cluster retrieves the server's reported version string and parses it automatically:

How Version Parsing Works

Exact Match Detection: If a server reports a single version like 1.20.4, it is mapped exactly.
Proxy and Multi-version Compatibility: Multi-version networks running BungeeCord, Velocity, or Waterfall are detected and marked accordingly.
Range Expansion: Version ranges like 1.18-1.20 are automatically expanded into a complete list of all intermediate releases (e.g. 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4). This ensures a query for 1.19.2 will successfully find the server.
Software and Modloader Extraction: Modloaders and server implementations (like Spigot, Paper, Purpur, Fabric, or Forge) are detected to identify vanilla-client compatibility.

Searching by Version

Users can filter servers by version in two main ways:

Version Dropdown (Recommended): Selecting a version from the "Version" dropdown on the homepage applies a strict filter via the version query parameter. This queries the database using exact list membership checks (FIND_IN_SET), returning only servers that fully support that version.
Keyword Search: If a user types a version release (e.g. 1.20.4) directly into the search bar, the fuzzy search engine matches against the server name and description, which is useful for servers that explicitly list versions in their titles.

Sign In With AnyServer

Allow your users to log in to your website using their AnyServer.pro account. We use standard OAuth2 Authorization Code flow with optional PKCE support.

1. Create an Application

Go to the Developer Portal and create a new OAuth application. You'll receive a Client ID and a Client Secret.

2. Authorize the User

Redirect your users to our authorization endpoint:

GET https://anyserver.pro/api/oauth/authorize? client_id=YOUR_CLIENT_ID& redirect_uri=YOUR_REDIRECT_URI& response_type=code& scope=profile& state=YOUR_STATE

3. Exchange Code for Token

Exchange the authorization code for an access token via a POST request:

POST https://anyserver.pro/api/oauth/token

Include client_id, client_secret, code, and grant_type=authorization_code in the body.

4. Fetch User Profile

Use the access token to get user details:

GET https://anyserver.pro/api/oauth/userinfo Authorization: Bearer YOUR_ACCESS_TOKEN

Need Help?

Can't find what you're looking for? Reach out to our support team or join our community Discord.

Contact Support Join Discord