tuyyiAPI

API Documentation

Everything you need to call tuyyiAPI from your WhatsApp bot.

Getting started

Base URL

https://tuyyiapi.eu.cc

Authentication

Add your API key to every request, either as the apikey query parameter or the x-api-key header. Create a free account to get one.

GET https://tuyyiapi.eu.cc/api/status?apikey=YOUR_API_KEY

Response format

{
  "creator": "@tuyyiapi",
  "status": true,
  "data": {
    "...": "..."
  }
}

{
  "creator": "@tuyyiapi",
  "status": false,
  "msg": "Invalid API key"
}

HTTP status codes

200	Request succeeded
400	A parameter is missing or invalid
401	API key missing or invalid
403	Key suspended, or the endpoint needs a higher plan
404	Endpoint not found
429	Per-minute or daily limit reached
500	Unexpected server error

Successful requests include X-RateLimit-Limit and X-RateLimit-Remaining headers with your daily quota.

Tools

GET/api/base64

Base64

Encode text to Base64 or decode Base64 back to text.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text (or Base64 string) to convert
`mode`	string	no	Conversion direction (default: encode)

Example request

curl "https://tuyyiapi.eu.cc/api/base64?apikey=YOUR_API_KEY&text=tuyyiAPI&mode=encode"

Example response

Try in playground

GET/api/hash

Hash

Create a hash digest (md5, sha1, sha256 or sha512) of a text.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text to hash
`algo`	string	no	Hash algorithm (default: sha256)

Example request

curl "https://tuyyiapi.eu.cc/api/hash?apikey=YOUR_API_KEY&text=hello%20world&algo=sha256"

Example response

Try in playground

GET/api/uuid

UUID Generator

Generate random UUID v4 values.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`count`	number	no	How many UUIDs to generate (1-20) (default: 1)

Example request

curl "https://tuyyiapi.eu.cc/api/uuid?apikey=YOUR_API_KEY&count=3"

Example response

Try in playground

GET/api/password

Password Generator

Generate a cryptographically random password.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`length`	number	no	Password length (4-64) (default: 16)
`symbols`	boolean	no	Include symbols (default: true)

Example request

curl "https://tuyyiapi.eu.cc/api/password?apikey=YOUR_API_KEY&length=16&symbols=true"

Example response

Try in playground

GET/api/lorem

Lorem Ipsum

Generate placeholder paragraphs.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`paragraphs`	number	no	Number of paragraphs (1-5) (default: 1)

Example request

curl "https://tuyyiapi.eu.cc/api/lorem?apikey=YOUR_API_KEY&paragraphs=2"

Example response

Try in playground

GET/api/slug

Slugify

Turn any text into a URL-friendly slug.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text to slugify

Example request

curl "https://tuyyiapi.eu.cc/api/slug?apikey=YOUR_API_KEY&text=Halo%20Dunia!%20Ini%20Judul%20Artikel"

Example response

Try in playground

GET/api/wordcount

Word Counter

Count characters, words, sentences and lines, plus an estimated reading time.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text to analyse

Example request

curl "https://tuyyiapi.eu.cc/api/wordcount?apikey=YOUR_API_KEY&text=Satu%20dua%20tiga.%20Empat%20lima%20enam!"

Example response

Try in playground

GET/api/textcase

Text Case

Convert text to upper, lower, title, camel, pascal, snake or kebab case.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text to convert
`style`	string	yes	Target case

Example request

curl "https://tuyyiapi.eu.cc/api/textcase?apikey=YOUR_API_KEY&text=hello%20tuyyi%20api&style=camel"

Example response

Try in playground

GET/api/color

Color Converter

Convert a HEX color into RGB and HSL.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`hex`	string	yes	HEX color, 3 or 6 digits, with or without #

Example request

curl "https://tuyyiapi.eu.cc/api/color?apikey=YOUR_API_KEY&hex=00a884"

Example response

Try in playground

GET/api/timestamp

Timestamp

Current time (or a given Unix timestamp) in any IANA timezone.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`tz`	string	no	IANA timezone name (default: Asia/Jakarta)
`ts`	number	no	Unix timestamp in seconds or milliseconds (default: now)

Example request

curl "https://tuyyiapi.eu.cc/api/timestamp?apikey=YOUR_API_KEY&tz=Asia%2FJakarta&ts=1735689600"

Example response

Try in playground

GET/api/morse

Morse Code

Encode text to Morse code or decode Morse back to text.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`text`	string	yes	Text or Morse (letters separated by space, words by " / ")
`mode`	string	no	Conversion direction (default: encode)

Example request

curl "https://tuyyiapi.eu.cc/api/morse?apikey=YOUR_API_KEY&text=sos&mode=encode"

Example response

Try in playground

GET/api/calc

Calculator

Safely evaluate a math expression. Supports + - * / % ^ and parentheses.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`expression`	string	yes	Math expression

Example request

curl "https://tuyyiapi.eu.cc/api/calc?apikey=YOUR_API_KEY&expression=(12%2B8)*3%5E2%2F4"

Example response

Try in playground

GET/api/terbilang

Terbilang

Spell a number out in Indonesian words.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`number`	number	yes	Integer to spell out

Example request

curl "https://tuyyiapi.eu.cc/api/terbilang?apikey=YOUR_API_KEY&number=1250000"

Example response

Try in playground

GET/api/roman

Roman Numerals

Convert an Arabic number (1-3999) to Roman numerals, or Roman numerals to a number.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`value`	string	yes	A number like 2026 or Roman like MMXXVI

