The Logo
    The GitHub logo

    Server Preview

    Get the server list preview of a Minecraft server.

    Overview

    The server preview endpoint allows you to get the server list preview of a Minecraft server.

    Endpoint

    GET /server/:platform/preview/:query

    Platforms

    PlatformDescription
    bedrockBedrock Edition
    javaJava Edition

    Parameters

    ParameterDescriptionRequired
    platformThe platform of the server you want to get the preview for.Yes
    queryThe IP address or hostname of the server you want to get the preview for.Yes

    Example

    Bash
    curl -X GET "https://api.mcutils.xyz/server/java/preview/hypixel.net" -H "accept: image/png"

    Response

    Server Icon

    Errors

    Status CodeDescription
    400The server was not found.
    429The Mojang API rate limit has been exhausted.