fr.namemc.com APIfr.namemc.com ↗
Access Minecraft player profiles, name history, skin galleries, and username availability from NameMC via 4 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/74336619-75f3-4075-a721-9dc0b199d651/get_player_profile?identifier=Notch' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve a Minecraft player's profile information including name history, skins, and monthly views.
| Param | Type | Description |
|---|---|---|
| identifierrequired | string | Minecraft username, UUID, or NameMC profile ID (e.g., 'Notch', 'Dream.1') |
{
"type": "object",
"fields": {
"name": "current player username",
"uuid": "Minecraft UUID with dashes",
"skins": "array of skin objects with 'id', 'url', 'thumbnail', and 'body_render' fields",
"stats": "object with 'monthly_views' string",
"name_history": "array of name change records with 'name' and 'changed_at' fields"
},
"sample": {
"data": {
"name": "Notch",
"uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
"skins": [
{
"id": "5d5eb6d84b57ea29",
"url": "https://namemc.com/skin/5d5eb6d84b57ea29",
"thumbnail": "https://s.namemc.com/2d/skin/face.png?id=5d5eb6d84b57ea29&scale=4",
"body_render": "https://s.namemc.com/3d/skin/body.png?id=5d5eb6d84b57ea29&model=classic&width=256&height=256"
}
],
"stats": {
"monthly_views": "3,764 / month"
},
"name_history": [
{
"name": "Notch",
"changed_at": "Original"
}
]
},
"status": "success"
}
}About the fr.namemc.com API
The NameMC API exposes 4 endpoints covering Minecraft player profiles, skin discovery, and username lookup. get_player_profile returns the current username, UUID, full name history with timestamps, and an array of skin objects including thumbnail and body render URLs. get_name_availability checks whether a given username is taken and returns its monthly search count, giving you both identity resolution and demand signals in a single call.
Player Profiles and Name History
get_player_profile accepts a Minecraft username, UUID, or NameMC profile identifier (e.g. 'Notch' or 'Dream.1'). The response includes the player's current name, their uuid in dashed format, a name_history array where each record carries a name and changed_at timestamp, and a skins array with per-skin id, url, thumbnail, and body_render fields. The stats object exposes monthly_views as a string, useful for gauging a player's current popularity.
Skin Discovery
get_trending_skins retrieves skins by category and supports pagination via the page integer parameter. The category parameter accepts 'trending', 'new', 'top', or 'random'. Each skin object in the returned skins array includes the same four fields as profile skins: id, url, thumbnail, and body_render. The response echoes back the page and category values so you can confirm pagination state.
Player Search and Username Availability
search_players accepts a full or partial username string. When an exact match exists, the endpoint returns a direct profile match; otherwise it returns an array of candidate objects each containing name, url, and identifier. get_name_availability takes a single name parameter and returns a status field ('Available', 'Unavailable', or 'Unknown') alongside monthly_searches — the number of times that name has been searched in the current month, or null when that figure isn't available.
- Resolve a Minecraft username to its UUID for integration with game server APIs
- Audit a player's full name-change timeline using the name_history array from get_player_profile
- Build a skin browser with category filters and pagination using get_trending_skins
- Check username availability and monthly search demand before registering a new Minecraft account
- Track a player's monthly profile views over time using the stats.monthly_views field
- Autocomplete Minecraft usernames in an app search bar using search_players with a partial query
- Enumerate all skins associated with a specific player profile for display in a portfolio tool
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.