Skip to content
DonutStatsAPI
Sign up
Images

Player card

A share card with a player's skin and headline stats.

GET/v1/images/player/{username}.png

Renders the same card DonutStats shows when a player profile is shared on Discord, X or anywhere else with link previews. It shows the player's skin, up to three of their balance, baltop rank, playtime and kills, and any open bounty on them.

Use it as an <img> source, in a Discord bot embed or in a GitHub README. Try different players on the image generator.

Authentication

None needed. 60 images per minute per IP.

Cached for

10 min

Data updates

Rendered from the latest stats, then cached for 10 minutes.

No key needed

Image endpoints are public so you can put them straight into an <img> tag, a Discord embed or a README. They are limited to 60 images per minute per IP address, and every image is cached for 10 minutes.

Path parameters

  • usernamestringrequired

    Minecraft username, case insensitive, followed by .png. A leading dot works for Bedrock players.

Response

A 1200 x 630 PNG image.

  • content-typeheader

    Always image/png.

  • cache-controlheader

    public, max-age=600: cache the image for 10 minutes.

Status codes

StatusWhen
400Bad RequestThe file name is malformed.
404Not FoundThere is nothing to draw: a player DonutStats has never seen, or an unknown item.
429Too Many RequestsMore than 60 images in a minute from your IP address.