LogoLogo
Atrás

Documentación de la API

API v2 del panel SMM de Followir: endpoints, parámetros y ejemplos de solicitudes y respuestas.

Followir ofrece una API HTTP sencilla que sigue el formato habitual de la API v2 de paneles SMM, por lo que la mayoría de los paneles de reventa y scripts funcionan con ella tal cual. Todas las respuestas son JSON.

Primeros pasos

  1. Crea una cuenta y añade fondos.
  2. Abre la página de API de tu cuenta y genera tu clave de API. Mantenla privada.
  3. Opcional: añade las direcciones IP autorizadas para usar tu clave (déjalo vacío para permitir cualquier IP).

Punto de acceso (endpoint)

URLhttps://followir.com/api/v2
MétodoPOST (GET también funciona)
FormatoParámetros de formulario de entrada, JSON de salida
Obligatorio en cada llamadakey (tu clave de API) y action

Acciones

actionParámetrosQué hace
serviceskeyLista todos los servicios disponibles con precios y límites
addkey, service, link, quantity (runs, interval para entrega gradual)Crea un nuevo pedido
statuskey, order u orders (separados por comas)Estado del pedido, uno o varios
cancelkey, order u orders (separados por comas)Cancela pedidos en los servicios que lo permiten
refillkey, order u orders (separados por comas)Solicita una reposición en los pedidos aptos
refill_statuskey, refillEstado de una solicitud de reposición
balancekeyTu saldo actual y la moneda

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 es el precio por 1000. refill y cancel indican si el servicio admite esas opciones.

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 }

En los servicios de entrega gradual (drip-feed) también puedes enviar runs (mínimo 2) e interval (minutos, de 1 a 1440). Se ignoran en los demás servicios.

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"
}

Varios pedidos a la vez: envía orders=850758,850759. La respuesta es un objeto indexado por número de pedido. Valores posibles 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" }

Algunas cancelaciones esperan confirmación y entonces la respuesta muestra "status": "Pending". Con varios pedidos obtienes una lista de elementos { "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" }

Errores

Cuando algo sale mal, la respuesta incluye un campo error:

{ "error": "Not enough funds" }
MensajeSignificado
API key is requiredFalta el parámetro key
Action is required / Incorrect actionFalta action o es desconocida
Invalid API keyLa clave es incorrecta o está desactivada, o tu IP no está en la lista blanca
Incorrect service ID / Service not foundEl número de servicio no existe o está desactivado
Link is required / Incorrect quantityFalta el enlace, o la cantidad no es un número válido
Quantity must be between ...Fuera del mínimo y el máximo del servicio
Not enough fundsTu saldo es insuficiente para este pedido
Order not foundEl pedido no existe en tu cuenta
Cancel is not available for this serviceEste servicio no se puede cancelar

Ejemplos 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())

Conviene saber

  • Los números de pedido son los mismos que ves en tu página de pedidos.
  • Hacer muchos pedidos a la vez para el mismo enlace puede ser rechazado hasta que termine el primero.
  • Cada llamada queda registrada en tu cuenta. Si crees que tu clave se filtró, regenérala desde la página de API.
  • ¿Necesitas ayuda con la integración? Abre un ticket en la página de soporte.

Atrás