becca bot logo
FeaturesCommandsPricing
SecurityAutomatic moderation that protects the group 24/7FunGames, economy, and playful activitiesAutomationWelcomes, messages, and schedulesArtificial IntelligenceAnswers, transcription, and translationEase of UseGiveaways, tag everyone, and much moreReportsSee your group's activity and numbers
AdministrationLists, schedules and rules that hold offlineGames and funWordle, hangman, economy, and group dynamicsMedia & StickersStickers, music, video, and generators
See all commands →
With your own numberYou connect your number: R$ 15/monthWith our numberWe provide the number: R$ 30/month
See pricing →
Sign InCreate account

Becca Bot API

A fast, powerful REST API ready for any kind of application, packed with useful features, frequent updates and new capabilities, along with detailed, easy-to-access documentation.

1. Base URL

text
Copy

2. Return Codes

Code 200

Indicates the request was completed successfully

Code 201

Indicates your request created something on the server

Code 401

Indicates you did not provide the apikey or you don't have access to this route

Code 404

Indicates the page/resource was not found

Code 405

Indicates you are not using the correct method for the request

Code 500

Indicates an internal server error occurred

3. Authentication

Method: Bearer Token

Header:

text
Copy

4. Endpoints

Image Manipulation9 endpoints
nsfwPOSTmultipart/form-data

/nsfw

Checks whether the submitted image is pornographic (supports several image types).

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
joojPOSTmultipart/form-data

/jooj

Flips and duplicates half of an image next to the other half.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
ojjoPOSTmultipart/form-data

/ojjo

Splits the image in half horizontally and duplicates the right half, flipping it horizontally next to the original half.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
shipPOSTmultipart/form-data

/ship

Creates a custom image shipping two photos.

Parameters
fileFirst Image
fileSecond Image
rShip randomness (1 to 100)
Usage Example
javascript
Copy
Response Example
javascript
Copy
ocrPOSTmultipart/form-data

/ocr

I read the image and send back the text found.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
grayscalePOSTmultipart/form-data

/grayscale

I turn your image's colors into grayscale.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
rotatePOSTmultipart/form-data

/rotate

Rotates the image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
negatePOSTmultipart/form-data

/negate

Inverts the image colors.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
addtocornerPOSTmultipart/form-data

/addtocorner

I place one image in the bottom-right corner of another.

Parameters
fileFirst Image
fileSecond Image
Usage Example
javascript
Copy
Response Example
javascript
Copy
Utilities3 endpoints
anagramGET*

/anagram

I create an anagram from a random word.

Usage Example
javascript
Copy
Response Example
javascript
Copy
adviceGET*

/advice

I return a piece of advice.

Usage Example
javascript
Copy
Response Example
javascript
Copy
stickerGET*

/sticker

I return a random 512x512px sticker in webp format, suitable for WhatsApp.

Usage Example
javascript
Copy
Response Example
javascript
Copy
Search5 endpoints
cepGETapplication/x-www-form-urlencoded

/cep

I look up information about a CEP (Brazilian postal code).

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
dicioGETapplication/x-www-form-urlencoded

/dicio

I look up a term in the dictionary.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
ddiGETapplication/x-www-form-urlencoded

/ddi

I look up a DDI (country code), returning the country it belongs to.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
dddGETapplication/x-www-form-urlencoded

/ddd

I look up a DDD (Brazilian area code), returning the Brazilian locations it belongs to.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
downloaderGETapplication/x-www-form-urlencoded

/downloader

I download a video/image/audio from TikTok/Instagram/Facebook/Twitter.

Parameters
urlURL to be downloaded
rawWhether the media should be sent as a Buffer (1) or an object containing the info (0)
Usage Example
javascript
Copy
Response Example
javascript
Copy
Fun5 endpoints
wordlePOSTmultipart/form-data

/wordle

I create/continue the Termo game; if you pass no parameter in the URL, the API will create a new game.

Parameters
triesGame attempts (array of 5-character strings, e.g. ['bread', 'wheat'])
wordWord to be guessed (5-character string)
Usage Example
javascript
Copy
Response Example
javascript
Copy
wordsearchGETapplication/x-www-form-urlencoded

/wordsearch

I create the Word Search game, returning an image with the hidden words and the words to be found

Parameters
dGame difficulty (easy,medium,hard)
Usage Example
javascript
Copy
Response Example
javascript
Copy
eununcaGET*

/eununca

I return a 'never have I ever' question.

Usage Example
javascript
Copy
Response Example
javascript
Copy
cantadaGET*

/cantada

I return a pickup line.

Usage Example
javascript
Copy
Response Example
javascript
Copy
choiseGET*

/choise

Two choices, pick only one.

Usage Example
javascript
Copy
Response Example
javascript
Copy
Converters2 endpoints
gif_mp4POSTmultipart/form-data

/gif_mp4

I convert a gif to mp4 and return the buffer.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
gif_webpPOSTmultipart/form-data

/gif_webp

I convert a gif to webp and return the buffer.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
LGBT Effects6 endpoints
gayPOSTmultipart/form-data

/lgbt

Adds a gay flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
transPOSTmultipart/form-data

/lgbt

Adds a trans flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
lesbianPOSTmultipart/form-data

/lgbt

Adds a lesbian flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
heteroPOSTmultipart/form-data

/lgbt

Adds a straight flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
panPOSTmultipart/form-data

/lgbt

Adds a pan flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
biPOSTmultipart/form-data

/lgbt

Adds a bi flag filter to your image.

Parameters
fileFile to be sent
Usage Example
javascript
Copy
Response Example
javascript
Copy
Gifs14 endpoints
kissGET*

