PlayerDB is a JSON powered player fetching and caching API service.

Player Routes

Player lookup routes include data so that the following schema is followed:

{
	"username": "playername",
	"id": "123-abc",
	"avatar": "https://avatar-server.com/player.png",
	"meta": { ... }
}

Minecraft Account Lookup

https://playerdb.co/api/player/minecraft/$ID

• $ID

  - Minecraft username / ID to lookup

Hytale Account Lookup

https://playerdb.co/api/player/hytale/$ID

• $ID

  - Hytale username / ID to lookup

Steam Account Lookup

https://playerdb.co/api/player/steam/$ID

• $ID

  - Steam ID to lookup. Can be in any Steam ID format

Xbox Account Lookup

https://playerdb.co/api/player/xbox/$ID

• $ID

  - Xbox ID / username to lookup

Other Information

Very generous rate limits are in place, and normal usage should never come close to hitting them. If you have a reasonable use-case that needs more, reach out to @cherryjimbo and we'll be happy to help. If you do get rate limited, the API responds with a 429 status and a Retry-After header indicating how long to wait before retrying.

We also ask that you please include an identifying user-agent header in any requests that you make to the API, so we can contact you if necessary about your usage.