Media Mister REST API v1 ⬇ OpenAPI JSON

This document is the complete reference for the Media Mister API. It describes every endpoint, every parameter, every response field, and every error code. You can use this document to automate SMM order management. An AI agent can read this document and execute complete workflows — sign up, get services, place orders, check status, and manage refills.

Create a Panel Account

You need a panel account to use the API. A regular mediamister.com customer account does not have API access. The panel account is separate.

How to get your API key

1. Create a panel account if you do not have one.
2. Log into your panel account at mediamister.com/panel.
3. Go to Settings.
4. Find the API Key section. Copy the key. It starts with api_.
5. Add funds to your wallet with Add Funds in the panel dashboard.
6. Use the key in all API requests as the key parameter.

Quick Start

Get your API key from Panel Settings. Run any example. All do the same thing — check your wallet balance.

curl -X POST "https://www.mediamister.com/api/v1/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=YOUR_API_KEY&action=balance"

import requests

API_KEY = "YOUR_API_KEY"
URL = "https://www.mediamister.com/api/v1/"

response = requests.post(URL, data={
    "key": API_KEY,
    "action": "balance"
})
print(response.json())
# {"balance": 991, "currency": "USD"}

const KEY = "YOUR_API_KEY";
const res = await fetch("https://www.mediamister.com/api/v1/", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ key: KEY, action: "balance" })
});
console.log(await res.json());
// {"balance": 991, "currency": "USD"}

$KEY = "YOUR_API_KEY";
$ch = curl_init("https://www.mediamister.com/api/v1/");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => http_build_query(["key" => $KEY, "action" => "balance"]),
    CURLOPT_RETURNTRANSFER => true,
]);
print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

Authentication

Every request must include your panel API key as the key parameter. The key is a string. It starts with api_.

Where to get it: Log into your panel account → Settings → API Key.

Security: Keep your key private. Do not commit it to public repositories. Do not expose it in client-side code. Rotate it from Settings if it is compromised.

What happens with a wrong key

{
  "error": "Invalid API key",
  "error_code": "INVALID_API_KEY"
}

The API returns HTTP 200 even for errors. Check the error field in the JSON body. Do not rely on HTTP status codes.

Available Platforms

The catalog has 55 platforms and 989+ services. Use get_services to get the full list. These are the platforms with their service counts (live data, August 2026):

Plus: Mixcloud, RedNote, ReverbNation, Vimeo, Quora, Coub, Tumblr, Apple, Android, Fansly, Lazada, OnlyFans, OpenSea, Shazam, Medium, Dailymotion, Chzzk, DatPiff, Napster, and more. Full list available via get_services.

Service Object Schema

Each service object in the get_services response has this structure. All fields are documented below.

Top-level fields (present on every service)

Variant fields (inside catalog_variants)

Real service example (Spotify Plays)

{
  "service_name": "Buy Spotify Plays",
  "service_id": "MM1030",
  "min_quantity": 10000,
  "max_quantity": 100000,
  "price_starts_from": 1.25,
  "catalog_variants": [
    {
      "order_type": "Spotify Track",
      "country": "Worldwide",
      "min_quantity": 10000,
      "max_quantity": 100000,
      "price_starts_from": 1.25,
      "profile_link_type": "URL",
      "profile_link_label": "Enter Spotify Track URL"
    }
  ]
}

Endpoints

All endpoints use the same base URL. The action parameter selects which operation to perform. Eight actions are available: balance, services, add, status, multiStatus, refill, refill_status, cancel.

{
  "balance": 991,
  "currency": "USD"
}

{
  "order": 123456
}

curl -X POST "https://www.mediamister.com/api/v1/" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "key=api_xxx&action=add&service_id=MM1030&link=https://open.spotify.com/track/4iV5W9uYEdYUVa79Axb7Rh&quantity=5000"

{
  "error": "Invalid service ID",
  "error_code": "INVALID_SERVICE"
}

{
  "error": "Quantity must be between 25 and 5000",
  "error_code": "QUANTITY_OUT_OF_RANGE",
  "min_quantity": 25,
  "max_quantity": 5000
}

{
  "error": "Missing required field: service_id",
  "error_code": "MISSING_REQUIRED_FIELD",
  "field": "service_id"
}

{
  "status": "In Progress",
  "submission_id": "API100025",
  "charge": "5.00",
  "start_count": "0",
  "remains": "5000",
  "currency": "USD"
}

{
  "API100025": {
    "status": "Pending",
    "charge": "5.00",
    "currency": "USD"
  },
  "API100026": {
    "status": "In Progress",
    "charge": "10.00",
    "start_count": "1000",
    "remains": "500",
    "currency": "USD"
  },
  "API100027": {
    "status": "Completed",
    "charge": "3.00",
    "start_count": "0",
    "remains": "0",
    "currency": "USD"
  }
}

