{"id":18572712,"url":"https://github.com/botblock/discord-botlist-best-practices","last_synced_at":"2025-04-10T07:31:28.163Z","repository":{"id":44718534,"uuid":"201111097","full_name":"botblock/discord-botlist-best-practices","owner":"botblock","description":"Bot lists must meet these minimum requirements to be considered a bot list.","archived":false,"fork":false,"pushed_at":"2022-01-29T01:04:27.000Z","size":7,"stargazers_count":9,"open_issues_count":2,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-24T18:05:42.907Z","etag":null,"topics":["discord","discordapp","discordbotlist"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/botblock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-07T19:01:55.000Z","updated_at":"2021-12-18T13:48:15.000Z","dependencies_parsed_at":"2022-09-04T10:00:54.186Z","dependency_job_id":null,"html_url":"https://github.com/botblock/discord-botlist-best-practices","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botblock%2Fdiscord-botlist-best-practices","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botblock%2Fdiscord-botlist-best-practices/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botblock%2Fdiscord-botlist-best-practices/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/botblock%2Fdiscord-botlist-best-practices/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/botblock","download_url":"https://codeload.github.com/botblock/discord-botlist-best-practices/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248176323,"owners_count":21060046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["discord","discordapp","discordbotlist"],"created_at":"2024-11-06T23:07:00.231Z","updated_at":"2025-04-10T07:31:27.911Z","avatar_url":"https://github.com/botblock.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Best Practices for Discord Bot Lists\n\n---\n\n*Bot lists must meet these minimum requirements to be considered a bot list.*\n\n## Your bot list must:\n\n1. use a custom domain name with a respectable, paid TLD.\n2. not be a `[xyz].glitch.me`, `[xyz].repl.co` or any free (sub)domain with free hosting provider.\n   - Glitch, Repl, or any other free host is acceptable if:\n      - Uptime is immaculate\n      - A custom domain name is used (whilst still following point `1`)\n3. be fully functioning.\n   - No broken links/buttons.\n4. have consistent uptime.\n   - Minor downtime for maintenance or fixing issues is fine\n5. have bot listing requirements (such as no NSFW outside NSFW channels, respect rate-limits, don't respond to other bots, etc.)\n6. blur NSFW profile pictures.\n7. have a ToS and Privacy page.\n\n---\n\n*Bot lists should meet these requirements to be a good bot list.*\n\n## Your bot list should:\n\n1. not display all bots on the homepage.\n2. not be hosted on any free hosting provider.\n3. be mobile friendly.\n4. not be paid access only.\n5. have an API with good documentation.\n   - API should support `GET`ting bot information\n      - Sends a JSON body for the response data\n   - API should support `POST`ing bot stats\n      - Server/guild count\n      - Shard support\n      - Uses an Authorization header\n      - Accepts a JSON body format for data\n6. respond with correct status codes.\n   - All pages that load correctly should respond with a 2xx status code\n   - Not found (404) pages should respond with a 404 status code\n   - Any API should also send correct status codes\n7. not overuse ads. Ads are okay, but shouldn't influence the browsing experience in a negative way.\n8. have API (and the frontend if possible) ratelimits. (60 requests per minute recommended)\n9. have a way for users to contact the folks operating the site (email, Discord, etc.).\n10. notify users beforehand when your TOS or privacy policy is changing.\n11. not be a copy of other's bot lists (open sourced lists, including lists that are edited or modified from other's lists).\n\n---\n\nIf anyone wants to change or add something, please [make a pull request](https://github.com/botblock/discord-botlist-best-practices).\n\nInspired by [Discord Bot Best Practices](https://github.com/meew0/discord-bot-best-practices)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotblock%2Fdiscord-botlist-best-practices","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbotblock%2Fdiscord-botlist-best-practices","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbotblock%2Fdiscord-botlist-best-practices/lists"}