APIs we use
YuuTiers is a thin, beautifully cached proxy on top of the public Minecraft data ecosystem. Below is every third-party API that powers the site.
The stack at a glance
Mojang API
Players
Official Mojang API. We use it to resolve usernames to UUIDs, fetch profile data and the encoded texture properties needed to render skins and capes.
Crafatar
Skins
Free CDN that renders Minecraft avatars, heads and full-body images straight from Mojang textures. We proxy and cache its renders at the edge.
mc-heads.net
Skins
Fallback render service used when Crafatar is rate limited or returns 404. Supports both username and UUID lookups.
Visage (SurgePlay)
Skins
High-quality Minecraft avatar renderer. Used as a primary source for sharper face and full-body renders.
minotar.net
Skins
Lightweight legacy avatar service kept as a third fallback to keep skin loading bullet-proof on every search.
mcsrvstat.us
Servers
Live status, MOTD, version, player counts and server icons for any Java or Bedrock Minecraft server. We hit it directly from the client and cache responses.
Minecraft Wiki API
Wiki
Official MediaWiki action API for the Spanish Minecraft Wiki. Powers our search, article rendering, recent changes feed and category browser.
Mojang News (RSS)
News
Aggregated official Minecraft news. We parse the public RSS / Atom feed and a community-content endpoint to populate the News section.
Hypixel API
Players
Per-player Hypixel statistics — Bedwars, Skywars, Duels, network level and more. Requires an API key obtained from developer.hypixel.net.
Players
Rate limit
~600 requests / 10 min per IP
Auth
None — public API
Example endpoints
GET https://api.mojang.com/users/profiles/minecraft/{name}GET https://sessionserver.mojang.com/session/minecraft/profile/{uuid}Rate limit
120 requests / minute / key
Auth
API key (header: API-Key)
Example endpoints
GET https://api.hypixel.net/v2/player?uuid={uuid}GET https://api.hypixel.net/v2/status?uuid={uuid}Skins
Rate limit
Soft — please cache aggressively
Auth
None — public CDN
Example endpoints
GET https://crafatar.com/avatars/{uuid}GET https://crafatar.com/renders/head/{uuid}GET https://crafatar.com/renders/body/{uuid}GET https://crafatar.com/skins/{uuid}GET https://crafatar.com/capes/{uuid}Rate limit
Generous, no hard quota
Auth
None — public CDN
Example endpoints
GET https://mc-heads.net/avatar/{name|uuid}/{size}GET https://mc-heads.net/head/{name|uuid}/{size}GET https://mc-heads.net/body/{name|uuid}/{size}GET https://mc-heads.net/skin/{uuid}Rate limit
Fair-use, edge cached
Auth
None — public CDN
Example endpoints
GET https://visage.surgeplay.com/face/{size}/{uuid}GET https://visage.surgeplay.com/head/{size}/{uuid}GET https://visage.surgeplay.com/full/{size}/{uuid}Rate limit
Generous
Auth
None
Example endpoints
GET https://minotar.net/avatar/{name}/{size}GET https://minotar.net/cube/{name}/{size}GET https://minotar.net/armor/body/{name}/{size}Servers
Rate limit
1 request / address every minute (cached on their side)
Auth
None
Example endpoints
GET https://api.mcsrvstat.us/3/{ip}GET https://api.mcsrvstat.us/bedrock/3/{ip}GET https://api.mcsrvstat.us/icon/{ip}Wiki
Rate limit
Standard MediaWiki — please send a User-Agent
Auth
None for read-only
Example endpoints
GET ?action=query&list=search&srsearch={q}GET ?action=parse&page={title}&prop=text|sections|imagesGET ?action=query&list=recentchangesGET ?action=query&list=categorymembers&cmtitle=Category:{cat}News
Rate limit
Use SWR caching
Auth
None
Example endpoints
GET https://www.minecraft.net/en-us/feeds/community-contentGET https://www.minecraft.net/article-grid.jsonBe a good citizen
User-Agent with contact info, cache responses aggressively at the edge and never proxy raw uncached traffic to your end users.How YuuTiers stitches them together
- Username → Mojang API → UUID → Crafatar / Visage / mc-heads renders, with three independent fallbacks per render type.
- Server IP → mcsrvstat.us → motd, players, version & icon, refreshed every 30s on the client.
- Wiki search → MediaWiki action API → live HTML, sections, images and recent changes feed, all proxied through one Next.js route handler.
- News section → minecraft.net feeds → SWR-cached on Vercel's edge for sub-100ms loads.