namemc.com APInamemc.com ↗
Retrieve Minecraft usernames, drop times, UUIDs, cape holders, and skin history from NameMC. 4 endpoints covering profiles, name availability, and more.
curl -X GET 'https://api.parse.bot/scraper/fdb92c23-8dea-447b-a4ab-fed705a714c1/get_names?limit=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of usernames, droptimes, and search counts from the Minecraft names page. Supports pagination via the 'url' parameter and limiting results.
| Param | Type | Description |
|---|---|---|
| url | string | Full URL for pagination, obtained from next_url in a prior response. |
| limit | integer | Max number of results to return. Omitting returns all names on the page. |
{
"type": "object",
"fields": {
"names": "array of objects with username (string), droptime (ISO timestamp string), and searches (integer)",
"next_url": "string or null, URL for the next page of results"
},
"sample": {
"data": {
"names": [
{
"droptime": "2026-05-01T03:17:08.229Z",
"searches": 0,
"username": "RussianPartisan"
},
{
"droptime": "2026-05-01T03:17:31.976Z",
"searches": 0,
"username": "WaterZeus"
}
],
"next_url": "https://namemc.com/minecraft-names?time=20260501T033042Z&sort=asc"
},
"status": "success"
}
}About the namemc.com API
The NameMC API provides 4 endpoints to query Minecraft player data from namemc.com, including username availability with drop times, player profiles with UUIDs, and cape holder lists. The get_profile endpoint returns a player's UUID, claim status, monthly profile views, and latest skin upload timestamp by username. The get_names endpoint surfaces upcoming available names with search popularity counts and supports pagination for bulk lookups.
Name Availability and Drop Times
The get_names endpoint returns an array of objects, each containing a username, a droptime (ISO 8601 timestamp indicating when the name becomes available), and a searches integer reflecting how many times that name has been searched on NameMC. Pagination is handled via the next_url field returned in each response — pass that value as the url parameter to retrieve the next page. An optional limit parameter caps how many results are returned from a single call.
Player Profiles
The get_profile endpoint accepts a username string and returns the player's uuid in dashed format, a boolean is_claimed indicating whether the player has linked their account to the NameMC profile, monthly_views as an integer, and latest_skin_timestamp as an ISO timestamp or null if no skin has been uploaded. The UUID field returns null for usernames that have never had a Minecraft account.
Cape Holders
The get_cape_users endpoint lists Minecraft usernames of players holding a specific cape type. The required cape_type parameter accepts 'founders' or 'experience'. Results are paginated: the response includes page (current page number), has_next (boolean), and usernames (array of strings). Iterate through pages by incrementing the page parameter.
Raw HTML Access
The get_raw_html endpoint fetches the full HTML of any NameMC page. It accepts either a relative path such as '/minecraft-names' or a full URL, and returns the resolved url, the html string, and the status_code. This is useful for accessing pages not yet covered by a dedicated structured endpoint.
- Monitor upcoming Minecraft username availability using drop times from
get_namesto automate registration attempts - Build a name popularity tracker by collecting
searchescounts across paginated results fromget_names - Look up a player's UUID by username via
get_profilefor use in Minecraft server plugins or database records - List all holders of a specific cape type using
get_cape_usersto analyze rare item distribution across players - Track skin update activity by polling
latest_skin_timestampfromget_profilefor a set of usernames - Check whether a NameMC profile has been claimed by its owner using the
is_claimedfield fromget_profile - Fetch data from NameMC pages not covered by structured endpoints using
get_raw_htmlwith a custom path
| 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.
Does NameMC have an official developer API?+
What does `get_profile` return for a username that has never been a Minecraft account?+
uuid field returns null for usernames with no associated Minecraft account. The is_claimed boolean will be false, and latest_skin_timestamp will also be null since no skin data exists.Does the API expose full skin history or name change history for a player?+
get_profile endpoint returns only the latest_skin_timestamp, not a full skin upload history or name change log. The get_names endpoint focuses on upcoming available names rather than historical name changes per player. You can fork this API on Parse and revise it to add an endpoint that parses the full skin or name history from a player's NameMC profile page.Are cape types beyond 'founders' and 'experience' supported by `get_cape_users`?+
'founders' and 'experience' are accepted values for the cape_type parameter. Other cape types are not covered. You can fork this API on Parse and revise the endpoint to add support for additional cape types.How does pagination work for `get_names`?+
get_names includes a next_url field. When more results are available, next_url is a string you pass as the url parameter in your next request. When there are no more pages, next_url is null. The optional limit parameter controls how many results are returned per call.