NameMC APIfr.namemc.com ↗
Access Minecraft player profiles, name history, skin galleries, and username availability from NameMC via 4 structured API endpoints.
What is the NameMC 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace fr-namemc-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.namemc_api import NameMC, SkinCategory, PlayerNotFound
client = NameMC()
# Search for players by partial name
for player_summary in client.players.search(query="Dream"):
print(player_summary.name, player_summary.identifier, player_summary.url)
# Navigate from summary to full profile
full_profile = player_summary.details()
print(full_profile.name, full_profile.uuid)
print(full_profile.stats.monthly_views)
for skin in full_profile.skins:
print(skin.id, skin.thumbnail, skin.body_render)
for change in full_profile.name_history:
print(change.name, change.changed_at)
# Browse trending skins by category
for skin in client.skingalleries.list(category=SkinCategory.TRENDING):
print(skin.id, skin.url, skin.thumbnail)
# Check name availability
availability = client.nameavailabilities.get(name="Notch")
print(availability.name, availability.status, availability.monthly_searches)
Retrieve a Minecraft player's profile information including name history, skins, and monthly views. Accepts a username, UUID, or NameMC profile ID (e.g. 'Notch', 'Dream.1'). Returns the player's current name, UUID, skin gallery, name change history, and view statistics. A single fetch per player; skin thumbnails and 3D renders are pre-built URLs.
| 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": "4,825 / month"
},
"name_history": [
{
"name": "Notch",
"changed_at": "Original"
}
]
},
"status": "success"
}
}About the NameMC API
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.
The NameMC API is a managed, monitored endpoint for fr.namemc.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when fr.namemc.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official fr.namemc.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.