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'

###

7TV:

• global: https://api.7tv.app/v2/emotes/global
• badges: https://api.7tv.app/v2/cosmetics?user_identifier=twitch_id
• 7TV channel emotes: https://api.7tv.app/v2/users/94753024/emotes

the betterttv end points are not working anymore, was the api taken down?

The BetterTTV endpoints are alive and well, however the server will redirect the client back to the homepage if it thinks you are a web browser.

they were not working when I was making that post with my app but that was changed again it seems. is there a specific header you have to send with it so it will work always?

I did a little bit more digging, found out that my browser sends a sec-fetch-mode: navigate header. So if you simply don't have that header in the request it should work, you can use something like curl, postman or the REST Client VSCode extension, shown in the bttv-request.http file above to try it out.

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