Skip to content

Instantly share code, notes, and snippets.

@Cryptizism
Last active November 1, 2023 22:21
Show Gist options
  • Save Cryptizism/78c55b3e8f503593467f9bd45eb2989b to your computer and use it in GitHub Desktop.
Save Cryptizism/78c55b3e8f503593467f9bd45eb2989b to your computer and use it in GitHub Desktop.
Twitch 3rd party extension endpoints

3rd Party Emote Extension Endpoints (AFAIK)

Codenames

  • User ID = Twitch User ID (you can get it here)
  • Username = Twitch User's name
  • Emote ID = ID assigned to an emote (Found in the URL)
  • Global = Can be used in any chat
  • Channel Emote = Emotes that are assigned to a certain chat
  • Emote Size = This will vary from platform to platfrom, the smaller the number the smaller the image.
    • If it's BTTV this will be 1x, 2x or 3x.
    • If it's FFZ 1, 2 (sometimes it may be 3, 4 if it is HQ).
    • If it's 7TV x1, x2, x3, x4.

BTTV (v3)

Emotes

  • Global Emotes: https://api.betterttv.net/3/cached/emotes/global

    Payload Example
    [
       {
          "id":"54fa8f1401e468494b85b537",
          "code":":tf:",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa8fce01e468494b85b53c",
          "code":"CiGrip",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa903b01e468494b85b53f",
          "code":"DatSauce",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa909b01e468494b85b542",
          "code":"ForeverAlone",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa90ba01e468494b85b543",
          "code":"GabeN",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa90f201e468494b85b545",
          "code":"HailHelix",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fa932201e468494b85b555",
          "code":"ShoopDaWhoop",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       },
       {
          "id":"54fab45f633595ca4c713abc",
          "code":"M&Mjc",
          "imageType":"png",
          "userId":"5561169bd6b9d206222a8c19"
       }
    ]
  • Top emotes: https://api.betterttv.net/3/emotes/shared/top

    Paramaters
    Parameter Default Values Description Required
    offset 0 0 <= value The offset of emotes from the top No
    limit 50 1 <= value The amount of results No
    sort null 1 Sorts by oldest No
    Example Payload
    [
         {
      	  "emote":{
      		 "id":"5f1b0186cf6d2144653d2970",
      		 "code":"catJAM",
      		 "imageType":"gif",
      		 "user":{
      			"id":"5f17a10cfe85fb4472d107b4",
      			"name":"madlittlecat",
      			"displayName":"MadLittleCat",
      			"providerId":"36646922"
      		 }
      	  },
      	  "total":524368
         },
         {
      	  "emote":{
      		 "id":"56e9f494fff3cc5c35e5287e",
      		 "code":"monkaS",
      		 "imageType":"png",
      		 "user":{
      			"id":"55bfba180baa41467919aabf",
      			"name":"monkasen",
      			"displayName":"Monkasen",
      			"providerId":"97950061"
      		 }
      	  },
      	  "total":468835
         },
         {
      	  "emote":{
      		 "id":"583089f4737a8e61abb0186b",
      		 "code":"OMEGALUL",
      		 "imageType":"png",
      		 "user":{
      			"id":"56213bb5f3705ab9596e09a9",
      			"name":"worthlessvoid",
      			"displayName":"worthlessvoid",
      			"providerId":"100758407"
      		 }
      	  },
      	  "total":445333
         },
      ...
    ]
  • Channel Emotes: https://api.betterttv.net/3/cached/users/twitch/USER_ID_HERE

    Payload Example
    {
        "id":"602017945244db6c5980e4bc",
        "bots":[
        
        ],
        "avatar":"https://static-cdn.jtvnw.net/jtv_user_pictures/27736622-b369-4a34-8daf-3db1334764dc-profile_image-300x300.png",
        "channelEmotes":[
           {
              "id":"60bb405ff8b3f62601c38e47",
              "code":"uhhhNo",
              "imageType":"gif",
              "userId":"602017945244db6c5980e4bc"
           },
           {
              "id":"60c12eb8f8b3f62601c3b680",
              "code":"peepoHeyyy",
              "imageType":"gif",
              "userId":"602017945244db6c5980e4bc"
           }
        ],
        "sharedEmotes":[
           {
              "id":"5f503a0568d9d86c020db3bb",
              "code":"NOPERS",
              "imageType":"gif",
              "user":{
                 "id":"5629471beec26b7857b13cce",
                 "name":"c_a_k_e",
                 "displayName":"C_a_k_e",
                 "providerId":"43899589"
              }
           },
           {
              "id":"5d7eefb7c0652668c9e4d394",
              "code":"modCheck",
              "imageType":"gif",
              "user":{
                 "id":"57b208c69d3c46b572bbbd71",
                 "name":"verbalsilence",
                 "displayName":"VerbalSilence",
                 "providerId":"57265566"
              }
           },
           {
              "id":"5ffae10a346b880825ab2065",
              "code":"monkaGIGAftRobertDowneyJr",
              "imageType":"gif",
              "user":{
                 "id":"5a227ca95ebe202db3f9d9cd",
                 "name":"ricultima",
                 "displayName":"RicUltima",
                 "providerId":"77104634"
              }
           },
           {
              "id":"60983d5d39b5010444d0e8d4",
              "code":"DonoWall",
              "imageType":"gif",
              "user":{
                 "id":"5e8f702c8fb1ca5cde58a720",
                 "name":"iamsandramg",
                 "displayName":"IamSandraMG",
                 "providerId":"194818791"
              }
           },
           {
              "id":"6074af3939b5010444cfe05c",
              "code":"Drake",
              "imageType":"gif",
              "user":{
                 "id":"5b297dfa6a37401609f725df",
                 "name":"boraflame",
                 "displayName":"boraflame",
                 "providerId":"142585756"
              }
           },
           {
              "id":"608f154f39b5010444d0a765",
              "code":"peepoTalk",
              "imageType":"gif",
              "user":{
                 "id":"603dd01b9978512a85ee3196",
                 "name":"2hyru",
                 "displayName":"2Hyru",
                 "providerId":"44710284"
              }
           }
        ]
     }
  • Latest emotes: https://api.betterttv.net/3/emotes/shared

    Paramaters
    Parameter Default Values Description Required
    offset 0 0 <= value The offset of emotes from the top No
    limit 50 1 <= value The amount of results No
    sort null 1 Sorts by oldest No
    Example Payload
    [
         {
      	  "id":"620908bb06fd6a9f5be462e0",
      	  "code":"RarePartyton",
      	  "imageType":"gif",
      	  "user":{
      		 "id":"5d17e47998539c4801cbf473",
      		 "name":"bc0z",
      		 "displayName":"bc0z",
      		 "providerId":"236627427"
      	  }
         },
         {
      	  "id":"620906bf06fd6a9f5be462b2",
      	  "code":"Ghoul",
      	  "imageType":"png",
      	  "user":{
      		 "id":"6207a77fbb1080645beea98c",
      		 "name":"dombrawleroff",
      		 "displayName":"dombrawleroff",
      		 "providerId":"701924118"
      	  }
         },
         {
      	  "id":"6209056506fd6a9f5be462a5",
      	  "code":"PetSergo",
      	  "imageType":"gif",
      	  "user":{
      		 "id":"61f9635bbb1080645b0ed8ac",
      		 "name":"daddy7issues",
      		 "displayName":"daddy7issues",
      		 "providerId":"140068098"
      	  }
         }
      ]
  • Emote Search: https://api.betterttv.net/3/emotes/shared/search

    Paramaters
    Parameter Default Values Description Required
    query null Any querystring The emote you wish to search for Yes
    offset 0 0 <= value The offset of emotes from the top No
    limit 50 1 <= value The amount of results No
    sort null 1 Sorts by oldest No
    Example Payload
    [
         {
      	  "id":"5f23f3f965fe924464eeef01",
      	  "code":"XQCAYAYA",
      	  "imageType":"png",
      	  "user":{
      		 "id":"5f231c0b713a6144748a80bc",
      		 "name":"haidikoira",
      		 "displayName":"haidikoira",
      		 "providerId":"51359974"
      	  }
         },
         {
      	  "id":"5e436e50751afe7d553d9f01",
      	  "code":"XQCDANCINGREALLYFASTLY",
      	  "imageType":"gif",
      	  "user":{
      		 "id":"5b8bf67e17622a62d481fb07",
      		 "name":"chuklahkong",
      		 "displayName":"ChuklahKong",
      		 "providerId":"222840864"
      	  }
         },
         {
      	  "id":"5f82dacee9c9344a8f357fe9",
      	  "code":"XQCHYPERWALK",
      	  "imageType":"gif",
      	  "user":{
      		 "id":"5e4ad29e751afe7d553de9f5",
      		 "name":"primuleris",
      		 "displayName":"PrimulEris",
      		 "providerId":"452284851"
      	  }
         }
      ]

