API Version 2

Token

Tokens are provided on a per-bot basis. View your bot's bot list token by finding your bot and clicking the Token button.

• All requests use JSON.
• Please send POST requests with Content-Type: application/json with valid JSON in the body.
• When a token is required (When token needed is shown), please add your token to your HTTP Authorization header.
  • Authorization: dd8c7533eabfa62174a549f7b11678962ec00f8727537

V2 Methods

https://ls.terminal.ink/api/v2/

GET /bots

Obtain a JSON encoded array of objects for all bots

GET /bots/:id

Obtain JSON encoded information about a specific bot

{
    "ok": true,
    "data": {
        "authors": [
            "190519304972664832",
            "366454817373290508",
            "180093157554388993",
            "261912303132344320",
            "178586069351137280",
            "86477779717066752"
        ], // ID of authors
        "cachedImages": {
            "avatar": "/appdata/f45e089e66155fac0899fcdad32886c828ec8d454ff6bb7860f33f6a3d29134e.png",
            "cover": "/appdata/3162280d9f8b45fab9953fc3ffed6cfbf4eb5fb25671a9972d3ce265ad231fef.png",
            "preview": [ // Links to the images, as downloaded by the server.
                "/appdata/de0c91656afb9edef0bc56407163a1f45735242fa04b4def7841deaa5fdb9e73.png",
                "/appdata/029ace8547487f644c291b495249d930f318ad08def43a6911097c52f07bdf44.png",
                "/appdata/b08e3d35685b2466bac2fff5e49b082542b1b64be47a54a99063031f853bc054.png",
                "/appdata/5fe64ae0d3af5371bb2a19fc124476365fa037d995055de2d835e901b09143e8.png"
            ]
        },
        "category": "other",
        "contents": [
            {
                "description": "The open source Discord App Store",
                "locale": "en-GB",
                "name": "Discord Apps Marketplace",
                "page": "[View this page at GitHub](https://github.com/Terminal/ls.terminal.ink/tree/master/website)\r\n\r\n# ls.terminal.ink\r\n\r\n## Development Team\r\nCategory            | People\r\n------------------- | --------------------------\r\nLead Developer      | 7coil#3175 ([@lepon01](https://github.com/lepon01))\r\nSecondary Developer | Devoxin#0387 ([@Devoxin](https://github.com/Devoxin))\r\nde                  | Andre_601#0601 ([@Andre601](https://github.com/Andre601))\r\nfr                  | iDroid27#4441 ([@iDroid27](https://github.com/iDroid27))\r\nfr                  | Bowser65#4680 ([@Bowser65](https://github.com/Bowser65))\r\nda                  | Saederup92#2901 ([@Saederup92](https://github.com/Saederup92))\r\nzh-cn               | Tansc#8171 ([@Tansc161](https://github.com/Tansc161))\r\n\r\n## Licence\r\nAll files (except the exceptions below) are licenced under the GNU Affero General Public Licence.\r\n\r\nFor licencing without the GNU AGPL, contact `7coil#3175` or email at `admin@moustacheminer.com`\r\n\r\n### Exceptions\r\n- `/website/www-root/js/modalPerms.js` is licenced under the MIT licence.\r\n- `/website/class/ImageCache.js` is licenced under the MIT licence.\r\n\r\n## Deployment\r\n- `npm i`\r\n- `npm start`\r\n\r\n"
            }
        ],
        "count": null,
        "created": 1542761901388,
        "edited": 1552957349144,
        "flags": {
            "adverts": true,
            "inAppPurchases": true
        },
        "github": {
            "owner": "terminal",
            "repo": "ls.terminal.ink"
        },
        "hide": true,
        "id": "473861594749861909",
        "images": {
            "avatar": "https://cdn.discordapp.com/avatars/473861594749861909/1247b144d00752a63ab3a0e94d262a6d.webp",
            "cover": "https://pbs.twimg.com/profile_banners/770959712791597056/1550571087",
            "preview": [ // Links to the images.
                "https://its-not-advertising-if-the-website-doesnt-exist-anymore.moustacheminer.com/chrome_2018-11-24_19-07-43.png",
                "https://its-not-advertising-if-the-website-doesnt-exist-anymore.moustacheminer.com/chrome_2018-11-24_18-51-39.png",
                "https://its-not-advertising-if-the-website-doesnt-exist-anymore.moustacheminer.com/chrome_2018-11-24_18-52-18.png",
                "https://its-not-advertising-if-the-website-doesnt-exist-anymore.moustacheminer.com/chrome_2019-01-10_15-35-07.png"
            ]
        },
        "invite": "https://discordapp.com/api/oauth2/authorize?client_id=473861594749861909&permissions=0&scope=bot",
        "legacy": true, // Bots made before ls.terminal.ink Version 10 was released
        "nsfw": false,
        "oauth": null,
        "random": 11.612670873071673, // The score. If fetched at "https://ls.terminal.ink/en-GB/api/v2", 
        "reviews": [],
        "state": "approved",
        "support": "https://discord.gg/8uC6aKZ",
        "trigger": {
            "customisable": false,
            "mentionable": false,
            "prefix": [ // List of acceptable prefixes
                "go won"
            ]
        },
        "videos": {
            "youku": null,
            "youtube": "m5qwcYL8a0o" // ID of YouTube video
        },
        "website": "https://discordapps.dev/en-GB/bots/473861594749861909" // Link to the bot's website
    }
}

Change many things

{
  "bot": {
    "nsfw": true,
    "oauth": "123456",
    "website": "https://discordbots.co.uk/",
    "count": 87932,
    "category": "fun"
  }
}