Minecraft Server Status Scraper 🟩

Check any Minecraft server in seconds — players online, version, MOTD, software, plugins, mods and icon — for both Java Edition and Bedrock Edition. No API key, no login, no proxies.

This Apify actor turns a list of Minecraft server addresses into a clean, structured dataset. Feed it mc.hypixel.net, play.cubecraft.net or a thousand community servers, and get back one row per server with everything you need to build a server list, a monitoring dashboard or an uptime report.

---

What this Minecraft server scraper does

• ✅ Java Edition status — players online/max, version string, protocol name & number, server software, MOTD, plugins, mods, EULA-block flag and favicon presence
• ✅ Bedrock Edition status — same core fields plus the reported gamemode
• ✅ Offline servers included — unreachable servers still return a row with online: false so you can chart downtime instead of losing the data point
• ✅ Player sample — up to 20 visible player names when the server exposes its player list
• ✅ Clean MOTD — the colour-coded Minecraft MOTD is stripped of formatting codes and joined into a single readable line
• ✅ Batch friendly — up to 2,000 hosts per run, checked concurrently in batches of 50
• ✅ Datacenter-clean — runs on standard Apify proxies or no proxy at all

Use cases

Use case	How this actor helps
Minecraft server monitoring	Schedule the actor every 5–15 minutes and alert when online flips to false or players_online collapses.
Minecraft server lists	Populate a server-list website or Discord bot with live player counts, MOTDs and versions without maintaining your own ping infrastructure.
Gaming dashboards	Push results into Google Sheets, BigQuery or Grafana to visualise player trends across your network and your competitors.
Uptime & SLA reporting	Build a historical uptime record for hosting customers, network owners or your own community.

Input

Field	Type	Default	Description
mode	select	servers	servers for Java Edition hosts, bedrock for Bedrock/Pocket Edition hosts.
hosts	array	["mc.hypixel.net","play.cubecraft.net"]	Server addresses, one per line. Plain hostnames like mc.hypixel.net, optionally with a port (example.com:25566).
maxItems	integer	200	Hard cap on how many servers are checked in this run (max 2,000).

{
  "mode": "servers",
  "hosts": ["mc.hypixel.net", "play.cubecraft.net", "mc.mineplex.com"],
  "maxItems": 200
}

Output

One dataset item per server. Every field is nullable — offline servers only return a handful of them.

{
  "host": "mc.hypixel.net",
  "online": true,
  "ip": "172.65.197.160",
  "port": 25565,
  "hostname": "mc.hypixel.net",
  "version": "Requires MC 1.8 / 1.21",
  "protocol_name": "1.8.9",
  "protocol_version": 47,
  "software": null,
  "motd": "Hypixel Network [1.8/26.2] | SKYBLOCK 0.26.1 | SUMMER EVENT",
  "players_online": 27125,
  "players_max": 200000,
  "player_sample": [],
  "plugin_count": null,
  "mod_count": null,
  "gamemode": null,
  "eula_blocked": false,
  "icon_present": true,
  "ping_ms": null,
  "source": "mcsrvstat",
  "scraped_at": "2026-07-28T12:47:18.913576+00:00"
}

Field	Meaning
host	Exactly the address you supplied (your join key).
online	true if the server responded to a status ping.
ip, port, hostname	Resolved connection details, including SRV resolution.
version, protocol_name, protocol_version	Advertised version string and protocol handshake data.
software	Server software when advertised (Paper, Spigot, Velocity, …).
motd	Clean MOTD lines joined with " | ", capped at 500 characters.
players_online, players_max	Current and maximum player slots.
player_sample	Up to 20 visible player names (many big servers hide this).
plugin_count, mod_count	Number of advertised plugins / mods when query is enabled.
gamemode	Bedrock only — e.g. Survival.
eula_blocked	Server blocked by Mojang's EULA enforcement.
icon_present	Whether the server returns a favicon.
ping_ms	Ping latency when reported numerically, otherwise null.

Pricing

Roughly $0.5 per 1,000 servers checked, plus Apify platform usage. A 200-server monitoring run costs about $0.10. Because status data is cached upstream for ~1 minute, polling faster than once per minute adds cost without adding fresh data.

How it works

The actor queries the public mcsrvstat.us API v3 (Java and Bedrock endpoints) with a descriptive User-Agent, retries with backoff, and normalises everything into a flat schema. Requests are made with curl_cffi (Chrome 124 TLS fingerprint) and fall back to plain urllib if needed — so it works from datacenter IPs without proxies.

Tips

• Use plain hostnames, not https:// URLs — the actor strips schemes for you, but clean input is faster.
• Bedrock hosts must be run in bedrock mode; querying a Bedrock server in Java mode returns online: false.
• Schedule runs with the Apify Scheduler and use the dataset's scraped_at to build time series.
• player_sample is empty for most large networks — that's the server hiding its list, not a scraping failure.

Related actors

• Steam Charts Scraper — live player counts for Steam games
• Twitch Streams Scraper — live streams, viewers and categories
• Website Uptime Monitor — HTTP uptime and response-time checks
• Steam Deals Scraper — discounts and price history on Steam

Legal

This actor reads publicly available server status data (the same handshake any Minecraft client performs) via a public API. It collects no personal data beyond the player names a server chooses to broadcast publicly. It is not affiliated with, endorsed by, or associated with Mojang Studios or Microsoft.