A New Rule for Votes
To avoid having our top pages filled with multiple servers of the same community/network, our scoring system has been updated with a new rule. Click here for more information

API Documentation

API 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.
GET https://rust-servers.net/api/?object=votes&element=claim&key={ServerKey}&steamid={SteamID}
GET https://rust-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
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.
POST https://rust-servers.net/api/?action=post&object=votes&element=claim&key={ServerKey}&steamid={SteamID}
POST https://rust-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
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 500 results.
Output is cached for 3 minutes.
GET https://rust-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 500. 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 500 results.
Output is cached for 3 minutes.
GET https://rust-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 500. 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.
GET https://rust-servers.net/api/?object=servers&element=detail&key={ServerKey}
Parameter Value Description Data Type Required
key xxxxxxxx Your Server API Key String Yes

Plugin(s) / Service(s) Using Our API

Vote For Money

Vote For Money is a vote reward plugin for Oxide. Players who vote are rewarded with Economics, Server Rewards, Kits...

Detail & Download

EasyVote

EasyVote is a vote reward plugin for Oxide. Making voting super easy and smooth!

Detail & Download

Vote Rewards

Vote Rewards is a reward plugin for Oxide for Rust Legacy. Gives reward to players that voted for your server on Rust-Servers.net.

Detail & Download

Vote

Vote is a reward plugin for Pluton. Reward your players for voting for your server on Rust-servers.net.

Detail & Download

API using SteamID works only if vote with Steam OpenID is activated on the server list. Current status: Activated