API Docs » Weeby API

API Documentation

GeneratorsCustomGIFJSONEffectsOverlaysUtility

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

Generators

  • File Types Supported: .png, .jpg, .gif
  • Max File Size Supported: Unlimited

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, 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, thanossnap, forfivehours, markmeta, squidwardcancer, petershocked)
  • 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, sus, startedgoing, rtx, simpleship)
    • 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, danger, 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, didyoumean)
    • 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

    Quote

    Draws one image, quote and author on a quote image generator.

    Params/Queries:

    • image (Required - string) - The link to an image (.png, .jpg, .gif)
    • text (Required - string) - The quote text to print.
    • author (Required - string) - The author 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/quote?image=url&text=text&author=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/X tweet with username, the 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

    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

    Plankton Plan

    Draws four text on the Plankton Plan meme.

    Params/Queries:

    • stepone (Required - string) - The first text to print.
    • steptwo (Required - string) - The second text to print.
    • stepthree (Required - string) - The third text to print.
    • stepfour (Required - string) - The fourth 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/planktonplan?stepone=text&stepthree=text&stepthree=text&stepfour=text

    Brain

    Draws four text on the Brain meme.

    Params/Queries:

    • textone (Required - string) - The first text to print.
    • texttwo (Required - string) - The second text to print.
    • textthree (Required - string) - The third text to print.
    • textfour (Required - string) - The fourth 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/brain?textone=text&textthree=text&textthree=text&textfour=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

    • File Types Supported: .png, .jpg, .gif
    • Max File Size Supported: Unlimited

    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, 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][&font=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, 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][&font=text]

    Rank

    Creates a customisable rank card with Icon, Name, Progress Bar 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.
    • progressBar (Required - string) - The size of the progress bar. (0-100)
    • progressBarColor (Optional - hex) - The color of the progress bar.
    • status (Optional - hex) - The color of the user status.
    • font (Optional - string) - The font to use, 'nexa' by default. (gotham, stoneserif, roboto, arial, impact, riffic, minecraft, pinkycupid, 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/rank?avatar=url&username=text&bgColor=hex&level=number&xp=number&progressBar=number[&progressBarColor=hex][&status=hex][&font=hex]

    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.
    • newlevel (Required - string) - The new level of the user.
    • status (Optional - hex) - The color of the user status.
    • font (Optional - string) - The font to use, 'nexa' by default. (gotham, stoneserif, roboto, arial, impact, riffic, minecraft, pinkycupid, 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&newlevel=number[&status=hex][&font=text]

    GIF

    Returns a random GIF image of the type provided.

    Params/Queries:

    • type (Required - string) - The Type of GIF. (akko, angry, baka, bath, blow, blowkiss, boom, boop, beg, beer, bite, blush, bonk, bored, brofist, cafe, cheer, chika, chase, clap, coffee, confused, cookie, cringe, cry, cuddle, cute, dab, dance, facedesk, facepalm, feed, flower, fly, gabriel, glomp, grin, grumpy, happy, hate, handhold, hide, highfive, hug, icecream, kick, kiss, laugh, lick, love, lurk, miyano, nervous, no, nom, nuzzle, panic, pat, peace, pikachu, police, poke, pout, protect, punch, rawr, run, sagiri, salute, shh, shrug, sip, slap, sleepy, smug, stare, sword, tease, teleport, think, throw, thumbs, tickle, triggered, wag, wasted, wave, wedding, whisper, wiggle, wink, yes, zerotwo)
    • noanime (Required - boolean) - EXPERIMENT - IT MAY GET REMOVED: If the GIF should not be anime. Supported types: (hug, kiss)
    • 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, truthordare, compliment, fortune, chucknorris, advice, number, fact, dogfact, catfact, birdfact, question, quote)
    • number (Optional - number) - The specific number of the JSON response to request. (Some types support)
    • 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, turtle, squirrel, cow, hamster, chicken, pig, kitten, puppy)
    • 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>

    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

    • File Types Supported: .png, .jpg, .gif
    • Max File Size Supported: 6MB

    General

    Applies an effect to the provided image.

    Params/Queries:

    • type (Required - string) - The Type of Effect to use. (contrast, edge, greyscale, invert, pixelize, sepia, sharpen, silhouette, threshold, blurple, invertedthreshold, invertedgreyscale, oil)
    • 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)
    • 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, distort, blur, swirl, implode)
    • 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

    • File Types Supported: .png, .jpg, .gif
    • Max File Size Supported: Unlimited

    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, wasted)
    • 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

    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 - string) - 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&text=text

    Timezone

    Returns the timezone of the provided area and location. For example: America/New_York

    Params/Queries:

    • area (Required - string) - A valid Area. Refer to this: https://timezonedb.com/time-zones
    • location (Required - string) - A valid location. Refer to this: https://timezonedb.com/time-zones
    • region (Optional - string) - If the Area and Location has a region, you can input a valid region... Refer to this: https://timezonedb.com/time-zones
    • 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/timezone?area=text&location=text[&region=text]

    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

    Top.gg Bot 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 Bot 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 Bot 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