/gifs

I return an anime kiss gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
slapGET*

/gifs

I return an anime slap gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
hugGET*

/gifs

I return an anime hug gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
tickleGET*

/gifs

I return an anime tickle gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
waveGET*

/gifs

I return an anime wave gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
feedGET*

/gifs

I return an anime feeding gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
affectGET*

/gifs

I return an anime petting gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
kickGET*

/gifs

I return an anime kick gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
greetGET*

/gifs

I return an anime greeting gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
pokeGET*

/gifs

I return an anime poke gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
biteGET*

/gifs

I return an anime bite gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
massageGET*

/gifs

I return an anime massage gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
eatGET*

/gifs

I return an anime eating gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
patGET*

/gifs

I return an anime pat gif in mp4 format.

Usage Example
javascript
Copy
Response Example
javascript
Copy
Mememakers14 endpoints
bolso1POSTmultipart/form-data

/mememakers

Puts your image on Bolsonaro's television.

Parameters
fileFile to be sent
typebolso1
Usage Example
javascript
Copy
Response Example
javascript
Copy
bolso2POSTmultipart/form-data

/mememakers

Puts your image in a frame in Bolsonaro's hand.

Parameters
fileFile to be sent
typebolso2
Usage Example
javascript
Copy
Response Example
javascript
Copy
bolso3POSTmultipart/form-data

/mememakers

Puts your image on the television in Bolsonaro's office.

Parameters
fileFile to be sent
typebolso3
Usage Example
javascript
Copy
Response Example
javascript
Copy
spongePOSTmultipart/form-data

/mememakers

Puts your image in a SpongeBob montage.

Parameters
fileFile to be sent
typesponge
Usage Example
javascript
Copy
Response Example
javascript
Copy
briggsPOSTmultipart/form-data

/mememakers

Puts your image in Briggs' hand.

Parameters
fileFile to be sent
typebriggs
Usage Example
javascript
Copy
Response Example
javascript
Copy
enaldinhobPOSTmultipart/form-data

/mememakers

Puts your image on a flag in Enaldinho Pereira's hand.

Parameters
fileFile to be sent
typeenaldinhob
Usage Example
javascript
Copy
Response Example
javascript
Copy
enaldinhotvPOSTmultipart/form-data

/mememakers

Puts your image on Enaldinho Pereira's television.

Parameters
fileFile to be sent
typeenaldinhotv
Usage Example
javascript
Copy
Response Example
javascript
Copy
markzPOSTmultipart/form-data

/mememakers

Puts your image next to Mark Zuckerberg.

Parameters
fileFile to be sent
typemarkz
Usage Example
javascript
Copy
Response Example
javascript
Copy
pepePOSTmultipart/form-data

/mememakers

Puts your image in a montage with Pepe.

Parameters
fileFile to be sent
typepepe
Usage Example
javascript
Copy
Response Example
javascript
Copy
paperPOSTmultipart/form-data

/mememakers

Puts your image in a montage on a sheet of paper.

Parameters
fileFile to be sent
typepaper
Usage Example
javascript
Copy
Response Example
javascript
Copy
shottvPOSTmultipart/form-data

/mememakers

Puts your image on a television being aimed at by a gun.

Parameters
fileFile to be sent
typeshottv
Usage Example
javascript
Copy
Response Example
javascript
Copy
romeroPOSTmultipart/form-data

/mememakers

Puts your image in a painting.

Parameters
fileFile to be sent
typeromero
Usage Example
javascript
Copy
Response Example
javascript
Copy
morrepragaPOSTmultipart/form-data

/mememakers

Puts your image in the 'morre praga' meme.

Parameters
fileFile to be sent
typemorrepraga
Usage Example
javascript
Copy
Response Example
javascript
Copy
wolverinePOSTmultipart/form-data

/mememakers

Puts your image in a montage with Wolverine.

Parameters
fileFile to be sent
typewolverine
Usage Example
javascript
Copy
Response Example
javascript
Copy
Emojis2 endpoints
getemjGETapplication/x-www-form-urlencoded

/getemj

I send you all the information about an emoji, as well as its images from each different vendor.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
randomemjGETapplication/x-www-form-urlencoded

/randomemj

I send you all the information about a random emoji, as well as its images from each different vendor.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
Logos9 endpoints
comicGETapplication/x-www-form-urlencoded

/logos

Creates a "comic" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
dragonballGETapplication/x-www-form-urlencoded

/logos

Creates a "dragonball" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
silverGETapplication/x-www-form-urlencoded

/logos

Creates a "silver" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
neonGETapplication/x-www-form-urlencoded

/logos

Creates a "neon" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
glitchGETapplication/x-www-form-urlencoded

/logos

Creates a "glitch" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
glassGETapplication/x-www-form-urlencoded

/logos

Creates a "glass" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
typographyGETapplication/x-www-form-urlencoded

/logos

Creates a "typography" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
narutoGETapplication/x-www-form-urlencoded

/logos

Creates a "naruto" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
americaGETapplication/x-www-form-urlencoded

/logos

Creates an "america" logo (image) from your text.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
Button Logos8 endpoints
ytgoldGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the YouTube gold play button.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
ytsilverGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the YouTube silver play button.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
fbgoldGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Facebook gold plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
fbsilverGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Facebook silver plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
iggoldGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Instagram gold plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
igsilverGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Instagram silver plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
ttgoldGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Twitter gold plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy
ttsilverGETapplication/x-www-form-urlencoded

/buttonlogo

I put your text on the Twitter silver plaque.

Parameters
qRequest content
Usage Example
javascript
Copy
Response Example
javascript
Copy