BANNIÈRE

API - Server banner

Information: A PNG image generated on the fly (status, MOTD, online players, version, favicon) — perfect to paste directly into a Discord message or forum signature via a simple <img> tag.
Explanation of parameters
  • ip Server address: play.example.com
  • port Server port: 25565 (Java) or 19132 (Bedrock) by default
  • edition java (default) or bedrock
  • theme dark (default) or light
  • lang fr, en, es, de or pt — label language (default en)
Obligatory parameter Optional parameter
HTML integration
<img src="https://minecraft-api.com/api/banner/banner.php?ip={ip}&port={port}&theme=dark&lang=fr" alt="Bannière du serveur généré par Minecraft-api.com" />
Response from API
Image (PNG, 420x110):

Server icon (favicon) on the left, name/address, MOTD, status (Online/Offline), player count and version on the right. A coloured bar at the top shows the status (green = online, red = offline).

Information: The banner is cached for 60 seconds in the browser (the player count changes live). The quota remains 30 requests / 30 seconds per IP.