API Docs » Weeby API

API Documentation

GeneratorsCustomGIFJSONEffectsOverlays
Base URL: https://weebyapi.xyz/
Version: 2.0.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, fear, garbage, heman, jokeoverhead, painting, patrick, photograph, picture, respect, sacred, thumbs, tobecontinued, triggered, truth, wanted, wedontdothathere, whodidthis, worthless, leonardopointing, jojoshock, hot, soraselfie, helivesinyou, stonks, mycollectiongrows, tableflip, tattoo, rickripswall, standingkitty, leonardoglass, berniefinancialsupport, wynaut)
  • image (Required - string) - The link to an image (.png, .jpg, .gif)
  • token (Required - string) - Your API Key obtained through applying.
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, expectreality, hug, nani, peterglasses, samepicture, ship, whowouldwin)
  • 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.
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.
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)
  • 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.
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, eject, lisapresentation)
  • 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.
GET /generators/<type>?image=url&text=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.
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.
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.
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.
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.
GET /generators/tweetfetch?username=text&tweet=text

Spotify Search

Generates a Spotify Banner of statistics and information from either music, playlists or users.

Params/Queries:

  • type (Required - string) - The type of search (album, artist, playlist, track or user)
  • query (Required - string) - The value to search up. Use (%20) for spaces when needed.
  • token (Required - string) - Your API Key obtained through applying.
GET /generators/spotify/<type>?query=text

Spotify Now Playing

Generates a Fake Spotify Now Playing Image.

Params/Queries:

  • image (Required - string) - The link to an image (.png, .jpg, .gif)
  • songname (Required - string) - The name of the song to print.
  • artist (Required - string) - The artist name to print.
  • userpicks (Required - string) - The User's Picks name to print.
  • token (Required - string) - Your API Key obtained through applying.
GET /generators/spotifynp?image=url&songname=text&artist=text&userpicks=text

Currency

Generates a image with the specified currency and its amount.

Params/Queries:

  • type (Required - string) - The type of currency. (euro, pound, dollar, yen)
  • amount (Required - number) - The amount of money to display.
  • token (Required - string) - Your API Key obtained through applying.
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.
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
  • token (Required - string) - Your API Key obtained through applying.
GET /custom/greeting?icon=url&background=url&name=text&greet=text[&greetHex=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.
GET /custom/rank?avatar=url&username=text&bgColor=hex&level=number&xp=number

GIF

Returns a random GIF image of the type provided.

Params/Queries:

  • type (Required - string) - The Type of GIF. (akko, angry, beer, bite, blush, bonk, bored, cheer, clap, confused, cookie, cringe, cry, cuddle, dab, dance, feed, flower, gabriel, grin, handhold, highfive, hug, kiss, laugh, lick, lurk, miyano, nervous, nom, nuzzle, panic, pat, pikachu, poke, pout, rawr, sagiri, slap, sleepy, stare, throw, tickle, triggered, wave, wedding, wink, zerotwo)
  • token (Required - string) - Your API Key obtained through applying.
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.
GET /json/<type>

Random Word

Returns a random word.

Params/Queries:

  • type (Required - string) - The Type of Random Word List to request. (random, list,halloween, christmas)
  • token (Required - string) - Your API Key obtained through applying.
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.
GET /json/lyrics

Weeby API Statistics

Fetches the current statistics of Weeby API.

Params/Queries:

  • token (Required - string) - Your API Key obtained through applying.
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.
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. (brightness [0-255], darkness [0-255], distort [0-100])
  • image (Required - string) - A link to an Image. (.png, .jpg, .gif)
  • token (Required - string) - Your API Key obtained through applying.
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. (fisheye [1-100], desaturate [1-255])
  • image (Required - string) - A link to an Image. (.png, .jpg, .gif)
  • token (Required - string) - Your API Key obtained through applying.
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.
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, balance, bravery, brilliance, caution, christmas, easter, fire, glass, halloween, hearts, jail, rainbow, rejected, simp, snow, thuglife)
  • image (Required - string) - A link to an Image. (.png, .jpg, .gif)
  • token (Required - string) - Your API Key obtained through applying.
GET /overlays/<type>?image=url