urban dictionary banner

Check out the source code and don’t forget to drop a star EZ Clap

Urban dict[ionary]

API that retrieves entries from Urban Dictionary, and return them formatted as plain text Clap

Random entry: 1755116447848ms

API Usage

The API can be called directly with a GET HTTP request

curl https://darckfast.com/api/urban \
    --url-query 'term=my term' \
    --url-query 'channel=my channel name'

The response is capped at 400 characters

ParameterDescriptionIs required?
channelTwitch channel username, this is used for cache purposes✅ Yes
termTerm that will be queried on Urban Dictionary, and it is limited to a maximum of 64 characters. If this parameter is abscent, a random entry will be returned🔵 No

Browser

The API can also be called within the browser

let entry = await fetch('https://darckfast.com/api/urban').then(r => r.text())

CORS is enabled by default, and it is returned according to the Origin header. Only requests over HTTPS with TLS 1.1 or higher are supported

Integration

Code snippets to help integrate with some chatbots

StreamElements

Add a custom command using the ${customapi.url}, like the example bellow

${customapi.https://darckfast.com/api/urban?term=${pathescape ${0:}}&channel=$(channel)}

NightBot

Add a custom command using the $(urlfetch url), like the example bellow

$(urlfetch https://darckfast.com/api/urban?term=$(querystring)&channel=$(channel))

FossaBot

Add a custom command using the $(customapi url), like the example bellow

$(customapi https://darckfast.com/api/urban?term=$(querystring)&channel=$(channel))

MooBot

Create a URL-Fetch command, like the example bellow

https://darckfast.com/api/urban?term=Command arguments&channel=Username of the channel