Misc

  • Badges: https://api.betterttv.net/3/cached/badges

    Payload Example
    [
        {
           "id":"552351b462e6bd0027aee68d",
           "name":"aaron128l",
           "displayName":"Aaron128l",
           "providerId":"46619672",
           "badge":{
              "description":"NightDev Support Team",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-support.svg"
           }
        },
        {
           "id":"556259a539e4290d22279f3d",
           "name":"ehsankia",
           "displayName":"EhsanKia",
           "providerId":"32825276",
           "badge":{
              "description":"NightDev Developer",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-dev.svg"
           }
        },
        {
           "id":"54f94bd18edd5fcd455f21d1",
           "name":"jacksack",
           "displayName":"Jacksack",
           "providerId":"26651189",
           "badge":{
              "description":"NightDev Design Team",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-support.svg"
           }
        },
        {
           "id":"54ee2465b822020506c52a52",
           "name":"night",
           "displayName":"Night",
           "providerId":"11785491",
           "badge":{
              "description":"NightDev Developer",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-dev.svg"
           }
        },
        {
           "id":"54f93e618edd5fcd455f213f",
           "name":"polecat",
           "displayName":"Polecat",
           "providerId":"20846357",
           "badge":{
              "description":"NightDev Developer",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-dev.svg"
           }
        },
        {
           "id":"56527762791b501903f8ba52",
           "name":"slikrick",
           "displayName":"slikrick",
           "providerId":"107780543",
           "badge":{
              "description":"NightDev Support Team",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-support.svg"
           }
        },
        {
           "id":"5551b1f17676617e17dd2f0b",
           "name":"teak",
           "displayName":"Teak",
           "providerId":"90282771",
           "badge":{
              "description":"NightDev Developer",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-dev.svg"
           }
        },
        {
           "id":"57b1e81425cb03b67237f27e",
           "name":"vasp",
           "displayName":"Vasp",
           "providerId":"38974721",
           "badge":{
              "description":"NightDev Developer",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-dev.svg"
           }
        },
        {
           "id":"54f942048edd5fcd455f217b",
           "name":"nightmare",
           "displayName":"Nightmare",
           "providerId":"28878649",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"55414bd649f8b21163d0e125",
           "name":"techno",
           "displayName":"Techno",
           "providerId":"61880793",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"54f93ec48edd5fcd455f2149",
           "name":"thelucky007",
           "displayName":"TheLucky007",
           "providerId":"47230158",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"55714c22c7a34e186b3221e6",
           "name":"marcfryd",
           "displayName":"MarcFryd",
           "providerId":"44710465",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5626a3d7eec26b7857b139e7",
           "name":"blakelund",
           "displayName":"Blakelund",
           "providerId":"51573073",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5641214d5ddf5f01746f3eeb",
           "name":"korppiworppi",
           "displayName":"KORPPIWORPPI",
           "providerId":"57944699",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"58f01b39c16464152ea8a319",
           "name":"aiden",
           "displayName":"Aiden",
           "providerId":"87763385",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5584dbe1bf56f8196a1b33e5",
           "name":"wipz",
           "displayName":"Wipz",
           "providerId":"47965880",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"57508bb808dc2699571a35c8",
           "name":"robertjan",
           "displayName":"RobertJan",
           "providerId":"84830064",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"59dd0f802c047947fb7d8646",
           "name":"cleanbin",
           "displayName":"CleanBin",
           "providerId":"140687892",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"59e4e8f08c22a247ead4f2a7",
           "name":"m4ngo",
           "displayName":"m4ngo",
           "providerId":"177162588",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5521b74562e6bd0027aee56b",
           "name":"cheesey",
           "displayName":"CHEESEY",
           "providerId":"60105387",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5525ed7c6fdaa554655b6e90",
           "name":"mohshiin",
           "displayName":"mohshiin",
           "providerId":"23706734",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"56b11caa0447326005fa7f13",
           "name":"owndragoon",
           "displayName":"Owndragoon",
           "providerId":"24314162",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        },
        {
           "id":"5bf0b340c2302f6b858265a6",
           "name":"goblin_fps",
           "displayName":"Goblin_FPS",
           "providerId":"139744984",
           "badge":{
              "description":"BetterTTV Emote Approver",
              "svg":"https://cdn.betterttv.net/assets/icons/badge-approver.svg"
           }
        }
     ]

