API Documentation
Options
To check if a Steam User or Username has voted or not, and if the vote has been claimed or not. This can be used for a reward plugin. The API will only check for the last 24 hours.
URL https://unturned-servers.net/api/?object=votes&element=claim&key={ServerKey}&steamid={SteamID}
URL https://unturned-servers.net/api/?object=votes&element=claim&key={ServerKey}&username={Username}
| Parameter | Description | Data Type | Required |
|---|---|---|---|
| key | Your Server API Key | String | Yes |
| steamid | 64bit SteamID of the user | Integer | Yes |
| username | Username of the voter | String (Case insensitive) | Yes |
| identifier | Used to get a unique ID for the output. Output will be in JSON format when used. | String | No |
| Response | Description |
|---|---|
| 0 | Not found |
| 1 | Has voted and not claimed |
| 2 | Has voted and claimed |
To set a vote as claimed for a Steam User or Username. This can be used for a reward plugin. The API will only set vote as claimed in the last 24 hours.
URL https://unturned-servers.net/api/?action=post&object=votes&element=claim&key={ServerKey}&steamid={SteamID}
URL https://unturned-servers.net/api/?action=post&object=votes&element=claim&key={ServerKey}&username={Username}
| Parameter | Description | Data Type | Required |
|---|---|---|---|
| key | Your Server API Key | String | Yes |
| steamid | 64bit SteamID of the user | Integer | Yes |
| username | Username of the voter | String (Case insensitive) | Yes |
| identifier | Used to get a unique ID for the output. Output will be in JSON format when used. | String | No |
| Response | Description |
|---|---|
| 0 | Vote has not been claimed |
| 1 | Vote has been claimed |
To get the list of voters for your server. Limited to the top 1000 results.
Output is cached for 3 minutes.
Output is cached for 3 minutes.
URL https://unturned-servers.net/api/?object=servers&element=voters&key={ServerKey}&month={Period}&format={Format}
| Parameter | Value | Description | Data Type | Required |
|---|---|---|---|---|
| key | xxxxxxxx | Your Server API Key | String | Yes |
| month | current | previous | Period to get | String | Yes |
| format | json | xml | html | Format of the response | String | Yes |
| limit | xxx | Result limit. Max value is 1000. Default value is 100. | Integer | No |
| rank | nickname | steamid | Rank voters by nickname or steamid. Default value is nickname | String | No |
To get the list of votes for your server. Limited to the last 1000 results.
Output is cached for 3 minutes.
Output is cached for 3 minutes.
URL https://unturned-servers.net/api/?object=servers&element=votes&key={ServerKey}&format={Format}
| Parameter | Value | Description | Data Type | Required |
|---|---|---|---|---|
| key | xxxxxxxx | Your Server API Key | String | Yes |
| format | json | xml | html | Format of the response | String | Yes |
| limit | xxx | Result limit. Max value is 1000. Default value is 100. | Integer | No |
To get the full detail of your server in json format. Can be used to create your own status page for example.
Output is cached for 3 minutes.
Output is cached for 3 minutes.
URL https://unturned-servers.net/api/?object=servers&element=detail&key={ServerKey}
| Parameter | Value | Description | Data Type | Required |
|---|---|---|---|---|
| key | xxxxxxxx | Your Server API Key | String | Yes |
To get the list of servers in json format. This list is IP restricted, contact us for more information.
Output is cached for 3 minutes.
Output is cached for 3 minutes.
URL https://unturned-servers.net/api/?object=servers&element=list
| Parameter | Value | Description | Data Type | Required |
|---|---|---|---|---|
| country | xxxxxxxx | Limit the list to a country (exemple: Germany) | String | No |
| version | xxxxxxxx | Limit the list to a version (exemple: Alpha 18) | String | No |
Plugin(s) / Service(s)
Votifier
Votifier is a plugin of Rocket Mod for Unturned 3.x by unturned.Rocks community. Gives reward to players that voted for your server on Unturned-Servers.net.
Game Manager Discord Bot
Game Manager Discord Bot is Discord bot for your game server: show IP/port, online status, players online, votes and more. Working with Minecraft, Unturned, Garrys Mod and Rust.
VoteRewards
VoteRewards is a plugin for Unturned 3.x. Receive rewards for voting on Unturned-Servers.net
API using SteamID works only if vote with Steam OpenID is activated on the server list. Current status: Activated