Example request

curl "https://tuyyiapi.eu.cc/api/roman?apikey=YOUR_API_KEY&value=2026"

Example response

Try in playground

GET/api/zodiac

Zodiac

Find the zodiac sign for a birth date.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`date`	string	yes	Birth date, YYYY-MM-DD

Example request

curl "https://tuyyiapi.eu.cc/api/zodiac?apikey=YOUR_API_KEY&date=2000-08-17"

Example response

Try in playground

GET/api/age

Age Calculator

Calculate exact age and the countdown to the next birthday.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`birthdate`	string	yes	Birth date, YYYY-MM-DD

Example request

curl "https://tuyyiapi.eu.cc/api/age?apikey=YOUR_API_KEY&birthdate=2000-08-17"

Example response

Try in playground

Games

GET/api/caklontong

Cak Lontong

Random Cak Lontong style trick question with its answer and explanation (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/caklontong?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/riddle

Tebak-tebakan

Random riddle with its answer (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/riddle?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/brainout

Brain Out

Random general-knowledge question with a short answer (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/brainout?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/whoami

Siapakah Aku

Guess-who style riddle where the object describes itself (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/whoami?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/whatword

Susun Kata

Scrambled word puzzle with its category and answer.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/whatword?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/flag

Tebak Bendera

Random country flag image URL with the country name.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/flag?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/hangman

Hangman Word

Random word with a hint for a hangman game. Leave category empty for a random one.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`category`	string	no	Word category: hewan, buah, profesi, sayuran, negara

Example request

curl "https://tuyyiapi.eu.cc/api/hangman?apikey=YOUR_API_KEY&category=hewan"

Example response

Try in playground

GET/api/quiz

Family Quiz

Family-100 style question with the list of accepted answers (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/quiz?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/kbbi

KBBI Word Check

Check whether a word exists in the Indonesian dictionary list (KBBI) and get words that start with it.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`word`	string	yes	Word to look up

Example request

curl "https://tuyyiapi.eu.cc/api/kbbi?apikey=YOUR_API_KEY&word=abadi"

Example response

Try in playground

Random

GET/api/truth

Truth

Random truth question for truth-or-dare (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/truth?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/dare

Dare

Random dare challenge for truth-or-dare (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/dare?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/bucin

Bucin Quotes

Random cheesy love line (Indonesian).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/bucin?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/8ball

Magic 8 Ball

Ask a yes/no question and get a mysterious answer.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`question`	string	yes	Your question

Example request

curl "https://tuyyiapi.eu.cc/api/8ball?apikey=YOUR_API_KEY&question=Apakah%20hari%20ini%20hari%20keberuntunganku%3F"

Example response

Try in playground

GET/api/choose

Choose One

Pick one random option from a comma separated list.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`options`	string	yes	Comma separated options (2-50)

Example request

curl "https://tuyyiapi.eu.cc/api/choose?apikey=YOUR_API_KEY&options=nasi%20goreng%2Cmie%20ayam%2Cbakso"

Example response

Try in playground

GET/api/dice

Dice Roll

Roll one or more dice.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`count`	number	no	Number of dice (1-20) (default: 1)
`sides`	number	no	Sides per die (2-100) (default: 6)

Example request

curl "https://tuyyiapi.eu.cc/api/dice?apikey=YOUR_API_KEY&count=2&sides=6"

Example response

Try in playground

GET/api/coinflip

Coin Flip

Flip a coin.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/coinflip?apikey=YOUR_API_KEY"

Example response

Try in playground

GET/api/number

Random Number

Random integer in a range (inclusive).

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`min`	number	no	Minimum value (default: 1)
`max`	number	no	Maximum value (default: 100)

Example request

curl "https://tuyyiapi.eu.cc/api/number?apikey=YOUR_API_KEY&min=1&max=100"

Example response

Try in playground

Image

GET/api/avatarSVG image

Initials Avatar

Generate an SVG avatar from a name. The color is derived from the name so it stays the same every time.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`name`	string	yes	Full name
`size`	number	no	Image size in px (32-1024) (default: 256)
`shape`	string	no	Avatar shape (default: circle)

Example request

curl "https://tuyyiapi.eu.cc/api/avatar?apikey=YOUR_API_KEY&name=Tuyyi%20API&size=256&shape=circle" -o result.svg

Example response

Try in playground

GET/api/placeholderSVG image

Placeholder Image

Generate an SVG placeholder image with custom size and label.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)
`width`	number	no	Width in px (16-2000) (default: 600)
`height`	number	no	Height in px (16-2000) (default: 400)
`text`	string	no	Label (default: width×height)

Example request

curl "https://tuyyiapi.eu.cc/api/placeholder?apikey=YOUR_API_KEY&width=600&height=400&text=tuyyiAPI" -o result.svg

Example response

Try in playground

Info

GET/api/statusNo key needed

Server Status

Check that the API is online. This endpoint does not need an API key.

Parameters

This endpoint takes no parameters.

Name	Type	Required	Description

Example request

curl "https://tuyyiapi.eu.cc/api/status"

Example response

Try in playground

GET/api/myip

My IP

Return the IP address and user-agent the request came from.

Parameters

Name	Type	Required	Description
`apikey`	string	yes	Your API key (or send the `x-api-key` header)

Example request

curl "https://tuyyiapi.eu.cc/api/myip?apikey=YOUR_API_KEY"

Example response

Try in playground