Minecraft API

Look up Minecraft Java players, check server status and list game versions as JSON.

The API.SH Minecraft API covers Java Edition data. Look up a player by username or UUID for the UUID, current username, skin and cape links and skin model. Check any Java server for online status, version, players online and maximum, the player sample, MOTD and icon. List every game version with type and release time. It is a data API, not a modding library like the Fabric API.

Get a free API key Try it in the playground

3 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Minecraft player

GET https://api.api.sh/minecraft/v1/player

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Minecraft API

Server status pages and bots

Check whether a server is online and show its players, version and MOTD on a website or in a Discord bot.

/server-status

Player lookup and skin tools

Resolve a username to a UUID and fetch the skin and cape links for profile pages, leaderboards and skin viewers.

/player

Server list and uptime monitoring

Poll many servers on a schedule to record uptime, player counts and version over time.

/server-status

Version tracking

List releases and snapshots newest first to alert on new versions or keep a launcher or wiki up to date.

/versions

Whitelist and account checks

Convert usernames to UUIDs and confirm the current name for a UUID before you add players to a list in your own tools.

/player

Minecraft data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Minecraft API endpoints and prices

Every Minecraft endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

More data3

Minecraft player /minecraft/v1/player	$1 · $2 PAYG 1 credit
Minecraft server status /minecraft/v1/server-status	$1 · $2 PAYG 1 credit
Minecraft versions /minecraft/v1/versions	$1 · $2 PAYG 1 credit

Call the Minecraft API

Minecraft player: GET https://api.api.sh/minecraft/v1/player

curl "https://api.api.sh/minecraft/v1/player?name=Notch" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/minecraft/v1/player",
    params={"name": "Notch"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/minecraft/v1/player");
url.searchParams.set("name", "Notch");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/minecraft/v1/player", "name", "Notch")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Minecraft" and "Minecraft player".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Minecraft data

Public data only: no Minecraft login, cookies or account needed
One key and one response shape for Minecraft and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Minecraft API

Mojang and Microsoft have official web services for Minecraft accounts, such as profile lookups by name and UUID, and Mojang publishes its version manifest. Server status has no single official endpoint, because the game's server list protocol is what third-party status tools read. API.SH wraps these lookups in one JSON format with the rest of API.SH.

Instead of running your own status pinger, calling Mojang endpoints and handling their limits, or choosing among free community Minecraft APIs, you use one key for player, server and version data.

Minecraft API questions

What Minecraft data can I get?+

Java player profiles by name or UUID (/minecraft/v1/player), live server status with players and MOTD (/minecraft/v1/server-status) and the full list of game versions (/minecraft/v1/versions).

How much does the Minecraft API cost?+

Every Minecraft endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /minecraft/v1/player at 1 credit each.

Is there an official Minecraft API?+

Partly. Mojang and Microsoft run official services for player profiles and publish the version manifest, but there is no general official data API, and "Minecraft API" searches mostly find modding libraries like the Fabric API. API.SH wraps player, server status and version lookups in one JSON format.

Do I need a Minecraft account or login?+

No. API.SH reads public information only. No endpoint uses a login, cookies or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /minecraft/v1/server-status with an address, or /minecraft/v1/player with a name. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Is this the Minecraft Fabric API or a modding API?+

No. Fabric API is a library for building mods. API.SH is a web data API: you call it over HTTP to get player profiles, server status and version lists from outside the game.

Can I check a Minecraft server's status with the API?+

Yes. /minecraft/v1/server-status takes an address and optional port and returns online state, version, players online and maximum, the player sample, MOTD and icon, for Java Edition servers.