search

https://joshm.us.to/api/namemc/v1/search

Look up accounts that have shared names in the past by name or uuid.

Query Parameters

Parameter	Default	Description
query	❌ Required	Specifies player to look up. Could be either a username or uuid.

Typical Errors

• No query provided. Use the 'query' parameter to specify a username or uuid to look up.
• '${query}' is not a valid username or uuid.

Example

HTTP/1.1 GET https://joshm.us.to/api/namemc/v1/search?query=3e7

{
    "success": true,
    "results": [
        {
            "profileId": "3E7.3",
            "currentName": "3E7",
            "uuid": "da69903b-2a16-4ec6-a0d0-1c519e2f8594",
            "imageUrls": {
                "cape": "https://crafatar.com/capes/da69903b-2a16-4ec6-a0d0-1c519e2f8594",
                "body": "https://crafatar.com/renders/body/da69903b-2a16-4ec6-a0d0-1c519e2f8594?overlay",
                "head": "https://crafatar.com/renders/head/da69903b-2a16-4ec6-a0d0-1c519e2f8594?overlay",
                "face": "https://crafatar.com/avatars/da69903b-2a16-4ec6-a0d0-1c519e2f8594?overlay",
                "skins": [
                    "https://texture.namemc.com/4c/e0/4ce01e3b68860082.png",
                    "https://texture.namemc.com/cf/9d/cf9dbe4400c17d50.png",
                    "https://texture.namemc.com/34/e4/34e48110f31a3c29.png"
                ]
            },
            "pastNames": [
                {
                    "name": "3E7",
                    "changedAt": 1523455635000
                },
                {
                    "name": "Skenoo",
                    "changedAt": 1520724414000
                },
                {
                    "name": "ARTUR_FARTUR",
                    "changedAt": null
                }
            ]
        },
        {
            "profileId": "ProdWolf.1",
            "currentName": "ProdWolf",
            "uuid": "db7aac5c-1e87-4161-badc-3bb26f0abcc2",
            "imageUrls": {
                "cape": "https://crafatar.com/capes/db7aac5c-1e87-4161-badc-3bb26f0abcc2",
                "body": "https://crafatar.com/renders/body/db7aac5c-1e87-4161-badc-3bb26f0abcc2?overlay",
                "head": "https://crafatar.com/renders/head/db7aac5c-1e87-4161-badc-3bb26f0abcc2?overlay",
                "face": "https://crafatar.com/avatars/db7aac5c-1e87-4161-badc-3bb26f0abcc2?overlay",
                "skins": [
                    "https://texture.namemc.com/5d/e1/5de1f61d360590ce.png",
                    "https://texture.namemc.com/f9/af/f9afe9773f18ff3f.png",
                    "https://texture.namemc.com/0b/06/0b06461025611258.png",
                    "https://texture.namemc.com/e5/35/e5359f5cf17f54d4.png",
                    "https://texture.namemc.com/8f/b2/8fb2c47e80644940.png"
                ]
            },
            "pastNames": [
                {
                    "name": "ProdWolf",
                    "changedAt": 1542516442000
                },
                {
                    "name": "Lence",
                    "changedAt": 1520258827000
                },
                {
                    "name": "3E7",
                    "changedAt": 1503811342000
                },
                {
                    "name": "EmbraceAnime",
                    "changedAt": 1500326446000
                },
                {
                    "name": "TouchMeHard",
                    "changedAt": 1497586174000
                },
                {
                    "name": "Beasty352_YT",
                    "changedAt": 1469422267000
                },
                {
                    "name": "Beasty352",
                    "changedAt": null
                }
            ]
        },
        {
            "profileId": "MinorGetsFiner.1",
            "currentName": "MinorGetsFiner",
            "uuid": "04880953-fc5a-4583-b372-94f5a04c6289",
            "imageUrls": {
                "cape": "https://crafatar.com/capes/04880953-fc5a-4583-b372-94f5a04c6289",
                "body": "https://crafatar.com/renders/body/04880953-fc5a-4583-b372-94f5a04c6289?overlay",
                "head": "https://crafatar.com/renders/head/04880953-fc5a-4583-b372-94f5a04c6289?overlay",
                "face": "https://crafatar.com/avatars/04880953-fc5a-4583-b372-94f5a04c6289?overlay",
                "skins": [
                    "https://texture.namemc.com/33/87/33874de312e3e898.png",
                    "https://texture.namemc.com/02/f3/02f3f83e28c21130.png",
                    "https://texture.namemc.com/f9/af/f9afe9773f18ff3f.png",
                    "https://texture.namemc.com/27/85/2785fb1b3d357b55.png",
                    "https://texture.namemc.com/29/82/2982ecd5116eaf6c.png",
                    "https://texture.namemc.com/f2/3d/f23dc4fc2edca1f8.png",
                    "https://texture.namemc.com/ca/51/ca511ac942058c79.png",
                    "https://texture.namemc.com/24/ca/24ca2e55e009fa35.png",
                    "https://texture.namemc.com/3c/f9/3cf9b1a85ee4a4e6.png",
                    "https://texture.namemc.com/84/57/84578d68ffd7838f.png",
                    "https://texture.namemc.com/63/45/63455d7069b397c2.png",
                    "https://texture.namemc.com/cb/26/cb26c195a5554fa7.png",
                    "https://texture.namemc.com/ad/26/ad2616d2e151f3c6.png",
                    "https://texture.namemc.com/c1/c1/c1c1f9002184d17c.png",
                    "https://texture.namemc.com/d0/72/d07239fd84662ff9.png"
                ]
            },
            "pastNames": [
                {
                    "name": "MinorGetsFiner",
                    "changedAt": 1597120593000
                },
                {
                    "name": "IWannaHaveSex",
                    "changedAt": 1593210791000
                },
                {
                    "name": "Tobmia",
                    "changedAt": 1505267863000
                },
                {
                    "name": "Releno",
                    "changedAt": 1500614530000
                },
                {
                    "name": "3e7",
                    "changedAt": 1497897726000
                },
                {
                    "name": "MadeUpLies",
                    "changedAt": 1495169022000
                },
                {
                    "name": "WaitAgain",
                    "changedAt": 1492457581000
                },
                {
                    "name": "WannaHaveSex",
                    "changedAt": 1489801531000
                },
                {
                    "name": "NeverGetOlder",
                    "changedAt": 1487204879000
                },
                {
                    "name": "LiteralCringe",
                    "changedAt": null
                }
            ]
        }
    ]
}

Respone Breakdown

Key	Description	Type
results	Array of objects containing player information.	Array<Object>
results[].profileId	The ID Name MC assigned to this account.	String
results[].currentName	The accounts current Minecraft username.	String
results[].uuid	The accounts static UUID.	String
results[].imageUrls	An object containing many images of the skin or its renders.	Object
results[].imageUrls.cape	A URL to the user's cape PNG.	String
results[].imageUrls.body	A URL to the user's standing render PNG.	String
results[].imageUrls.head	A URL to the user's head render PNG.	String
results[].imageUrls.face	A URL to the user's face PNG.	String
results[].imageUrls.skins	An array of image URL's to skins the user has previously used.	Array<String>
results[].pastNames	An array of objects containing the user's previous names and when they were changed.	Array<Object>
results[].pastNames[].name	The user's name.	String
results[].pastNames[].changedAt	The timestamp the user changed their name to this. null if it was the original name of the account.	Number/null