Skip to content
yaml
outline: deep

Server HTML Embedded Banner

Retrieve real-time server icon.

methods: GET

bash
https://sr-api.sfirew.com/server/<server_address>:<port>/embed

Here's a tip

If the server port defaults to 25565, you don't need to specify it. You can simply write like this:
https://sr-api.sfirew.com/server/mc.hypixel.net/embed

Query Parameters

NameTypeDescription
timeoutstringYou can customize the time limit for the query in milliseconds.
For example: 5000 for 5 seconds.
protocolnumberYou can choose a specific server version to query.
For example: 765, for Minecraft version 1.20.3.
bedrockbooleanWhether to use Bedrock Edition query mode.

Query Path Parameter

NameTypeDescription
server_addressstringFor example: mc.hypixel.net
portnumberServer port
Range: 0 ~ 65535
Default: 25565

Response Example

The server's online status. The Status Code response will always be 200

https://sr-api.sfirew.com/server/mc.hypixel.net/embed

HTML Example Code

HTML
<iframe
  style="width:728px;height:120px;max-width:100%;border:none;display:block;margin:auto;"
  src="https://sr-api.sfirew.com/server/mc.hypixel.net/embed"
  width="728"
  height="120"
></iframe>