Help & Documentation
Everything you need to add quotes to your stream
What is this?
The AoE4 Quote Database is a free tool for Age of Empires IV streamers to add fun quote commands to their Twitch or YouTube chat.
Features:
- !quote - Get random quotes, jokes, or wisdom from your collection
- !tip - Get matchup-specific tips (e.g., "HRE vs French")
- !addquote - Let viewers suggest quotes (with approval queue)
- Channel-specific quotes - Each streamer has their own quote collection
- Civ filtering - Filter quotes by civilization
Works with Nightbot, Moobot, StreamElements, and any bot that supports URL fetch.
Quick Start
- Suggest some quotes - Go to /suggest and add quotes for your channel
- Get approved - Contact the admin to approve your channel and quotes
- Add the bot command - Copy the command for your bot (see below)
- Type !quote in chat - That's it!
Bot Setup Guides
Nightbot
Basic !quote command:
!commands add !quote $(urlfetch https://quoteqt.webframp.com/api/quote)
Matchup tips (!tip hre french):
!commands add !tip $(urlfetch https://quoteqt.webframp.com/api/matchup?$(querystring))
Let viewers suggest quotes:
!commands add !addquote $(urlfetch https://quoteqt.webframp.com/api/suggest?text=$(querystring))
Tip: Nightbot automatically sends your channel name, so quotes are filtered to your channel.
Moobot
- Go to Moobot dashboard → Chat commands → Custom commands
- Create new command, set response type to "URL fetch"
- Set the URL to:
https://quoteqt.webframp.com/api/quote
For !addquote:
- Create command with Response tags: "Arguments - All command arguments" and "URL fetch"
- Set URL to:
https://quoteqt.webframp.com/api/suggest?text=
- Click "Add tag to URL" and select "Command arguments"
StreamElements
Basic !quote command:
$(customapi https://quoteqt.webframp.com/api/quote?channel=$(channel))
Let viewers suggest quotes:
$(customapi https://quoteqt.webframp.com/api/suggest?text=$(querystring)&channel=$(channel))
Note: StreamElements doesn't send channel headers automatically, so you must include ?channel=$(channel) in the URL.
API Reference
For advanced users and developers, full interactive API documentation is available at:
View API Documentation
The API docs include:
- All available endpoints with parameters
- Request/response examples
- Interactive "Try it out" feature to test endpoints
- JSON schema definitions
FAQ
How do I get my channel approved?
Contact the admin (Webframp) on Discord or Twitch. Once approved, you can manage your own quotes.
Can my viewers add quotes?
Yes! Use the !addquote command setup above. Suggestions go to an approval queue - you review and approve them at /suggestions.
How do I filter quotes by civilization?
Add ?civ=shortname to the URL. Use the shortnames from aoe4world.com (e.g., hre, french, mongols).
!commands add !hrequote $(urlfetch https://quoteqt.webframp.com/api/quote?civ=hre)
Can I have channel-specific quotes?
Yes! When you add quotes through the web interface, you can assign them to your channel. They'll only appear for your channel's bot commands.
What's the rate limit?
The API is rate-limited to prevent abuse. Normal bot usage won't hit the limits. Suggestion submissions are limited to 15 per hour per channel.
Is there a JSON API?
Yes! Add Accept: application/json header to get JSON responses, or use /api/quotes for all quotes as JSON. See the API docs for details.