FFZ (v1)

Emotes

  • Global Emotes: https://api.frankerfacez.com/v1/set/global

    Payload Example
    {
        "default_sets":[
           3
        ],
        "sets":{
           "3":{
              "id":3,
              "_type":1,
              "icon":null,
              "title":"Global Emotes",
              "css":null,
              "emoticons":[
                 {
                    "id":9,
                    "name":"ZrehplaR",
                    "height":30,
                    "width":33,
                    "public":false,
                    "hidden":true,
                    "modifier":false,
                    "offset":null,
                    "margins":null,
                    "css":null,
                    "owner":{
                       "_id":2,
                       "name":"dansalvato",
                       "display_name":"dansalvato"
                    },
                    "urls":{
                       "1":"//cdn.frankerfacez.com/emote/9/1"
                    },
                    "status":1,
                    "usage_count":1,
                    "created_at":"2015-02-07T05:33:23.123Z",
                    "last_updated":"2015-05-30T18:32:47.401Z"
                 },
                 {
                    "id":6,
                    "name":"YooHoo",
                    "height":34,
                    "width":28,
                    "public":false,
                    "hidden":false,
                    "modifier":false,
                    "offset":null,
                    "margins":null,
                    "css":null,
                    "owner":{
                       "_id":2,
                       "name":"dansalvato",
                       "display_name":"dansalvato"
                    },
                    "urls":{
                       "1":"//cdn.frankerfacez.com/emote/6/1"
                    },
                    "status":1,
                    "usage_count":1,
                    "created_at":"2015-04-02T10:24:46.923Z",
                    "last_updated":"2015-04-02T10:24:46.923Z"
                 },
                 {
                    "id":4,
                    "name":"ManChicken",
                    "height":29,
                    "width":30,
                    "public":false,
                    "hidden":false,
                    "modifier":false,
                    "offset":null,
                    "margins":null,
                    "css":null,
                    "owner":{
                       "_id":2,
                       "name":"dansalvato",
                       "display_name":"dansalvato"
                    },
                    "urls":{
                       "1":"//cdn.frankerfacez.com/emote/4/1"
                    },
                    "status":1,
                    "usage_count":1,
                    "created_at":"2015-04-02T10:24:46.530Z",
                    "last_updated":"2015-04-02T10:24:46.530Z"
                 }
              ]
           }
        },
        "users":{
           "4330":[
              "sirstendec"
           ]
        }
     }
  • Channel Emotes: https://api.frankerfacez.com/v1/room/id/USER_ID_HERE

    Payload Example
    {
        "room":{
           "_id":1012125,
           "twitch_id":641382440,
           "youtube_id":null,
           "id":"cryptslive",
           "is_group":false,
           "display_name":"CryptsLive",
           "set":1012147,
           "moderator_badge":"//cdn.frankerfacez.com/room-badge/mod/id/641382440/v/d4d4152e/1",
           "vip_badge":{
              "1":"//cdn.frankerfacez.com/room-badge/vip/id/641382440/v/30fbf870/1",
              "2":"//cdn.frankerfacez.com/room-badge/vip/id/641382440/v/30fbf870/2",
              "4":null
           },
           "mod_urls":{
              "1":"//cdn.frankerfacez.com/room-badge/mod/id/641382440/v/d4d4152e/1",
              "2":"//cdn.frankerfacez.com/room-badge/mod/id/641382440/v/d4d4152e/2",
              "4":"//cdn.frankerfacez.com/room-badge/mod/id/641382440/v/d4d4152e/4"
           },
           "user_badges":{
              "2":[
                 "fossabot",
                 "oura_bot",
                 "nightbot"
              ]
           },
           "user_badge_ids":{
              "2":[
                 237719657,
                 652867592,
                 19264788
              ]
           },
           "css":null
        },
        "sets":{
           "1012147":{
              "id":1012147,
              "_type":1,
              "icon":null,
              "title":"Channel: CryptsLive",
              "css":null,
              "emoticons":[
                 {
                    "id":571351,
                    "name":"PogU",
                    "height":32,
                    "width":32,
                    "public":true,
                    "hidden":false,
                    "modifier":false,
                    "offset":null,
                    "margins":null,
                    "css":null,
                    "owner":{
                       "_id":616345,
                       "name":"eimlur",
                       "display_name":"Eimlur"
                    },
                    "urls":{
                       "1":"//cdn.frankerfacez.com/emote/571351/1",
                       "2":"//cdn.frankerfacez.com/emote/571351/2",
                       "4":"//cdn.frankerfacez.com/emote/571351/4"
                    },
                    "status":1,
                    "usage_count":62,
                    "created_at":"2021-02-03T05:23:56.366Z",
                    "last_updated":"2021-02-03T13:46:36.207Z"
                 },
                 {
                    "id":239504,
                    "name":"5Head",
                    "height":32,
                    "width":26,
                    "public":true,
                    "hidden":false,
                    "modifier":false,
                    "offset":null,
                    "margins":null,
                    "css":null,
                    "owner":{
                       "_id":209159,
                       "name":"sublimedtv",
                       "display_name":"SublimedTV"
                    },
                    "urls":{
                       "1":"//cdn.frankerfacez.com/emote/239504/1",
                       "2":"//cdn.frankerfacez.com/emote/239504/2",
                       "4":"//cdn.frankerfacez.com/emote/239504/4"
                    },
                    "status":1,
                    "usage_count":126792,
                    "created_at":"2018-03-14T21:31:15.783Z",
                    "last_updated":"2018-03-15T00:45:56.710Z"
                 }
              ]
           }
        }
     }
  • Emote search: https://api.frankerfacez.com/v1/emoticons

    Paramaters
    Parameter Default Values Description
    high_dpi off on, off Whether or not to only include emotes with high-DPI images.
    page 1 1 <= value The page of emotes to return.
    per_page 50 1 <= value <= 200 The number of emotes to return on a single page.
    private off on, off Whether or not to include non-public emotes.
    q null null A search string to filter the results.
    sort created-desc name, owner, count, updated, created Sort the output. Optionally, include a sorting direction after a hyphen. Example: sort=count-desc
    Payload Example
    {
     "_links":{
       "next":"http://api.frankerfacez.com/v1/emoticons?page=2",
       "self":"http://api.frankerfacez.com/v1/emoticons?page=1"
     },
     "_pages":1068,
     "_total":53371,
      "emoticons":[
        ...
      ]
    } 
  • Single Emotes: https://api.frankerfacez.com/v1/emote/EMOTE_ID_HERE

    Payload Example
    {
        "emote": {
      	"css": null,
      	"height": 29,
      	"hidden": false,
      	"id": 25927,
      	"margins": null,
      	"name": "CatBag",
      	"owner": {
      	  "display_name": "Wolsk",
      	  "id": 3,
      	  "name": "wolsk"
      	},
      	"public": false,
      	"urls": {
      	  "1": "//cdn.frankerfacez.com/emoticon/25927/1",
      	  "2": "//cdn.frankerfacez.com/emoticon/25927/2",
      	  "4": "//cdn.frankerfacez.com/emoticon/25927/4"
      	},
      "width": 32
       }
      }
  • Emote Image: https://cdn.frankerfacez.com/emote/EMOTE_ID_HERE/EMOTE_SIZE_HERE

