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:
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
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", ...])
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). Useanyto 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,recentsearch: Keyword search (uses fuzzy relevancy scoring matching in name, description, address, and category)min_players: Minimum online player countmax_players: Maximum online player counthide_offline: Hide offline listings (defaulttrue)hide_empty: Hide empty servers (defaultfalse)exclude_modded: Exclude servers requiring client-side mods (defaultfalse)verified:trueto only fetch verified serverslimit: Max results per page (default: 25, max 5000)offset: Pagination offsetrandom_seed: Seed string for stable pagination during random sorting
Get comprehensive details for a specific server, including reviews and screenshots. Can be queried anonymously.
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.20are 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 for1.19.2will 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
versionquery 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:
3. Exchange Code for Token
Exchange the authorization code for an access token via a POST request:
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:
Need Help?
Can't find what you're looking for? Reach out to our support team or join our community Discord.