API do Insane SMM

Integre seu painel, bot ou sistema ao nosso catálogo. Um endpoint, cinco comandos, autenticação por chave.

Visão geral

A API usa um endpoint único. Você manda o parâmetro action dizendo o que quer, junto com sua key.

// Endpoint
https://insanesmm.com/api/v2

Sua chave de API

Entre no painel, vá em Minha API e copie sua chave. Ela identifica sua conta e usa o seu saldo nos pedidos.

Formato da requisição

Todo pedido leva pelo menos key e action. Os dois podem ir na URL ou no corpo.

# querystring
curl "https://insanesmm.com/api/v2?key=SUA_CHAVE&action=balance"

# form
curl -X POST https://insanesmm.com/api/v2 \
  -d "key=SUA_CHAVE" \
  -d "action=balance"

# json
curl -X POST https://insanesmm.com/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"SUA_CHAVE","action":"balance"}'

services — lista de serviços

Devolve todos os serviços ativos com preço, mínimo e máximo.

Resposta

[
  {
    "service": 12,
    "name": "Instagram — Seguidores Brasil",
    "type": "Default",
    "category": "Seguidores",
    "rate": "12.50",   // preço por 1000, em BRL
    "min": 100,
    "max": 100000
  }
]

balance — seu saldo

Resposta

{
  "balance": "152.30",
  "currency": "BRL"
}

add — criar pedido

Cria um pedido e desconta do seu saldo na hora.

Resposta

{
  "order": 1342
}

status — consultar um pedido

Resposta

{
  "charge": "6.25",        // quanto custou
  "start_count": "1204",   // contagem antes de começar
  "status": "In progress",
  "remains": "330",       // quanto falta entregar
  "currency": "BRL"
}

multistatus — vários pedidos

Consulta vários de uma vez. Melhor que chamar status num laço.

Resposta

{
  "1342": {
    "charge": "6.25",
    "start_count": "1204",
    "status": "Completed",
    "remains": "0",
    "currency": "BRL"
  },
  "1343": {
    "charge": "3.10",
    "start_count": "88",
    "status": "In progress",
    "remains": "420",
    "currency": "BRL"
  }
}

Status do pedido

Erros

Erro vem com HTTP 4xx ou 5xx e um campo error.

{
  "error": "Saldo insuficiente."
}

Limites e boas práticas

• Cacheie o services. O catálogo muda pouco. Consultar a cada pedido é desperdício.
• Use multistatus. Uma chamada com 50 IDs em vez de 50 chamadas.
• Não fique consultando status em loop apertado. Pedido leva minutos; consultar a cada 30-60 segundos basta.
• Trate o reembolso. Status Canceled, Failed e Partial devolvem saldo — reflita isso no seu sistema.
• Guarde o order. É como você consulta depois.

Exemplos

PHP

<?php
$key = 'SUA_CHAVE';
$url = 'https://insanesmm.com/api/v2';

function api($data) {
    global $url;
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $r = curl_exec($ch);
    curl_close($ch);
    return json_decode($r, true);
}

// saldo
$saldo = api(['key' => $key, 'action' => 'balance']);
echo $saldo['balance'];

// criar pedido
$pedido = api([
    'key'      => $key,
    'action'   => 'add',
    'service'  => 12,
    'link'     => 'https://instagram.com/perfil',
    'quantity' => 1000
]);
echo $pedido['order'];

Node.js

const KEY = 'SUA_CHAVE';
const URL = 'https://insanesmm.com/api/v2';

async function api(data) {
  const r = await fetch(URL, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ key: KEY, ...data })
  });
  const j = await r.json();
  if (!r.ok) throw new Error(j.error);
  return j;
}

// saldo
const { balance } = await api({ action: 'balance' });

// criar pedido
const { order } = await api({
  action: 'add',
  service: 12,
  link: 'https://instagram.com/perfil',
  quantity: 1000
});

// consultar
const st = await api({ action: 'status', order });
console.log(st.status, st.remains);

Python

import requests

KEY = 'SUA_CHAVE'
URL = 'https://insanesmm.com/api/v2'

def api(**kw):
    r = requests.post(URL, data={'key': KEY, **kw}, timeout=30)
    j = r.json()
    if 'error' in j:
        raise Exception(j['error'])
    return j

# saldo
print(api(action='balance')['balance'])

# criar pedido
p = api(
    action='add',
    service=12,
    link='https://instagram.com/perfil',
    quantity=1000
)
print(p['order'])