📘 REST API · v1

API Reseller Panel Developer Docs

Everything you need to integrate our API into your own application — authentication, endpoints, request parameters, and ready-to-run code samples in your favorite language.

🌐 Base URL: https://mahin.top/api 📡 Method: GET 📦 Format: JSON

Get Your API Key →

Step 1

Authentication

Every request is authenticated with your personal API Key via the key query parameter. You'll get your own key once an Admin creates a reseller account for you — log in to your dashboard to see it.

YOUR_API_KEY

Don't have an account yet? Log in or contact the Admin to get one.

Step 2

Endpoint

Send a GET request to this single endpoint for every category — the amount parameter tells the server which one.

GET https://mahin.top/api

Step 3

Query Parameters

Parameter	Required	Description
`key`	Required	Your personal API Key.
`amount`	Required	The category username you want to use — see the Categories section below.
`server_name`	Required	The server/region value required by the upstream API.
`uid`	Required	The target player/account UID.

Step 4

Available Categories

No categories have been published yet.

Step 5

Code Examples

Sample requests in a few languages — swap YOUR_API_KEY for your real API key once you have one.

🐍 request.py

import requests

url = "https://mahin.top/api"
params = {
    "key": "YOUR_API_KEY",
    "server_name": "IND",
    "uid": "123456789",
    "amount": "like"
}

response = requests.get(url, params=params)
result = response.json()

print(result["data"])
print(result["limit_info"])

🐘 request.php

<?php
$url = "https://mahin.top/api?" . http_build_query([
    "key"         => "YOUR_API_KEY",
    "server_name" => "IND",
    "uid"         => "123456789",
    "amount"      => "like",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result["data"]);
print_r($result["limit_info"]);

⚡ request.js

const params = new URLSearchParams({
  key: "YOUR_API_KEY",
  server_name: "IND",
  uid: "123456789",
  amount: "like"
});

fetch(`https://mahin.top/api?${params}`)
  .then(res => res.json())
  .then(result => {
    console.log(result.data);
    console.log(result.limit_info);
  });

💻 terminal

curl -G "https://mahin.top/api" \
  -d "key=YOUR_API_KEY" \
  -d "server_name=IND" \
  -d "uid=123456789" \
  -d "amount=like"

Step 6

Response Format

Every response is wrapped in the same structure — the upstream API's raw output stays inside data, and your current usage is always included in limit_info.

{ "data": { "LikesGivenByAPI": 200, "LikesafterCommand": 9804, "LikesbeforeCommand": 9604, "PlayerNickname": "Tanvir", "UID": 13365059959, "status": 1 }, "limit_info": { "allocated": 1000, "used": 12, "remaining": 988 } }

Step 7

Error Reference

When something goes wrong, you'll receive status: 0 with a message explaining why.

Message	Meaning
Invalid API key.	The `key` parameter doesn't match any account.
Your account has been blocked.	Contact the Admin — your access is currently suspended.
Your account has expired.	Your account's time limit has passed.
Your limit has been exhausted.	You've used your full allocated limit.
Your daily limit has been reached.	Resets automatically at 4:00 AM.
You do not have permission to use this category.	The `amount` value isn't in your allowed categories.
This API has reached its usage limit.	The upstream API itself is temporarily unavailable — try again later.

💬 Need an account or have questions? Reach out using the contact details on the Home page.