This API endpoint is used to retrieve historic data.
History data should get saved once per hour, but in case of errors this won't be guranteed.
Per default the following endpoints return data of the past 7 days.
This can be changed by providing a value in the hoursInPast
querystring key.
Example with custom hoursInPast
: https://thetxt.io/api/v1/history/totalkarma?hoursInPast=100
Returns the history of total karma of all users combined.
Example reply:
[
{
"timestamp": 1607529600380,
"karma": 169
}
]
Try it yourself: click me
Returns the history of global karma of specified user.
Example reply:
[
{
"userId": "293029505457586176",
"timestamp": 1607529600379,
"karma": 26
}
]
Try it yourself: click me
Returns the history of karma of specified guild.
Example reply:
[
{
"guildId": "624976691692961793",
"timestamp": 1607522400380,
"karma": 75
}
]
Try it yourself: click me
Returns the history of karma of specified user in specified guild.
Example reply:
[
{
"userId": "293029505457586176",
"guildId": "624976691692961793",
"timestamp": 1607529600380,
"karma": 22
}
]
Try it yourself: click me
Returns the history of karma of specified user in all guilds that the user has karma in.
Example reply:
[
{
"guildkarmaHistory": [
{
"userId": "293029505457586176",
"guildId": "624976691692961793",
"timestamp": 1608735600591,
"karma": 30
}
],
"guildId": "624976691692961793",
"guildName": "Your cool guild"
}
]
Try it yourself: click me
Returns the history of the user count. This counts everyone who received at least one vote as a user
Example reply:
[
{
"timestamp": 1608332400434,
"count": 42
}
]
Try it yourself: click me
Returns the history of the guild count. This counts every guild that the bot got ever joined to
Example reply:
[
{
"timestamp": 1608332400434,
"count": 42
}
]
Try it yourself: click me