{
  "refill": 98765
}

Order Status Values

An order moves through these states. Poll with get_order_status to track progress.

Error Reference

All errors return JSON with error (human-readable) and error_code (machine-readable) fields. Some errors include extra fields like min_quantity and max_quantity. The HTTP status code is always 200. Check the JSON body for errors.

Error Code Families

Complete Error Code List

Endpoint-level errors

These errors occur when the request does not reach the API handler:

{
  "error": "Method not allowed. Use POST."
}

{
  "error": "Missing required parameters: key and action",
  "error_code": "MISSING_REQUIRED_FIELD",
  "received_params": ["key"]
}

PHP Example Class

Complete PHP class for easy integration with the Media Mister API.

<?php
class MediaMisterApi
{
    /** API URL */
    public $api_url = 'https://www.mediamister.com/api/v1/';

    /** Your API key */
    public $api_key = '';

    /** Add order */
    public function order($data)
    {
        $post = array_merge(['key' => $this->api_key, 'action' => 'add'], $data);
        return json_decode($this->connect($post));
    }

    /** Get order status */
    public function status($order_id)
    {
        return json_decode(
            $this->connect([
                'key' => $this->api_key,
                'action' => 'status',
                'order' => $order_id
            ])
        );
    }

    /** Get orders status */
    public function multiStatus($order_ids)
    {
        return json_decode(
            $this->connect([
                'key' => $this->api_key,
                'action' => 'multiStatus',
                'orders' => implode(",", (array)$order_ids)
            ])
        );
    }

    /** Get services */
    public function services()
    {
        return json_decode(
            $this->connect([
                'key' => $this->api_key,
                'action' => 'services',
            ])
        );
    }

    /** Get balance */
    public function balance()
    {
        return json_decode(
            $this->connect([
                'key' => $this->api_key,
                'action' => 'balance',
            ])
        );
    }

    private function connect($post)
    {
        $_post = [];
        if (is_array($post)) {
            foreach ($post as $name => $value) {
                $_post[] = $name . '=' . urlencode($value);
            }
        }

        $ch = curl_init($this->api_url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

        if (is_array($post)) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, join('&', $_post));
        }
        curl_setopt($ch, CURLOPT_USERAGENT, 'MediaMisterAPI/1.0');
        $result = curl_exec($ch);
        if (curl_errno($ch) != 0 && empty($result)) {
            $result = false;
        }
        curl_close($ch);
        return $result;
    }
}

// Usage Examples
$api = new MediaMisterApi();
$api->api_key = 'your_api_key_here';

// Get available services
$services = $api->services();

// Check balance
$balance = $api->balance();

// Place an order
$order = $api->order([
    'service_id' => 'MM1001',
    'link' => 'https://www.tiktok.com/@vividflicks',
    'quantity' => 100
]);

// Check order status
$status = $api->status($order->order);

// Check multiple order status
$multi_status = $api->multiStatus([1, 2, 3]);
?>

Rate Limits

If you exceed the limit:

{
  "error": "Rate limit exceeded. Please try again later.",
  "error_code": "RATE_LIMIT_EXCEEDED"
}

Normal use does not hit this limit. Cache the services list — it is the largest response.

Complete Workflow for AI Agents

An AI agent can use this sequence to place and monitor an order:

Step 1 — Verify the connection

curl -X POST "https://www.mediamister.com/api/v1/" \
  -d "key=API_KEY&action=balance"

Check: response has balance field. No error field. Key works.

Step 2 — Get the service list

curl -X POST "https://www.mediamister.com/api/v1/" \
  -d "key=API_KEY&action=services"

Filter the response by service_name to find the platform you want. Pick a service_id. Note the min_quantity, max_quantity, and profile_link_label.

Step 3 — Place the order

curl -X POST "https://www.mediamister.com/api/v1/" \
  -d "key=API_KEY&action=add&service_id=MM1030&link=TARGET_URL&quantity=5000"

Response: {"order": 123456}. Save the order number.

Step 4 — Check the order

curl -X POST "https://www.mediamister.com/api/v1/" \
  -d "key=API_KEY&action=status&order=API100025"

Check the status field. Poll every 5-10 minutes until "Completed" or "Partial".

Step 5 — Refill if needed

curl -X POST "https://www.mediamister.com/api/v1/" \
  -d "key=API_KEY&action=refill&refill=API100025"

Error handling pattern

After every request, check the response for an error field. If present, read error_code to decide what to do:

MCP — The No-Code Alternative

If you do not want to write code, use the Media Mister MCP server. It wraps this REST API in an MCP interface. Connect any MCP client — Claude, ChatGPT, Cursor, Hermes Agent, OpenClaw — and use natural language.