Game

Query MC Player

0calls

1 credits / call

With just a player's username, you can quickly get their premium skin and unique UUID!

Overview

This is a basic but very practical endpoint. With a player's current in-game name (Username), you can query their corresponding UUID (unique identifier) and current skin URL address. This is the first step in building many other player-related services.

Query parameters

username

stringrequired

Player's Minecraft in-game name (premium ID).

Name	Type	Attributes	Description
`username`	string	required	Player's Minecraft in-game name (premium ID).

Response

200 / OK

Query successful! Returns user's UUID and skin link.

JSON

400 / Bad Request

Request failed. Please check if you provided the username parameter.

JSON

404 / Not Found

Player not found. Based on the username you provided, we couldn't find the corresponding Minecraft player. Please check if the spelling is correct.

JSON

502 / Bad Gateway

Unable to fetch game data temporarily, please try again later.

JSON

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/game/minecraft/userinfo?username=Notch'

Frequently asked questions

Are there any special restrictions for the Query MC Player API?

Query MC Player follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

PreviousQuery MC Server

NextQuery Steam User