API del pannello SMM Inspiria

Inspiria usa un'API compatibile PerfectPanel v2. Se gestisci un tuo pannello reseller (PerfectPanel, SMMKings o qualsiasi pannello compatibile), aggiungi Inspiria come provider direttamente nella sezione API Providers / Suppliers del tuo pannello: inserisci il nostro base URL e la tua API key Inspiria. La configurazione del tuo pannello resta intatta; ottieni semplicemente accesso ai nostri servizi come nuovo fornitore.

Introduction

The Inspiria API lets you automate the purchase of Instagram services: likes, followers, comments, story and reel views, saves and shares. All requests are sent via POST /api/v2 with body encoded as application/x-www-form-urlencoded or application/json.

Base URL:

https://inspiria.su/api/v2

Your API key is available in the API Key section of your user dashboard. Each account has a unique key.

Authentication

Include your API Key in every request. You have three options:

Option 1 — Body parameter (recommended)

POST /api/v2
Content-Type: application/json

{
  "key":    "your-api-key",
  "action": "balance"
}

Option 2 — HTTP header

POST /api/v2
X-Api-Key: your-api-key
Content-Type: application/json

{ "action": "balance" }

Option 3 — Query parameter

POST /api/v2?key=your-api-key
Content-Type: application/json

{ "action": "balance" }

If the key is missing or invalid, you will receive HTTP 401.

Common Parameters

ParameterTypeDescription
keystringUser API Key (required unless using X-Api-Key header)
actionstringAction to perform: services, balance, add, status, cancel

action=services

Returns the list of all active services with prices and quantity limits.

Request

POST /api/v2
{ "key": "YOUR_KEY", "action": "services" }

Response

[
  {
    "service":     1017,
    "name":        "IG Likes - Male+Female",
    "type":        "Default",
    "category":    "Likes",
    "rate":        "3.5000",       // price per 1000 units in EUR
    "min":         "25",
    "max":         "5000",
    "dripfeed":    false,
    "refill":      false,
    "cancel":      true,
    "description": "Link type: post_url"   // see Link Types section
  },
  ...
]

The description field contains the required link type for the service. See the Link Types section below for details on what URL format each service expects.

action=balance

Returns the current account balance in EUR.

// Request
{ "key": "YOUR_KEY", "action": "balance" }

// Response
{
  "balance":  "42.5000",
  "currency": "EUR"
}

action=add

Creates a new order. Balance is deducted immediately.

ParameterRequiredDescription
serviceYesService ID (from action=services)
linkYesTarget URL or username (see Link Types below)
quantityYesQuantity (must be within min/max of the service)

SMM order example

// Request
{
  "key":      "YOUR_KEY",
  "action":   "add",
  "service":  1017,
  "link":     "https://www.instagram.com/p/XXXXX/",
  "quantity": 100
}

// Response (success)
{ "order": 12345 }

// Response (insufficient balance)
{ "error": "Insufficient balance. Required: €0.3500, Available: €0.1200" }

// Response (wrong link type)
{ "error": "This service requires a post URL (e.g. instagram.com/p/...)" }

Username / profile order example

// Request
{
  "key":      "YOUR_KEY",
  "action":   "add",
  "service":  2,
  "link":     "myusername",
  "quantity": 500
}

// Response (success)
{ "order": 12346 }
Profile-based services (e.g. Followers) use link = your Instagram username (no URL needed). The quantity is the number of real accounts that will interact with your profile. See the Link Types section for which services need a username vs a post URL.

action=status

Check the status of one or more orders. Supports both single and batch requests.

Single order

// Request
{ "key": "YOUR_KEY", "action": "status", "order": 12345 }

// Response
{
  "charge":      "0.3500",
  "start_count": "1042",
  "status":      "In progress",
  "remains":     "87",
  "currency":    "EUR"
}

Multiple orders (batch)

// Request
{ "key": "YOUR_KEY", "action": "status", "orders": "12345,12346,12347" }

// Response
{
  "12345": { "charge": "0.35", "start_count": "1042", "status": "Completed", "remains": "0", "currency": "EUR" },
  "12346": { "charge": "0.70", "start_count": "500",  "status": "In progress", "remains": "50", "currency": "EUR" },
  "12347": { "error": "Order not found" }
}

See the Order Statuses section for a full list of possible status values.

action=cancel

Cancel one or more orders. See the Refund Policy section for refund details.

Single order

// Request
{ "key": "YOUR_KEY", "action": "cancel", "order": 12345 }

// Response (success)
{ "12345": 1 }