Misc

  • Badges: https://api.frankerfacez.com/v1/badges/ids

    Payload Example
    {
        "badges":[
           {
              "id":1,
              "name":"developer",
              "title":"FFZ Developer",
              "slot":5,
              "replaces":null,
              "color":"#FAAF19",
              "image":"//cdn.frankerfacez.com/badge/1/1",
              "urls":{
                 "1":"//cdn.frankerfacez.com/badge/1/1",
                 "2":"//cdn.frankerfacez.com/badge/1/2",
                 "4":"//cdn.frankerfacez.com/badge/1/4"
              },
              "css":null
           },
           {
              "id":2,
              "name":"bot",
              "title":"Bot",
              "slot":1,
              "replaces":"moderator",
              "color":"#595959",
              "image":"//cdn.frankerfacez.com/badge/2/1",
              "urls":{
                 "1":"//cdn.frankerfacez.com/badge/2/1",
                 "2":"//cdn.frankerfacez.com/badge/2/2",
                 "4":"//cdn.frankerfacez.com/badge/2/4"
              },
              "css":null
           },
           {
              "id":3,
              "name":"supporter",
              "title":"FFZ Supporter",
              "slot":5,
              "replaces":null,
              "color":"#755000",
              "image":"//cdn.frankerfacez.com/badge/3/1",
              "urls":{
                 "1":"//cdn.frankerfacez.com/badge/3/1",
                 "2":"//cdn.frankerfacez.com/badge/3/2",
                 "4":"//cdn.frankerfacez.com/badge/3/4"
              },
              "css":null
           }
        ],
        "users":{
           "1":[
              49399878,
              47852576
           ],
           "2":[
              73227142,
              82455692,
              70325788,
              34114894,
              46622312,
              39322179,
              101453214,
              64554337,
              48881827,
              70817199,
              70267567,
              82470301,
              54611651,
              47536726,
              54866013,
              46460189,
              70441528,
              63711349,
              72060828,
              68579745,
              62236428,
              46645946,
              48917729,
              72146566,
              63599988,
              76967948,
              49582121,
              81984630,
              66287935,
              80634293,
              78945918,
              85618415,
              70336451,
              50782456,
              31374715,
              90207882,
              55056264,
              90230294,
              60552281,
              62541963,
              68900833,
              62309228,
              54176359,
              92616126,
              87341167,
              79828269,
              95745847,
              92606683,
              89227988,
              96137216,
              92541779,
              78050433,
              96342571,
              71921435,
              62809083,
              97154041,
              102219721,
              102841631,
              89705949,
              62378871,
              86798089,
              79144839,
              105502329,
              98726268,
              106229680,
              64996626,
              110730363,
              89331540,
              108471770,
              91556469,
              78917118,
              55814789,
              81057962,
              56190878,
              62389123
           ]
       }
    }

