List
These API endpoints are core endpoints of our list.
Gets the RSS feed for the site, in XML format
Success
response?seo.RssFeedapplication/jsoncurl -X GET 'https://spider.omniplex.gg/list/rss.xml'nullGets the sitemap for the site, in XML format
Success
response?seo.Sitemapapplication/jsoncurl -X GET 'https://spider.omniplex.gg/list/sitemap.xml'nullSearches the list returning a list of bots/servers/teams/packs that match the query
application/json- body
page?integerThe page of results to return for every target type, starting at 1
query?stringservers?shards?tags?target_types?array<string>total_members?votes?Success
application/json- response
bots?array<>counts?The total number of matches for each searched target type, across all pages
packs?array<>per_page?integerHow many results of each target type a page holds
servers?array<>target_types?array<string>teams?array<>curl -X POST 'https://spider.omniplex.gg/list/search' \ -H 'Content-Type: application/json' \ -d '{}'{ "bots": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "boosted_until": "2019-08-24T14:15:22Z", "bot_id": "string", "card_color": "string", "clicks": 0, "created_at": "2019-08-24T14:15:22Z", "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "library": "string", "nsfw": true, "premium": true, "servers": 0, "shards": 0, "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "supporter_badge": true, "tags": [ "string" ], "type": "string", "user": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" }, "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "vote_blitz_until": "2019-08-24T14:15:22Z", "votes": 0 } ], "counts": { "property1": 0, "property2": 0 }, "packs": [ { "bot_ids": [ "string" ], "bots": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "boosted_until": "2019-08-24T14:15:22Z", "bot_id": "string", "card_color": "string", "clicks": 0, "created_at": "2019-08-24T14:15:22Z", "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "library": "string", "nsfw": true, "premium": true, "servers": 0, "shards": 0, "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "supporter_badge": true, "tags": [ "string" ], "type": "string", "user": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" }, "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "vote_blitz_until": "2019-08-24T14:15:22Z", "votes": 0 } ], "created_at": "2019-08-24T14:15:22Z", "emojis": [ { "animated": true, "downloads": 0, "id": "string", "name": "string", "position": 0, "vanity": "string" } ], "name": "string", "owner": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" }, "pack_type": "string", "server_ids": [ "string" ], "servers": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "avatar": "string", "boosted_until": "2019-08-24T14:15:22Z", "card_color": "string", "clicks": 0, "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "name": "string", "nsfw": true, "online_members": 0, "premium": true, "server_id": "string", "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "state": "string", "supporter_badge": true, "tags": [ "string" ], "total_members": 0, "type": "string", "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "votes": 0 } ], "short": "string", "sounds": [ { "downloads": 0, "duration_ms": 0, "id": "string", "name": "string", "position": 0, "vanity": "string" } ], "stickers": [ { "animated": true, "downloads": 0, "id": "string", "name": "string", "position": 0, "vanity": "string" } ], "tags": [ "string" ], "url": "string", "vote_banned": true, "votes": 0 } ], "per_page": 0, "servers": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "avatar": "string", "boosted_until": "2019-08-24T14:15:22Z", "card_color": "string", "clicks": 0, "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "name": "string", "nsfw": true, "online_members": 0, "premium": true, "server_id": "string", "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "state": "string", "supporter_badge": true, "tags": [ "string" ], "total_members": 0, "type": "string", "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "votes": 0 } ], "target_types": [ "string" ], "teams": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "created_at": "2019-08-24T14:15:22Z", "entities": { "bots": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "boosted_until": "2019-08-24T14:15:22Z", "bot_id": "string", "card_color": "string", "clicks": 0, "created_at": "2019-08-24T14:15:22Z", "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "library": "string", "nsfw": true, "premium": true, "servers": 0, "shards": 0, "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "supporter_badge": true, "tags": [ "string" ], "type": "string", "user": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" }, "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "vote_blitz_until": "2019-08-24T14:15:22Z", "votes": 0 } ], "members": [ { "created_at": "2019-08-24T14:15:22Z", "data_holder": true, "flags": [ "string" ], "itag": "6b5f8e7b-1e8c-4611-b693-ee8faa950c62", "mentionable": true, "service": "string", "team_id": "string", "user": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" } } ], "servers": [ { "approximate_votes": 0, "asset_versions": { "property1": "string", "property2": "string" }, "avatar": "string", "boosted_until": "2019-08-24T14:15:22Z", "card_color": "string", "clicks": 0, "featured_until": "2019-08-24T14:15:22Z", "hidden_stats": [ "string" ], "highlighted": true, "invite_clicks": 0, "name": "string", "nsfw": true, "online_members": 0, "premium": true, "server_id": "string", "short": "string", "spotlighted_until": "2019-08-24T14:15:22Z", "state": "string", "supporter_badge": true, "tags": [ "string" ], "total_members": 0, "type": "string", "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "views_30d": 0, "votes": 0 } ], "targets": [ "string" ] }, "extra_links": [ { "name": "string", "value": "string" } ], "id": "string", "name": "string", "nsfw": true, "service": "string", "short": "string", "tags": [ "string" ], "updated_at": "2019-08-24T14:15:22Z", "vanity": "string", "vanity_ref": "e1b95001-3370-4367-9787-1fb904c7b8c7", "vote_banned": true, "votes": 0 } ]}Returns every tag used by an approved or certified bot or a public, approved or certified server, matched case-insensitively, with how many bots and servers use it. Most used first. Cached for 30 minutes.
Success
application/json- response
tags?array<>Every tag in use, most used first
curl -X GET 'https://spider.omniplex.gg/list/tags'{ "tags": [ { "bots": 0, "servers": 0, "tag": "string" } ]}All-time platform numbers and a month-by-month history of votes, reviews, new listings and sign-ups. Cached for 10 minutes.
Success
application/json- response
approvals?integerListings approved since review history starts
int64denials?integerListings denied since review history starts
int64generated_at?stringWhen these numbers were worked out. They're cached for a few minutes
date-timemonths?array<>One entry per month, oldest first
reviews_since?stringWhen review history starts
date-timevoters_all_time?integerDifferent people who have ever voted
int64votes_all_time?integerEvery vote cast since vote history starts, including ones cleared by monthly resets
int64votes_since?stringWhen vote history starts
date-timevotes_this_month?integerVotes cast since the last monthly reset
int64curl -X GET 'https://spider.omniplex.gg/list/stats/history'{ "approvals": 0, "denials": 0, "generated_at": "2019-08-24T14:15:22Z", "months": [ { "approved": 0, "denied": 0, "month": "string", "new_bots": 0, "new_servers": 0, "new_users": 0, "voters": 0, "votes": 0 } ], "reviews_since": "2019-08-24T14:15:22Z", "voters_all_time": 0, "votes_all_time": 0, "votes_since": "2019-08-24T14:15:22Z", "votes_this_month": 0}Gets basic statistics of the list
Success
application/json- response
total_approved_bots?integerThe total number of approved bots on the list
int64total_approved_servers?integerThe total number of approved servers on the list
int64total_banned_users?integerThe total number of users banned from the list
int64total_bots?integerThe list of all bots on the list as ListStatsBot objects (partial bot objects)
int64total_certified_bots?integerThe total number of certified bots on the list
int64total_certified_servers?integerThe total number of certified servers on the list
int64total_denied_bots?integerThe total number of bots denied on review
int64total_denied_servers?integerThe total number of servers denied on review
int64total_packs?integerThe total number of packs on the list
int64total_pending_bots?integerThe total number of bots awaiting review
int64total_pending_servers?integerThe total number of servers awaiting review
int64total_servers?integerThe total number of servers on the list
int64total_staff?integerThe total number of staff members on the list
int64total_tickets?integerThe total number of tickets created on the list
int64total_users?integerThe total number of users on the list
int64total_vote_banned_bots?integerThe total number of bots banned from voting
int64total_vote_banned_servers?integerThe total number of servers banned from voting
int64total_votes?integerThe total number of votes on the list
int64curl -X GET 'https://spider.omniplex.gg/list/stats'{ "total_approved_bots": 0, "total_approved_servers": 0, "total_banned_users": 0, "total_bots": 0, "total_certified_bots": 0, "total_certified_servers": 0, "total_denied_bots": 0, "total_denied_servers": 0, "total_packs": 0, "total_pending_bots": 0, "total_pending_servers": 0, "total_servers": 0, "total_staff": 0, "total_tickets": 0, "total_users": 0, "total_vote_banned_bots": 0, "total_vote_banned_servers": 0, "total_votes": 0}Gets the official partners of the list
Success
application/json- response
partner_types?array<>partners?array<>curl -X GET 'https://spider.omniplex.gg/list/partners'{ "partner_types": [ { "created_at": "2019-08-24T14:15:22Z", "icon": "string", "id": "string", "name": "string", "short": "string" } ], "partners": [ { "bot": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" }, "bot_id": "string", "created_at": "2019-08-24T14:15:22Z", "id": "string", "links": [ { "name": "string", "value": "string" } ], "name": "string", "short": "string", "type": "string", "user": { "avatar": "string", "bot": true, "display_name": "string", "extra_data": { "property1": null, "property2": null }, "flags": [ "string" ], "id": "string", "status": "string", "username": "string" } } ]}Returns all of the staff templates used for reviewing bots and servers. Filter to one entity type with ?entity_type=bot or ?entity_type=server; omit it to get both.
entity_type?stringFilter templates to just "bot" or "server". Omit for both.
Success
application/json- response
template_types?array<>templates?array<>curl -X GET 'https://spider.omniplex.gg/list/staff-templates'{ "template_types": [ { "icon": "string", "id": "string", "name": "string", "short": "string" } ], "templates": [ { "created_at": "2019-08-24T14:15:22Z", "description": "string", "emoji": "string", "entity_type": "string", "id": "string", "name": "string", "tags": [ "string" ], "type": "string" } ]}