Overview

Base URL:  https://yv2bx4mc6g.execute-api.us-west-2.amazonaws.com/prod/emotes

All endpoints are HTTP GET and return application/json. Unknown parameters are ignored. Unless noted, endpoints are public-read.

Path	Purpose
/emotes	List / search / look-up emotes
/channel-emotes	Active Twitch channel set
/me	Viewer or profile header
/favorites	User favourite emotes
/emote-set-emotes	Emotes inside a set
/emote-sets-with-emote	Emote sets containing a specific emote

GET /emotes

A. Latest / paginated catalogue

GET /emotes?page=<int>&page_size=<int>

Test It

Query	Type	Default	Notes
page	int	1	1-based index
page_size	int	50	10–200

B. Search by substring

GET /emotes?search=Yaldi&page=1&page_size=25

Test It

C. Look-up by UUID

GET /emotes?id=490032a0-8a4c-492e-8196-c5718a548995

Test It

D. Filter by owner

GET /emotes?owner_id=<user_twitch_id>&page_size=100

Test It

GET /channel-emotes

GET /channel-emotes?channel_name=yaldibot

Test It

Returns the channel’s active set + any global emotes. Private emotes are omitted unless the caller can manage the channel.

GET /me

GET /me?login=yaldibot
GET /me?user_id=1110682823

Test It

GET /favorites

GET /favorites?user_id=1110682823

Test It

GET /emote-set-emotes

GET /emote-set-emotes?set_id=e3e3d723-1682-4ecb-87e6-163af4ca5ef6
    [&page=<int>][&page_size=<int>]

Test It

Query	Type	Default	Notes
set_id	UUID	-	Required
page	int	1	1-based index
page_size	int	50	10–200

Returns the emotes in the set in owner-defined order.

GET /emote-sets-with-emote?emote_id=490032a0-8a4c-492e-8196-c5718a548995
GET /emote-sets-with-emote?emote_id=490032a0-8a4c-492e-8196-c5718a548995&owner_id=1110682823