LogoLogo
Voltar

Documentação da API

API v2 do Painel SMM da Followir: endpoints, parâmetros, exemplos de requisições e respostas.

A Followir oferece uma API HTTP simples que segue o formato comum da API v2 de Painéis SMM, então a maioria dos painéis de revenda e scripts funciona com ela sem alterações. Todas as respostas são em JSON.

Primeiros passos

  1. Crie uma conta e adicione saldo.
  2. Abra a página da API na sua conta e gere a sua chave de API. Mantenha-a privada.
  3. Opcional: adicione os endereços IP autorizados a usar a sua chave (deixe vazio para permitir qualquer IP).

Endpoint

URLhttps://followir.com/api/v2
MétodoPOST (GET também funciona)
FormatoParâmetros de formulário na entrada, JSON na saída
Obrigatório em toda chamadakey (a sua chave de API) e action

Ações

actionParâmetrosO que faz
serviceskeyLista todos os serviços disponíveis com preços e limites
addkey, service, link, quantity (runs, interval para entrega gradual)Cria um novo pedido
statuskey, order ou orders (separados por vírgula)Status do pedido, de um ou de vários
cancelkey, order ou orders (separados por vírgula)Cancela pedidos em serviços que permitem cancelamento
refillkey, order ou orders (separados por vírgula)Solicita reabastecimento em pedidos elegíveis
refill_statuskey, refillStatus de uma solicitação de reabastecimento
balancekeySeu saldo atual e a moeda

services

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=services"
[
  {
    "service": "1",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.9000",
    "min": "100",
    "max": "100000",
    "refill": true,
    "cancel": false
  }
]

rate é o preço por 1000. refill e cancel indicam se o serviço oferece essas opções.

add

curl -X POST "https://followir.com/api/v2" \
  -d "key=YOUR_API_KEY" -d "action=add" \
  -d "service=1" -d "link=https://instagram.com/username" -d "quantity=1000"
{ "order": 850758 }

Em serviços de entrega gradual (drip-feed), você também pode enviar runs (mínimo de 2) e interval (minutos, de 1 a 1440). Eles são ignorados nos demais serviços.

status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=status" -d "order=850758"
{
  "charge": "0.9000",
  "start_count": "3572",
  "status": "In progress",
  "remains": "400",
  "currency": "USD"
}

Vários pedidos de uma vez: envie orders=850758,850759. A resposta é um objeto indexado pelo número do pedido. Valores possíveis de status: Pending, In progress, Completed, Partial, Canceled, Refunded.

cancel

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=cancel" -d "order=850758"
{ "status": "Success" }

Alguns cancelamentos aguardam confirmação, e então a resposta mostra "status": "Pending". Com vários pedidos, você recebe uma lista de itens { "order": ..., "cancel": ... }.

refill and refill_status

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill" -d "order=850758"
{ "refill": "12" }

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=refill_status" -d "refill=12"
{ "refill": "12", "status": "Pending" }

balance

curl -X POST "https://followir.com/api/v2" -d "key=YOUR_API_KEY" -d "action=balance"
{ "balance": "25.50", "currency": "USD" }

Erros

Quando algo dá errado, a resposta traz um campo error:

{ "error": "Not enough funds" }
MensagemSignificado
API key is requiredO parâmetro key está ausente
Action is required / Incorrect actionaction ausente ou desconhecida
Invalid API keyA chave está incorreta, desativada, ou o seu IP não está na lista de permitidos
Incorrect service ID / Service not foundO número do serviço não existe ou está desativado
Link is required / Incorrect quantityLink ausente, ou a quantidade não é um número válido
Quantity must be between ...Fora do mínimo e do máximo do serviço
Not enough fundsSeu saldo é insuficiente para este pedido
Order not foundO pedido não existe na sua conta
Cancel is not available for this serviceEste serviço não pode ser cancelado

Exemplos de código

PHP

$ch = curl_init("https://followir.com/api/v2");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'key'    => 'YOUR_API_KEY',
    'action' => 'add',
    'service'  => 1,
    'link'     => 'https://instagram.com/username',
    'quantity' => 1000,
]));
$response = json_decode(curl_exec($ch), true);
print_r($response);

Python

import requests

r = requests.post("https://followir.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "status",
    "order": 850758,
})
print(r.json())

Bom saber

  • Os números dos pedidos são os mesmos que você vê na sua página de pedidos.
  • Fazer muitos pedidos ao mesmo tempo para o mesmo link pode ser rejeitado até que o primeiro termine.
  • Toda chamada é registrada na sua conta. Se você acha que a sua chave vazou, gere-a novamente na página da API.
  • Precisa de ajuda com a integração? Abra um ticket na página de suporte.

Voltar