// Response (cannot cancel)
{ "12345": "Cannot cancel: status is completed" }

Multiple orders (batch)

// Request
{ "key": "YOUR_KEY", "action": "cancel", "orders": "12345,12346" }

// Response
{
  "12345": 1,
  "12346": "Cannot cancel: status is completed"
}

The response is a JSON object where each key is the order ID. Value 1 = successfully cancelled. A string value indicates the error reason.

Only orders with status Pending or In progress can be cancelled.

Refund Policy

Refunds are calculated automatically when you cancel an order via action=cancel.

SMM orders (one-time)

Delivery progressRefundOrder status after cancel
0% (not started)100%Canceled
1% - 49%50%Partial
50% - 100%0%Partial

If the content you linked becomes unavailable (deleted post, private account, etc.), the order is automatically marked Partial after 5 consecutive failed delivery attempts, and the undelivered portion is refunded at 50%.

Order Statuses

These are the possible values of the status field returned by action=status.

StatusDescription
PendingOrder received, waiting to start processing
In progressDelivery is in progress. Check remains to see how much is left.
CompletedAll quantity has been delivered successfully
PartialOnly part of the order was delivered (content unavailable, or cancelled mid-delivery)
CanceledOrder was cancelled before delivery started
ErrorOrder failed due to an internal error

Status flow

Pending --> In progress --> Completed
                 |               |
                 v               v
             Canceled         Partial

Error Codes

HTTPErrorCause
200{"error": "..."}Logic error (insufficient balance, invalid quantity, order not found, wrong link type)
401UnauthorizedAPI Key missing or invalid
403Account suspendedAccount disabled by admin
500Internal errorServer-side error — please retry or contact support

Common error messages

ErrorWhat to do
Insufficient balanceDeposit more funds
Invalid serviceUse action=services to get valid service IDs
Quantity out of rangeCheck min/max of the service
Incorrect order IDThe order does not exist or belongs to another account
Cannot cancel: status is ...Only Pending and In progress orders can be cancelled

Automatic Volume Discounts

Inspiria automatically applies a discount based on your spending volume over the last 14 days. The discount is recalculated every hour and applied in real time to all new orders.

Volume (14 days)DiscountTier
€0 – €49.990%Base
€50 – €149.9910%Lite
€150 – €299.9920%Silver
€300 – €599.9930%Gold
€600+40%Reseller

Your current discount is visible in your dashboard. Prices returned by action=services already include your discount.

Panel Integration Guide

If you run your own reseller panel (PerfectPanel, SMMKings, JEAP, SMMBuzz, or any panel that supports the standard SMM API format), you can add Inspiria as a provider / supplier in minutes. No coding required.

What you need

API URLhttps://inspiria.su/api/v2
API KeyYour Inspiria API key (Dashboard > API Key section)

Setup in PerfectPanel

StepAction
1Log in to your PerfectPanel admin dashboard
2Go to Providers (left sidebar)
3Click Add New Provider
4Fill in:
Name: Inspiria (or any label you prefer)
URL: https://inspiria.su/api/v2
API Key: paste your Inspiria API key
Currency: EUR
5Click Save — your balance will appear automatically
6Go to Services > Import from Provider
7Select Inspiria as the provider
8Select the services you want to offer, set your markup, and activate them

Setup in other panels (SMMKings, JEAP, SMMBuzz, etc.)

The process is nearly identical across all panels that support the standard SMM API:

StepAction
1Find the Providers, API Providers, or Suppliers section in your admin panel
2Add a new provider with URL https://inspiria.su/api/v2 and your API key
3Import services, set your prices, and activate

How it works

Your Panel (PerfectPanel / SMMKings / ...)
    |
    |  POST https://inspiria.su/api/v2
    |  { key: "YOUR_API_KEY", action: "add", service: 1001, link: "...", quantity: 100 }
    v
Inspiria API
    |
    |  Validates order, deducts balance, creates order
    v
Inspiria Engine --> Real Italian Accounts --> Instagram

When your customer places an order on your panel, your panel sends it to Inspiria via the API. We process it, deliver the service, and your panel automatically syncs the status updates (Pending > In progress > Completed).

Tip: Test the connection first by calling action=balance with your API key. If you get back your balance and currency, the integration is working correctly.

Supported actions

ActionSupportedNotes
servicesYesFull catalog with prices, min/max, categories
addYesStandard format: service + link + quantity
statusYesSingle and batch (up to 100 orders)
cancelYesSingle and batch — refund per our Refund Policy
balanceYesReturns balance in EUR
refillNoNot applicable — our services use real accounts, not bots