ffz/bttv known API end-points quick list

__HEY.md

dank yet obscure FFZ/BTTV API end-points you can use for stuff

• Created doc while stumbling upon this PR / issue in https://github.com/night/betterttv
• Also kudos Chrome network panel

here's the TL;DR

bttv

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

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

• bttv channel emotes: https://api.betterttv.net/3/cached/users/twitch/121059319

• ffz channel emotes: https://api.betterttv.net/3/cached/frankerfacez/users/twitch/121059319

• changelog: https://api.betterttv.net/3/cached/changelog

• cdn hits:

  • https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/1x
  • https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/2x
  • https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/3x

  ffz

  • ffz channel emotes: https://api.frankerfacez.com/v1/room/id/30777889
  • cdn hits:
    • https://cdn.frankerfacez.com/emote/303899/1
    • https://cdn.frankerfacez.com/emote/303899/2

  vscode rest-client snippets and curl requets below

bttv-requests.http

# known bttv api end-points in bettertv (https://github.com/night/betterttv)

# wth is this file?
# vscode rest client extension: https://marketplace.visualstudio.com/items?itemName=humao.rest-client

###

# global
GET https://api.betterttv.net/3/cached/emotes/global
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.betterttv.net/3/cached/emotes/global --header 'content-type: application/json' --header 'user-agent: vscode-client'

# badges
GET https://api.betterttv.net/3/cached/badges
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.betterttv.net/3/cached/emotes/global --header 'content-type: application/json; charset=utf-8' --header 'user-agent: "vscode-client"' --data 'GET https://api.betterttv.net/3/cached/badgesContent-Type: application/json; charset=utf-8User-agent: "vscode-client"'


# list all bttv channel (accound id) emotes
GET https://api.betterttv.net/3/cached/users/twitch/121059319
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.betterttv.net/3/cached/users/twitch/121059319 --header 'content-type: application/json; charset=utf-8' --header 'user-agent: "vscode-client"'


# list all ffz emotes per channel (account id)
GET https://api.betterttv.net/3/cached/frankerfacez/users/twitch/121059319
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.betterttv.net/3/cached/frankerfacez/users/twitch/121059319 --header 'content-type: application/json; charset=utf-8' --header 'user-agent: "vscode-client"'

# changelog(?)
GET https://api.betterttv.net/3/cached/changelog
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.betterttv.net/3/cached/frankerfacez/users/twitch/121059319 --header 'content-type: application/json; charset=utf-8' --header 'user-agent: "vscode-client"' --data 'GET https://api.betterttv.net/3/cached/changelogContent-Type: application/json; charset=utf-8User-agent: "vscode-client"'


# cdn get
GET https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/1x
### curl --request GET --url https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/1x --header 'user-agent: vscode-restclient'
GET https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/2x
### curl --request GET --url https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/2x --header 'user-agent: vscode-restclient'
GET https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/3x
### curl --request GET --url https://cdn.betterttv.net/emote/5a970ab2122e4331029f0d7e/3x --header 'user-agent: vscode-restclient'

ffz-requests.http

# some ffz api end-points from their extension

###

# channel ffz get
GET https://api.frankerfacez.com/v1/room/id/30777889
Content-Type: application/json; charset=utf-8
User-agent: "vscode-client"
### curl --request GET --url https://api.frankerfacez.com/v1/room/id/30777889 --header 'content-type: application/json; charset=utf-8' --header 'user-agent: "vscode-client"'

# cdn get
GET https://cdn.frankerfacez.com/emote/303899/1
### curl --request GET --url https://cdn.frankerfacez.com/emote/303899/1 --header 'user-agent: vscode-restclient'
GET https://cdn.frankerfacez.com/emote/303899/2
### curl --request GET --url https://cdn.frankerfacez.com/emote/303899/2 --header 'user-agent: vscode-restclient'

###

is there an endpoint to get emotes from the top page? similar to how https://api.betterttv.net/3/cached/emotes/global pulls from the global emotes on the site

7tv doesn't work anymore

7TV: As of 2023:

• global: https://7tv.io/v3/emote-sets/global
• 7TV channel emotes: https://7tv.io/v3/users/twitch/{twitch_id}

7TV:
-> https://7tv.io/docs

The old api endpoint got discontinued on Nov 1st. Check the docs above for the api endpoints. Twitch, Kick and Youtube I think are supported

Does anyone know how to download all emotes as webp from betterttv?

This gist is obsolete in current year. Try these instead:

• FFZ: https://api.frankerfacez.com/docs/
• BTTV: https://betterttv.com/developers/api
• 7tv: https://7tv.io/docs