Servers

All API endpoints related to servers.

get
Servers

https://api.discordlist.space/v2/servers
Retrieve all servers in the database.
Request
Response
Request
Query Parameters
page
optional
number
The page number (min: 1, default: 1)
count
optional
number
The amount of servers to retrieve (min: 1, max: 50, default: 16)
sortBy
optional
string
The property to sort by (custom values: top, new, random, updated, name, id, rating, default: top)
sortDirection
optional
string
The sort direction (allowed values: ascending, descending, default: descending)
Response
200: OK
{
"page": 1,
"count": 138,
"countPerPage": 16,
"pageCount": 9,
"sortBy": "top",
"sortDirection": "descending",
"data": [
{
"id": "188752295108935680",
"name": "Cafe 0131+",
"shortDescription": "Welcome to **Café 0131+**! Here, peeps all around Discord gather for debates on topics such as politics, modern day crises, and current events, as well as some light-weight discussions on lives and such. We also have artworks and memes for you to enjoy! Join today for engaging discussions and a great family that welcomes everyone!",
"fullDescription": "",
"icon": "ca9692aa560c894a7e05191017326068",
"active": true,
"memberCount": 430,
"inviteCode": "MFgqKjd",
"owner": {
"username": "The Double-Eyed Bus",
"discriminator": "6889",
"avatar": "ceb39dccc1b41b2bcf524103c4c44573",
"shortDescription": "https://austinhuang.me",
"banned": null,
"admin": false,
"donator": false,
"createdAt": 1621740577087,
"updatedAt": 1622360047955,
"id": "207484517898780672"
},
"secondaryOwners": [],
"tags": [],
"safeAvatar": true,
"vanity": null,
"showEmojis": true,
"websiteURL": null,
"createdAt": 1539796333252,
"updatedAt": 1539796333252,
"upvoteCount": 1,
"reviewData": [],
"reviews": {
"count": 0,
"averageRating": 0
},
"emojis": [
{
"name": "ANELE",
"animated": false,
"createdAt": null,
"id": "242653181555769344"
},
...
]
}
]
}

get
Server

https://api.discordlist.space/v2/servers/:id
Retrieve a specific server by ID.
Request
Response
Request
Path Parameters
id
required
string
The ID of the server
Response
200: OK
{
"id": "387812458661937152",
"name": "discordlist.space",
"shortDescription": "The official support server for botlist.space and serverlist.space.",
"fullDescription": "",
"icon": "70ec291cf1dcaa33f8c50d5b3333a521",
"active": true,
"memberCount": 2591,
"inviteCode": "GjEWBQE",
"owner": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": null,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1622362145260,
"id": "507329700402561045"
},
"secondaryOwners": [],
"tags": [
{
"type": "server",
"name": "Community",
"bots": 0,
"servers": 63,
"id": "community"
}
],
"safeAvatar": true,
"vanity": null,
"showEmojis": true,
"websiteURL": null,
"createdAt": 1561956455291,
"updatedAt": 1622486615405,
"upvoteCount": 0,
"reviewData": [],
"reviews": {
"count": 0,
"averageRating": 0
},
"emojis": [
{
"name": "nope",
"animated": false,
"createdAt": null,
"id": "509251483154513921"
},
...
]
}

post
Update Server

https://api.discordlist.space/v2/servers/:id
Changes details of the server listing.
Request
Response
Request
Path Parameters
id
required
string
The ID of the server
Headers
Content-Type
required
string
Required to be application/json
Authorization
required
string
The server or user token
Body Parameters
active
optional
boolean
Whether the listing is active
websiteURL
optional
string
The website URL of the server (min: 1)
vanity
optional
string
Vanity code (only available to donators, min: 1, max: 24)
tags
optional
array
An array of tag IDs (min: 1, max: 7)
safeAvatar
optional
boolean
Sets whether the server icon is appropriate
inviteCode
optional
string
The invite code for the server (min: 1, max: 16)
fullDescription
optional
string
The full description of the listing (max: 20000)
shortDescription
optional
string
The short description of the listing (min: 1, max: 240)
Response
200: OK
{
"success": true
}

get
Server Reviews

https://api.discordlist.space/v2/servers/:id/reviews
Retrieves the reviews of the server.
Request
Response
Request
Path Parameters
id
required
string
The ID of the server
Query Parameters
page
optional
number
The page number (min: 1, default: 1)
count
optional
number
The amount of reviews to retrieve (min: 1, max: 50, default: 16)
sortBy
optional
string
The property to sort by (default: top)
sortDirection
optional
string
The sort direction (allowed values: ascending, descending, default: descending)
Response
200: OK
{
"page": 1,
"count": 1,
"countPerPage": 16,
"pageCount": 1,
"sortBy": "top",
"sortDirection": "descending",
"data": {
"averageRating": 0,
"reviews": [
{
"user": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1622362145260,
"id": "507329700402561045"
},
"title": "Great Server",
"comment": "This is my review of the server.",
"rating": 4.8,
"createdAt": 1622489365538,
"upvoted": false,
"bot": null,
"server": null,
"upvoteCount": 0,
"id": "5643f34927774a59d72a6297cd7428d3b7ddce419b7a808d"
}
]
}
}

get
Server Analytics

https://api.discordlist.space/v2/servers/:id/analytics
Gets the analytics from a time range for a server.
Request
Response
Request
Path Parameters
id
required
string
The ID of the server
Headers
Authorization
required
string
The server or user token
Query Parameters
from
optional
number
The timestamp to start the data from (default: 7 days ago)
to
optional
number
The timestamp to end the data at (default: now)
Response
200: OK
{
"from": 1621889093163,
"to": 1622493893163,
"count": 2,
"data": [
{
"server": "188752295108935680",
"timestamp": 1622480400000,
"impressions": 0,
"joins": 0,
"upvotes": 0,
"views": 1,
"id": "5b7758e1349eb3b9c8fddf8dc7a6a30c174fd47ba5d1da9598e1a9775afd6233",
"locationStatistics": [],
"referralStatistics": [
{
"source": null,
"views": 1
},
{
"source": null,
"views": 1
}
]
},
...
]
}

get
Server Upvotes

https://api.discordlist.space/v2/servers/:id/upvotes
Retrieves all the upvotes for this month.
Request
Response
Request
Path Parameters
id
required
string
The ID of the server
Headers
Authorization
required
string
The server or user token
Response
200: OK
{
"page": 1,
"count": 1,
"countPerPage": 16,
"pageCount": 1,
"sortBy": "timestamp",
"sortDirection": "descending",
"data": [
{
"user": {
"username": "PassTheMayo",
"discriminator": "8620",
"avatar": "8d7b060b71b4a904a965ef89c9a9bff7",
"shortDescription": "",
"banned": false,
"admin": true,
"donator": true,
"createdAt": 1621740577129,
"updatedAt": 1622362145260,
"id": "507329700402561045"
},
"timestamp": 1621797148696,
"id": "b0f798e1c67fb1e044ba05510ea196efd6d7485df5baf4a0645dc5af32579c0c"
},
...
]
}