API Docs » Weeby API

API Documentation

GeneratorsCustomGIFJSONEffectsOverlaysUtility

Base URL: https://weebyapi.xyz/
Version: 2.2.0
Authentication Method(s): Authorization Header (Bearer) or Query String (&token=)

Generators

One Image

Draws one image on a requested image generator.

Params/Queries:

  • type (Required - string) - The Type of Generator. (3000years, airpods, amiajoke, bad, beautiful, berniemittens, bobross, challenger, delet, dexter, eject, fear, garbage, heman, jokeoverhead, painting, patrick, photograph, picture, respect, sacred, thumbs, tobecontinued, truth, wanted, wedontdothathere, whodidthis, worthless, leonardopointing, jojoshock, hot, soraselfie, helivesinyou, stonks, mycollectiongrows, tableflip, tattoo, leonardoglass, standingkitty, rickripswall, wynaut, berniefinancialsupport, vsaucecomputer, waitthatsillegal)
  • image (Required - string) - The link to an image (.png, .jpg, .gif)
  • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/<type>?image=url

    Two Images

    Draws two images on a requested image generator.

    Params/Queries:

    • type (Required - string) - The Type of Generator. (batslap, bed, crush, cuddle, dwightscared, hug, nani, peterglasses, samepicture, ship, whowouldwin, expectreality, amogus)
    • firstimage (Required - string) - The link to an first image (.png, .jpg, .gif)
    • secondimage (Required - string) - The link to the second image (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/<type>?firstimage=url&secondimage=url

    Text

    Prints text on a requested image generator.

    Params/Queries:

    • type (Required - string) - The Type of Generator. (belikebill, clyde, hollywoodstar)
    • text (Required - string) - The text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/<type>?text=text

    Two Text

    Prints two texts on a requested image generator.

    Params/Queries:

    • type (Required - string) - The Type of Generator. (drakeposting, spiderman, twobuttons, tuxedopooh, icarly)
    • textone (Required - string) - The first text to print.
    • texttwo (Required - string) - The second text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/<type>?textone=text&texttwo=text

    Image and Text

    Draws one image and one text on a requested image generator.

    Params/Queries:

    • type (Required - string) - The Type of Generator. (achievement, bartchalkboard, changemymind, lisapresentation, jimwhiteboard)
    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • text (Required - string) - The text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/<type>?image=url&text=text

    Eject

    Draws one image and one text on a Among Us Generator.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • text (Required - string) - The text to print.
    • outcome (Required - string) - The type of outcome to display in the text. (ejected, imposter or notimposter)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/gif
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/eject?image=url&text=text&outcome=text

    Friendship

    Prints two images and texts on a friendship banner.

    Params/Queries:

    • firstimage (Required - string) - The link to the first image (.png, .jpg, .gif)
    • secondimage (Required - string) - The link to the second image (.png, .jpg, .gif)
    • firsttext (Required - string) - The first text to print.
    • secondtext (Required - string) - The second text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/friendship?firstimage=url&secondimage=url&firsttext=text&secondtext=text

    Demotivational

    Draws an image, title and text on a demotivational poster.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • title (Required - string) - The title to print.
    • text (Required - string) - The text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/demotivational?image=url&title&text=text

    RIP

    Draws an image and username on a Gravestone.

    Params/Queries:

    • avatar (Required - string) - The link to an image (.png, .jpg, .gif)
    • username (Required - string) - The username to print.
    • message (Required - string) - The text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/rip?avatar=url&username=text&message=text

    Tweet

    Generates a raw twitter tweet with username, the tweet text and avatar.

    Params/Queries:

    • username (Required - string) - The username to print.
    • tweet (Required - string) - The text to print.
    • avatar (Required - string) - The link to an image (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/tweet?username=text&tweet=text&avatar=url

    Tweet Fetch

    Generates a twitter tweet with username (fetched from the Twitter API) and the tweet text.

    Params/Queries:

    • username (Required - string) - The username to print.
    • tweet (Required - string) - The text to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/tweetfetch?username=text&tweet=text

    Spotify Now Playing

    Generates a Spotify Now Playing Image with song data.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • title (Required - string) - The title of the song to print.
    • artist (Required - string) - The artist name to print.
    • album (Required - string) - The album name to print.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/spotifynp?image=url&title=text&artist=text&album=text

    This Is Spotify

    Generates an Image, Text and color on a This Is Spotify Meme.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • text (Required - string) - The text to print.
    • color (Required - hex) - The hex color of the background.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/thisisspotify?image=url&text=text&color=hex

    Triggered

    Draws one image on an animated triggered GIF.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • tint (Optional - boolean) - Whether the generated GIF should have a orange tint. Defaults to True.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/gif
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/triggered?image=url[&tint=true]

    Currency

    Generates a image with the specified currency and its amount.

    Params/Queries:

    • type (Required - string) - The type of currency. (dollar, euro, pound, yen)
    • amount (Required - number) - The amount of money to display.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/currency?type=text&amount=number

    Color

    Returns the colour in a image format.

    Params/Queries:

    • hex (Required - hex) - The hex color (Without the Hashtag)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the generator is not found.


  • GET /generators/color?hex=hex

    Custom

    Greeting

    Creates a customisable greeting image with Icon, Name, Greet and Background. Optional queries can let you customise the color of each element.

    Params/Queries:

    • icon (Required - string) - The link to an image (.png, .jpg, .gif)
    • background (Required - string) - The link to an image (.png, .jpg, .gif) (1024x470 recommended)
    • name (Required - string) - The name of the greeted user.
    • greet (Required - string) - What should the user be greeted with?
    • message (Optional - string) - Provide a message on the bottom of the user's name.
    • greetHex (Optional - hex) - The color of the Greet Text
    • nameHex (Optional - hex) - The color of the Name Text
    • circleHex (Optional - hex) - The color of the Avatar Border
    • messageHex (Optional - hex) - The color of the Message Text
    • font (Optional - string) - The font to use, 'gotham' by default. (gotham, stoneserif, roboto, arial, impact, riffic, minecraft, pinkycupid, paladins, pokemon, oldenglish, chalkduster, akbar, nexa, verdana, typewriter, spongebob, cornerofthesky, breesh)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the custom generator is not found.


  • GET /custom/greeting?icon=url&background=url&name=text&greet=text[&greetHex=hex][&nameHex=hex][&circleHex=hex][&messageHex=hex][&message=text]

    Booster

    Creates a customisable booster add/remove image with Icon, Name and Background. Optional queries can let you customise the color of each element.

    Params/Queries:

    • icon (Required - string) - The link to an image (.png, .jpg, .gif)
    • background (Required - string) - The link to an image (.png, .jpg, .gif) (1024x470 recommended)
    • name (Required - string) - The name of the user who boosted the server.
    • title (Required - string) - The title of the booster card.
    • message (Optional - string) - Provide a message on the bottom of title.
    • titleHex (Optional - hex) - The color of the Title Text
    • nameHex (Optional - hex) - The color of the Name Text
    • messageHex (Optional - hex) - The color of the Message Text
    • circleHex (Optional - hex) - The color of the Avatar Border
    • font (Optional - string) - The font to use, 'nexa' by default. (gotham, stoneserif, roboto, arial, impact, riffic, minecraft, pinkycupid, paladins, pokemon, oldenglish, chalkduster, akbar, nexa, verdana, typewriter, spongebob, cornerofthesky, breesh)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the custom generator is not found.


  • GET /custom/booster?icon=url&background=url&name=text&title=text[&titleHex=hex][&nameHex=hex][&circleHex=hex][&messageHex=hex][&message=text]

    Rank

    Creates a customisable rank card with Icon, Name, and leveling stats.

    Params/Queries:

    • avatar (Required - string) - The link to an image (.png, .jpg, .gif)
    • username (Required - string) - The person's username.
    • bgColor (Required - hex) - The color of the background.
    • level (Required - number) - The Level the user is currently on.
    • xp (Required - number) - How much XP the user has.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the custom generator is not found.


  • GET /custom/rank?avatar=url&username=text&bgColor=hex&level=number&xp=number

    Level Up

    Creates a customisable level up card.

    Params/Queries:

    • avatar (Required - string) - The link to an image (.png, .jpg, .gif)
    • bgColor (Required - hex) - The color of the background.
    • borderColor (Required - hex) - The color of the avatar border.
    • oldlevel (Required - string) - The old level of the user.
    • newlevel (Required - string) - The new level of the user.
    • font (Optional - string) - The font to use, 'nexa' by default. (gotham, stoneserif, roboto, arial, impact, riffic, minecraft, pinkycupid, paladins, pokemon, oldenglish, chalkduster, akbar, nexa, verdana, typewriter, spongebob, cornerofthesky, breesh)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the custom generator is not found.


  • GET /custom/levelup?avatar=url&bgColor=hex&borderColor=hex&oldlevel=number&newlevel=number

    GIF

    Returns a random GIF image of the type provided.

    Params/Queries:

    • type (Required - string) - The Type of GIF. (akko, angry, baka, bath, boom, boop, beer, bite, blush, bonk, bored, cheer, chase, clap, confused, cookie, cringe, cry, cuddle, dab, dance, facepalm, feed, flower, fly, gabriel, glomp, grin, happy, hate, handhold, highfive, hug, icecream, kick, kiss, laugh, lick, love, lurk, miyano, nervous, no, nom, nuzzle, panic, pat, pikachu, poke, pout, punch, rawr, run, sagiri, shrug, sip, slap, sleepy, smug, stare, sword, tease, teleport, think, throw, thumbs, tickle, triggered, wag, wave, wedding, wink, yes, zerotwo)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the GIF is not found.


  • GET /gif/<type>

    JSON

    Random Response

    Returns a random JSON response.

    Params/Queries:

    • type (Required - string) - The Type of JSON response to request. (8ball, belikebill, dadjoke, geography, joke, roast)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/<type>

    Random Animal Image

    Returns a random Animal image of the type provided.

    Params/Queries:

    • type (Required - string) - The Type of Animal. (bird, bunny, cat, dog, fox, goose, kangaroo, koala, lizard, panda)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the GIF is not found.


  • GET /json/images/animal/<type>

    Meme

    Returns a random SFW Meme from a Subreddit.

    Params/Queries:

    • category (Optional - string) - The name of the category. (meme, memes, wholesomememes, dankmemes)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/meme[&category=text]

    Formatted Text

    Formats the provided text into a different style.

    Params/Queries:

    • type (Required - string) - The Type of JSON response to request. (aesthetic, clapify, flip, mock, owoify, small, vaporwave)
    • text (Required - string) - The text to format to.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/format/<type>?text=text

    Random Word

    Returns a random word.

    Params/Queries:

    • type (Required - string) - The Type of Random Word List to request. (random, halloween, christmas, list)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/word/<type>

    Lyrics

    Fetches lyrics from the Genius API.

    Params/Queries:

    • query (Required - string) - The lyrics to search (i.e Track Name, or specifically add the artist for an accurate response).
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/lyrics

    Weeby API Statistics

    Fetches the current statistics of Weeby API.

    Params/Queries:

    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /json/stats

    Effects

    General

    Applies an effect to the provided image.

    Params/Queries:

    • type (Required - string) - The Type of Effect to use. (blur, contrast, edge, greyscale, invert, pixelize, sepia, sharpen, silhouette, threshold, blurple, invertedthreshold, invertedgreyscale)
    • image (Required - string) - A link to an image. (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /effects/<type>?image=url

    Intensity

    Applies an effect to the provided image that can change the intensity.

    Params/Queries:

    • type (Required - string) - The type of effect to use. (brightness, darkness, distort)
    • intensity (Required - number) - The level of the effect.
    • image (Required - string) - A link to an image. (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /effects/<type>?image=url&intensity=number

    Level

    Applies an effect to the provided image that can change the level.

    Params/Queries:

    • type (Required - string) - The type of effect to use. (fisheye, desaturate)
    • level (Required - number) - The level of the effect.
    • image (Required - string) - A link to an image. (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /effects/<type>?image=url&level=number

    Resize

    Resizes a provided image.

    Params/Queries:

    • width (Required - number) - The width of the resized image (1-2000)
    • height (Required - number) - The height of the resized image (1-2000)
    • image (Required - string) - A link to an image. (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /effects/resize?image=url&width=number&height=number

    Overlays

    Draws the provided image under an image overlay.

    Params/Queries:

    • type (Required - string) - The Type of Overlay. (approved, bazinga, caution, christmas, easter, fire, glass, halloween, hearts, jail, rainbow, rejected, simp, snow, thuglife, balance, brilliance, bravery)
    • image (Required - string) - A link to an image. (.png, .jpg, .gif)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - image/png
    The buffer that returns the image data.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /overlays/<type>?image=url

    Utility

    Top.gg Vote Checker

    Checks if a user has voted for a bot on Top.gg

    Params/Queries:

    • botid (Required - number) - The ID of the Bot.
    • userid (Required - number) - The ID of the User.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/webhook/topgg/votecheck?botid=number&userid=number

    Top.gg Vote List

    Returns a list of the last 20 users who voted the bot.

    Params/Queries:

    • botid (Required - number) - The ID of the Bot.
    • amount (Optional - number) - The amount of IDs to list. (Max. 100)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/webhook/topgg/votelist?botid=number&amount=number

    Top.gg Top Votes

    Returns a list of users who have the most votes on the bot.

    Params/Queries:

    • botid (Required - number) - The ID of the Bot.
    • amount (Optional - number) - The amount of IDs to list. (Max. 100)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/webhook/topgg/topvotes?botid=number&amount=number

    Currency Converter

    Converts the provided currency to a different currency.

    Params/Queries:

    • from (Required - string) - A valid ISO 4217 code of the currency (i.e. USD). Refer to this: https://www.xe.com/iso4217.php
    • to (Required - string) - A valid ISO 4217 code of the currency (i.e. USD). Refer to this: https://www.xe.com/iso4217.php
    • amount (Required - number) - The amount you want to have converted.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/currencyconverter?from=text&to=text&amount=number

    Translate

    Translate the provided text to another language.

    Params/Queries:

    • from (Required - string) - A valid ISO language code. Refer to this: http://www.lingoes.net/en/translator/langcode.htm
    • to (Required - string) - A valid ISO language code. Refer to this: http://www.lingoes.net/en/translator/langcode.htm
    • text (Required - number) - The text to translate.
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/translate?from=text&to=text&amount=number

    Weather

    Returns the weather for the provided location.

    Params/Queries:

    • location (Required - string) - The location you want to get the weather for.
    • degreetype (Required - string) - The type of degrees you want to get the weather for. (Celsius, Fahrenheit)
    • token (Required - string) - Your API Key obtained through applying.

  • 200 - application/json
    The returned JSON object.

  • 401 - application/json
    The error message if the token is invalid, or missing.

  • 400 - application/json
    The error message if the request is invalid. Due to missing parameters, or incorrect parameter use.

  • 404 - document or application/json
    The error message if the JSON is not found.


  • GET /utility/weather?location=text&degreetype=text