Official Docs

https://www.frankerfacez.com/developers

7TV (v2)

Emotes

  • Global Emotes: https://api.7tv.app/v2/emotes/global

    Payload Example
    [
        {
           "id":"603ca884faf3a00014dff0ab",
           "name":"gachiBASS",
           "owner":{
              "id":"603ca86596832ffa78bf4e2b",
              "twitch_id":"",
              "login":"virtualzombie",
              "display_name":"virtualzombie",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":2,
           "visibility_simple":[
              "GLOBAL"
           ],
           "mime":"image/gif",
           "status":3,
           "tags":[
    
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603ca884faf3a00014dff0ab/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603ca884faf3a00014dff0ab/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603ca884faf3a00014dff0ab/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603ca884faf3a00014dff0ab/4x"
              ]
           ]
        },
        {
           "id":"603cb424c20d020014423c4e",
           "name":"RebeccaBlack",
           "owner":{
              "id":"603caa3396832ffa78c1aa0d",
              "twitch_id":"",
              "login":"no_title24",
              "display_name":"no_title24",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":2,
           "visibility_simple":[
              "GLOBAL"
           ],
           "mime":"image/png",
           "status":3,
           "tags":[
    
           ],
           "width":[
              23,
              34,
              54,
              92
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603cb424c20d020014423c4e/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603cb424c20d020014423c4e/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603cb424c20d020014423c4e/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603cb424c20d020014423c4e/4x"
              ]
           ]
        },
        {
           "id":"603ccbc82c7b4500143b46d6",
           "name":"peepoHappy",
           "owner":{
              "id":"603ccb8b96832ffa78f209b7",
              "twitch_id":"",
              "login":"widepeepoflo",
              "display_name":"widepeepoFlo",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":2,
           "visibility_simple":[
              "GLOBAL"
           ],
           "mime":"image/png",
           "status":3,
           "tags":[
    
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603ccbc82c7b4500143b46d6/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603ccbc82c7b4500143b46d6/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603ccbc82c7b4500143b46d6/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603ccbc82c7b4500143b46d6/4x"
              ]
           ]
        },
        {
           "id":"6043aa351d4963000d9dae57",
           "name":"forsenPls",
           "owner":{
              "id":"603bb6a596832ffa78e7b27b",
              "twitch_id":"",
              "login":"megakill3",
              "display_name":"MegaKill3",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              },
              "profile_picture_id":"add3acfec2fb4256816e944d79b94a0c"
           },
           "visibility":2,
           "visibility_simple":[
              "GLOBAL"
           ],
           "mime":"image/gif",
           "status":3,
           "tags":[
    
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/6043aa351d4963000d9dae57/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/6043aa351d4963000d9dae57/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/6043aa351d4963000d9dae57/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/6043aa351d4963000d9dae57/4x"
              ]
           ]
        },
        {
           "id":"60421fe677137b000de9e683",
           "name":"reckH",
           "owner":{
              "id":"603ca86596832ffa78bf4e2b",
              "twitch_id":"",
              "login":"virtualzombie",
              "display_name":"virtualzombie",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":2,
           "visibility_simple":[
              "GLOBAL"
           ],
           "mime":"image/png",
           "status":3,
           "tags":[
    
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/60421fe677137b000de9e683/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/60421fe677137b000de9e683/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/60421fe677137b000de9e683/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/60421fe677137b000de9e683/4x"
              ]
           ]
        }
     ]
  • Single Emotes: https://api.7tv.app/v2/emotes/EMOTE_ID

    Payload Example
    {
        "id": "60ae4a875d3fdae583c64313",
        "name": "FeelsDankMan",
        "owner": {
            "id": "60ae40fcaee2aa5538455d5a",
            "twitch_id": "",
            "login": "tomsomnium1",
            "display_name": "tomsomnium1",
            "role": {
                "id": "000000000000000000000000",
                "name": "",
                "position": 0,
                "color": 0,
                "allowed": 523,
                "denied": 0,
                "default": true
            }
        },
        "visibility": 0,
        "visibility_simple": [],
        "mime": "image/webp",
        "status": 3,
        "tags": [],
        "width": [
            27,
            41,
            65,
            110
        ],
        "height": [
            32,
            48,
            76,
            128
        ],
        "urls": [
            [
                "1",
                "https://cdn.7tv.app/emote/60ae4a875d3fdae583c64313/1x"
            ],
            [
                "2",
                "https://cdn.7tv.app/emote/60ae4a875d3fdae583c64313/2x"
            ],
            [
                "3",
                "https://cdn.7tv.app/emote/60ae4a875d3fdae583c64313/3x"
            ],
            [
                "4",
                "https://cdn.7tv.app/emote/60ae4a875d3fdae583c64313/4x"
            ]
        ]
    }
  • Channel Emotes: https://api.7tv.app/v2/users/USERNAME_HERE/emotes

    Payload Example
    [
        {
           "id":"603caa69faf3a00014dff0b1",
           "name":"Okayeg",
           "owner":{
              "id":"603caa3396832ffa78c1aa0d",
              "twitch_id":"",
              "login":"no_title24",
              "display_name":"no_title24",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":0,
           "visibility_simple":[
              
           ],
           "mime":"image/png",
           "status":3,
           "tags":[
              
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603caa69faf3a00014dff0b1/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603caa69faf3a00014dff0b1/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603caa69faf3a00014dff0b1/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603caa69faf3a00014dff0b1/4x"
              ]
           ]
        },
        {
           "id":"603caea243b9e100141caf4f",
           "name":"TrollDespair",
           "owner":{
              "id":"603cae2496832ffa78c758cd",
              "twitch_id":"",
              "login":"swyfty_",
              "display_name":"swyfty_",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":0,
           "visibility_simple":[
              
           ],
           "mime":"image/png",
           "status":3,
           "tags":[
              
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603caea243b9e100141caf4f/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603caea243b9e100141caf4f/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603caea243b9e100141caf4f/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603caea243b9e100141caf4f/4x"
              ]
           ]
        },
        {
           "id":"603caee4c20d020014423c13",
           "name":"VeryPog",
           "owner":{
              "id":"603caa9d96832ffa78c22c5e",
              "twitch_id":"",
              "login":"peepduck",
              "display_name":"peepduck",
              "role":{
                 "id":"000000000000000000000000",
                 "name":"",
                 "position":0,
                 "color":0,
                 "allowed":523,
                 "denied":0,
                 "default":true
              }
           },
           "visibility":0,
           "visibility_simple":[
              
           ],
           "mime":"image/gif",
           "status":3,
           "tags":[
              
           ],
           "width":[
              32,
              48,
              76,
              128
           ],
           "height":[
              32,
              48,
              76,
              128
           ],
           "urls":[
              [
                 "1",
                 "https://cdn.7tv.app/emote/603caee4c20d020014423c13/1x"
              ],
              [
                 "2",
                 "https://cdn.7tv.app/emote/603caee4c20d020014423c13/2x"
              ],
              [
                 "3",
                 "https://cdn.7tv.app/emote/603caee4c20d020014423c13/3x"
              ],
              [
                 "4",
                 "https://cdn.7tv.app/emote/603caee4c20d020014423c13/4x"
              ]
           ]
        }
     ]

