Skip to main content

​
Get Full Player Info

Get complete information about a Minecraft player including UUID, username history, and skin data.

​
Endpoint

GET /api/minecraft/full

​
Query Parameters

​
username
string
required
Minecraft username

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/minecraft/full?username=Notch" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/minecraft/full?username=Notch', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'username': 'Notch'}

response = requests.get(
    'https://rocks.rive.wtf/api/minecraft/full',
    headers=headers,
    params=params
)

print(response.json())

​
Response Example

{
  "username": "Notch",
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
  "username_history": [
    {
      "username": "Notch",
      "changed_at": null
    }
  ],
  "skin": {
    "url": "https://...",
    "variant": "classic"
  },
  "cape": null
}

​
Get UUID

Get a player’s UUID from their username.

​
Endpoint

GET /api/minecraft/uuid

​
Query Parameters

​
username
string
required
Minecraft username

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/minecraft/uuid?username=Notch" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/minecraft/uuid?username=Notch', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {'username': 'Notch'}

response = requests.get(
    'https://rocks.rive.wtf/api/minecraft/uuid',
    headers=headers,
    params=params
)

print(response.json())

​
Response Example

{
  "username": "Notch",
  "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5"
}

​
Get Avatar

Get a player’s avatar image.

​
Endpoint

GET /api/minecraft/avatar

​
Query Parameters

​
uuid
string
required
Player’s UUID
​
size
integer
default:"128"
Avatar size in pixels
​
overlay
boolean
default:"true"
Include skin overlay layer
​
service
string
default:"visage"
Rendering service to use. Options: visage, crafatar

​
Example Request

cURL
curl -X GET "https://rocks.rive.wtf/api/minecraft/avatar?uuid=069a79f4-44e9-4726-a5be-fca90e38aaf5&size=128&overlay=true&service=visage" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/minecraft/avatar?uuid=069a79f4-44e9-4726-a5be-fca90e38aaf5&size=128&overlay=true&service=visage', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

// Response is an image
const blob = await response.blob();
const imageUrl = URL.createObjectURL(blob);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {
    'uuid': '069a79f4-44e9-4726-a5be-fca90e38aaf5',
    'size': 128,
    'overlay': True,
    'service': 'visage'
}

response = requests.get(
    'https://rocks.rive.wtf/api/minecraft/avatar',
    headers=headers,
    params=params
)

with open('avatar.png', 'wb') as f:
    f.write(response.content)

​
Response Format

Returns a PNG image of the player’s avatar.

​
Get 3D Render

Get a 3D render of a player’s skin.

​
Endpoint

GET /api/minecraft/render

​
Query Parameters

​
uuid
string
required
Player’s UUID
​
type
string
default:"head"
Render type. Options: head, body, full
​
scale
integer
default:"4"
Scale factor for the render
​
service
string
default:"visage"
Rendering service to use. Options: visage, crafatar

​
Example Request

cURL (Head)
curl -X GET "https://rocks.rive.wtf/api/minecraft/render?uuid=069a79f4-44e9-4726-a5be-fca90e38aaf5&type=head&scale=4&service=visage" \
  -H "Authorization: Bearer YOUR_API_KEY"
cURL (Body)
curl -X GET "https://rocks.rive.wtf/api/minecraft/render?uuid=069a79f4-44e9-4726-a5be-fca90e38aaf5&type=body&scale=4&service=visage" \
  -H "Authorization: Bearer YOUR_API_KEY"
JavaScript
const response = await fetch('https://rocks.rive.wtf/api/minecraft/render?uuid=069a79f4-44e9-4726-a5be-fca90e38aaf5&type=body&scale=4&service=visage', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

// Response is an image
const blob = await response.blob();
const imageUrl = URL.createObjectURL(blob);
Python
import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}
params = {
    'uuid': '069a79f4-44e9-4726-a5be-fca90e38aaf5',
    'type': 'body',
    'scale': 4,
    'service': 'visage'
}

response = requests.get(
    'https://rocks.rive.wtf/api/minecraft/render',
    headers=headers,
    params=params
)

with open('render.png', 'wb') as f:
    f.write(response.content)

​
Response Format

Returns a PNG image of the 3D render.
Higher scale values produce larger, more detailed renders but may take longer to generate.