User ID= Twitch User ID (you can get it here)Username= Twitch User's nameEmote ID= ID assigned to an emote (Found in the URL)Global= Can be used in any chatChannel Emote= Emotes that are assigned to a certain chatEmote Size= This will vary from platform to platfrom, the smaller the number the smaller the image.- If it's BTTV this will be
1x,2xor3x. - If it's FFZ
1,2(sometimes it may be 3, 4 if it is HQ). - If it's 7TV
x1,x2,x3,x4.
- If it's BTTV this will be
-
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" } } ]
-
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" } } ]
-
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
-
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 ] } }
https://www.frankerfacez.com/developers
-
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" ] ] } ]
-
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 } }
https://github.com/SevenTV/ServerGo/blob/master/docs/rest-api.md