Bots

Directly use our endpoints if no library is available for your language. You should only post to our API once per minute.

post
Post Stats

https://statcord.com/mason/stats
This endpoint allows you to directly post your stats to Statcord.
Request
Response
Request
Body Parameters
id
required
string
Your bot's Discord ID.
key
required
string
Your Statcord key
servers
required
string
The amount of servers your bot is in.
users
required
string
The amount of users your bot is servicing.
active
required
string
The amount of users who have run at least 1 command.
commands
required
string
The amount of commands that have been run.
popular
required
array
An array of the top 5 commands run. Each item should be a object with the attributes name & count, both of which should be strings.
Response
200: OK
Stats successfully updated.
{
error:false,
message:"Success!"
}
400: Bad Request
{
error:true,
message:"Some parameters are incorrect or missing. API Docs --> https://docs.statcord.com/bots"
}
429: Too Many Requests
You have hit a rate limit.
{
error:true,
message:"You have hit a ratelimit.",
wait:900
}

get
Bot Stats

https://statcord.com/mason/stats/:botid
This endpoint allows any user to get data that Statcord has recieved from your bot.
Request
Response
Request
Path Parameters
Bot ID
required
string
The ID of the Discord Bot you would like to get stats for.
Response
200: OK
Bot stats were successfully retrieved.
{
error:false,
data:[]
popular:[]
}
400: Bad Request
Bot stats were unable to be retrieved.
{
error:true,
message:"Some parameters are incorrect or missing. API Docs --> https://docs.statcord.com/api"
}

‚Äč