Misc

  • Badges: https://api.7tv.app/v2/badges

    Paramaters
    Parameter Default Values Description Required
    user_identifier null object_id, twitch_id, or login What the api will return in order to indetidy the users Yes
    Payload Example
    {
    	"badges": [
    		{
    			"id": "60cd6255a4531e54f76d4bd4",
    			"name": "Admin",
    			"tooltip": "7TV Admin",
    			"urls": [
    				[
    					"1",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/1x",
    					""
    				],
    				[
    					"2",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/2x",
    					""
    				],
    				[
    					"3",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/3x",
    					""
    				]
    			],
    			"users": [
    				"24377667"
    			]
    		}
    	]
    }
  • Cometics: https://api.7tv.app/v2/cosmetics

    Paramaters
    Parameter Default Values Description Required
    user_identifier null object_id, twitch_id, or login What the api will return in order to indetidy the users Yes
    Payload Example
    {
    	"badges": [
    		{
    			"id": "60cd6255a4531e54f76d4bd4",
    			"name": "Admin",
    			"tooltip": "7TV Admin",
    			"urls": [
    				[
    					"1",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/1x",
    					""
    				],
    				[
    					"2",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/2x",
    					""
    				],
    				[
    					"3",
    					"https://cdn.7tv.app/badge/60cd6255a4531e54f76d4bd4/3x",
    					""
    				]
    			],
    			"users": [
    				"24377667"
    			]
    		}
    	],
    	"paints": [
    		{
    			"id": "61bede3db6b41ea54419bbb0",
    			"name": "Candy Cane",
    			"users": [
    				"24377667"
    			],
    			"function": "linear-gradient",
    			"color": -10197761,
    			"stops": [
    				{
    					"at": 0.1,
    					"color": -757935361
    				},
    				{
    					"at": 0.2,
    					"color": -757935361
    				},
    				{
    					"at": 0.2,
    					"color": -10197761
    				},
    				{
    					"at": 0.3,
    					"color": -10197761
    				}
    			],
    			"repeat": true,
    			"angle": 45,
    			"drop_shadows": [
    				{
    					"x_offset": 0,
    					"y_offset": 0,
    					"radius": 0,
    					"color": 0
    				}
    			]
    		},
    		{
    			"id": "61c01b08b6b41ea54419bbbd",
    			"name": "Staff Shine",
    			"users": [
    				"24377667"
    			],
    			"function": "url",
    			"color": -97373441,
    			"stops": [],
    			"repeat": false,
    			"angle": 0,
    			"image_url": "https://cdn.7tv.app/misc/img_paints/img_paint_clip_test.webp",
    			"drop_shadows": [
    				{
    					"x_offset": 0,
    					"y_offset": 0,
    					"radius": 4,
    					"color": 100
    				}
    			]
    		}
    	]
    }
  • User: https://api.7tv.app/v2/users/USERNAME_HERE

    Payload Example
    {
      "id": "60afddafc7885c2314e482da",
      "twitch_id": "",
      "login": "cryptslive",
      "display_name": "CryptsLive",
      "role": {
        "id": "000000000000000000000000",
        "name": "",
        "position": 0,
        "color": 0,
        "allowed": 523,
        "denied": 0,
        "default": true
      }
    }

