Documentation — Malvin API

Introduction

Malvin API is a REST API platform with 70+ endpoints covering AI, media downloaders, search tools, stalker tools, text effects, and more. All responses are JSON. All requests require an API key.

The API was built for developers building WhatsApp bots, web apps, and automation scripts. It's intentionally simple — one URL, one key, clean JSON back.

The free tier gives you 1,000 requests/day. Upgrade to Premium ($3 one-time) for unlimited access with no rate limits.

Authentication

Every request requires your API key passed as the apikey query parameter (GET) or in the request body (POST).

GET Request

GET with apikey

GET https://api.malvin.gleeze.com/ai/gemini?text=Hello&apikey=mvn_your_key_here

POST Request

POST with apikey

POST https://api.malvin.gleeze.com/tools/audiofx
Content-Type: multipart/form-data

apikey=mvn_your_key_here
effect=bass
audio=[file]

Never expose your API key in client-side code or public repos. Keep it server-side.

No key? Sign up free to get yours instantly. For premium unlimited access, see the pricing page.

Quick Start

Making your first request takes about 30 seconds. Here are examples in three languages.

cURL

bash

curl "https://api.malvin.gleeze.com/ai/gemini?text=Hello+world&apikey=YOUR_KEY"

JavaScript (fetch)

 script.js
// GET request
const res = await fetch("https://api.malvin.gleeze.com/ai/gemini?text=Hello&apikey=YOUR_KEY");
const data = await res.json();
console.log(data.result); // "Hello! How can I help?"

Python

 main.py
import requests

res = requests.get("https://api.malvin.gleeze.com/ai/gemini", params={
    "text": "Hello world",
    "apikey": "YOUR_KEY"
})
print(res.json()["result"])

Response Format

All endpoints return a consistent JSON structure regardless of the type of request.

Success (2xx)

 200 OK
{
  "status": 200,
  "creator": "Malvin King",
  "result": "..."  // varies: string | object | array | URL
}

Error (4xx / 5xx)

 401 Unauthorized
{
  "status": 401,
  "creator": "Malvin King",
  "error": "Invalid or missing API key"
}

The result field type depends on the endpoint. Download endpoints return a URL string, AI endpoints return a string, stalk endpoints return an object with profile data.

Error Codes

All errors follow standard HTTP status codes and include a descriptive error field.

Code	Name	Cause
400	Bad Request	Missing or invalid required parameters
401	Unauthorized	Invalid, missing, or expired API key
429	Too Many Requests	Daily rate limit exceeded (free tier: 1,000/day)
500	Server Error	Internal error — try again or contact support

Rate Limits

Rate limits are applied per API key, per day (resets at midnight UTC).

Tier	Daily Limit	Cost
Free	1,000 requests/day	$0 — forever
Premium	Unlimited	$3 one-time payment

When you hit the limit you'll receive a 429 Too Many Requests response. Your limit resets the following day. Upgrade to Premium to remove limits permanently.

GET vs POST Endpoints

Most endpoints are GET — pass everything as query parameters. POST is used for file uploads (Upload Tools, Audio Effects, To URL).

Method	When Used	How to Send Params
GET	Text/URL inputs — AI, search, download, stalk, tools	Query string: `?param=value&apikey=KEY`
POST	File uploads — Upload Tools, Audio FX, To URL	multipart/form-data body

POST endpoints that accept files use multipart/form-data. The API explorer on the docs page has a built-in drag & drop uploader for these.

Malvin API Reference

Introduction

Authentication

GET Request

POST Request

Quick Start

cURL

JavaScript (fetch)

Python

Response Format

Success (2xx)

Error (4xx / 5xx)

Error Codes

Rate Limits

GET vs POST Endpoints

Ready to build?