API Documentation

Our API provides secure access to MambaPanel's Professional Face Recognition engine, allowing you to search through our database of 1.8B faces. Each request deducts 1 credit from your account balance.

Getting Started

To use the Face Recognition API, you'll need:

An API key from MambaPanel
Credits in your account (1 credit per search)
Basic knowledge of making HTTP requests

Base URL

API Endpoint

POST https://mambapanel.com/api/v1/face

Authentication

All requests must include your API key in the Authorization header using Bearer authentication.

Headers

Content-Type: application/json
Authorization: Bearer {your_api_key}

Request Parameters

Parameter	Type	Required	Description
image	string (base64)	Yes	Base64 encoded image containing the face to search

Example Request

PHP

// Sample cURL request in PHP
$api_key = "your_api_key_here";
$image_path = "path/to/image.jpg";

// Convert image to base64
$image_data = base64_encode(file_get_contents($image_path));

$data = json_encode([
    "image" => $image_data
]);

$ch = curl_init("https://mambapanel.com/api/v1/face");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer $api_key"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($ch);
curl_close($ch);

$results = json_decode($response, true);
print_r($results);

Response Format

The API returns responses in JSON format with the following structure:

Success Response

JSON

{
    "success": true,
    "results": [
        {
            "score": 95.8,
            "source": "Instagram",
            "url": "https://example.com/profile",
            "base64": "encoded_image_data",
            "guid": "instagram_12345"
        }
    ],
    "credits_remaining": 49
}

Error Response

JSON

{
    "success": false,
    "message": "Error description"
}

Error Codes

HTTP Code	Description
400	Bad Request - Invalid image format or missing image data
401	Unauthorized - Invalid API key
402	Payment Required - Insufficient credits
413	Request Entity Too Large - Image file too large (max 5MB)
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error - API server error

Usage Guidelines

Each successful API request costs 1 credit
Maximum image size: 5MB
Supported formats: JPG, PNG
Face must be clearly visible in the image
Recommended minimum face resolution: 200x200 pixels
Keep your API key secure
Cache results when possible to save credits

Get Your API Key View Face Search PHP Script