Official Docs

https://github.com/SevenTV/ServerGo/blob/master/docs/rest-api.md

Codenames

  • Username = Twitch User's name

Endpoints

  • Pronouns + IDs/Keys: https://pronouns.alejo.io/api/pronouns

    Payload Example
    [
    {
      "name":"aeaer",
      "display":"Ae/Aer"
    },
    {
      "name":"any",
      "display":"Any"
    },
    {
      "name":"eem",
      "display":"E/Em"
    },
    {
      "name":"faefaer",
      "display":"Fae/Faer"
    },
    {
      "name":"hehim",
      "display":"He/Him"
    },
    {
      "name":"heshe",
      "display":"He/She"
    },
    {
      "name":"hethem",
      "display":"He/They"
    },
    {
      "name":"itits",
      "display":"It/Its"
    },
    {
      "name":"other",
      "display":"Other"
    },
    {
      "name":"perper",
      "display":"Per/Per"
    },
    {
      "name":"sheher",
      "display":"She/Her"
    },
    {
      "name":"shethem",
      "display":"She/They"
    },
    {
      "name":"theythem",
      "display":"They/Them"
    },
    {
      "name":"vever",
      "display":"Ve/Ver"
    },
    {
      "name":"xexem",
      "display":"Xe/Xem"
    },
    {
      "name":"ziehir",
      "display":"Zie/Hir"
    }
    ]
  • User pronouns: https://pronouns.alejo.io/api/users/username

    Payload Example
    [
      {
          "id":"641382440",
          "login":"cryptslive",
          "pronoun_id":"hehim"
      }
    ]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment