En esta página

Documentación de la API del panel SMM

Versión API: v2

SmmFoxi ofrece una API estándar de panel SMM (v2) para que integres 373 servicios de marketing en redes sociales directamente en tu panel de revendedor, bot o app. Inicio rápido en los servicios elegibles, precios competitivos y automatización completa. Esta documentación cubre todos los endpoints disponibles y su uso.

Antes de empezar: acceso a la API en 4 pasos

Antes de tu primera llamada necesitas una cuenta, saldo y una clave de API. La configuración lleva unos minutos:

  1. 1

    Crea una cuenta

    Regístrate en SmmFoxi. La misma cuenta se usa en el panel web y en la API.

    Registrarse →
  2. 2

    Recarga tu saldo

    Los pedidos por API se cobran del saldo de tu cuenta. Añade fondos desde el panel; puedes consultar el saldo en cualquier momento con action=balance.

    Abrir panel →
  3. 3

    Obtén tu clave de API

    Ve a Panel → API y genera una clave. Solo se muestra completa una vez: cópiala y guárdala en un lugar seguro. Al renovarla, la clave anterior deja de funcionar de inmediato.

    Obtener clave de API →
  4. 4

    Integra y prueba

    Envía solicitudes POST a la dirección de abajo con tu clave y una action. Empieza con action=services para obtener los ID y precios de los servicios y luego haz un pequeño pedido de prueba.

    Ver dirección →

Endpoint API

https://smmfoxi.com/api/v2

Todas las solicitudes deben enviarse a este endpoint mediante el método POST o GET.

Autenticación

Todas las solicitudes a la API requieren autenticación con tu clave de API. Genérala en Panel → API (la clave completa solo se muestra una vez, guárdala de inmediato). Incluye el parámetro key en cada solicitud.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

Formato de respuesta

Todas las respuestas se devuelven en formato JSON. Las solicitudes exitosas devuelven los datos solicitados, mientras que los errores devuelven un objeto con una descripción.

Endpoints API

Obtener servicios

Devuelve una lista de todos los servicios disponibles con sus detalles incluyendo precios, cantidades mínimas y máximas.

Parámetros

  • key - Tu clave API (requerido)
  • action - "services"
// Ejemplo de respuesta
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

Obtener saldo

Devuelve el saldo actual de tu cuenta y la moneda.

Parámetros

  • key - Tu clave API (requerido)
  • action - "balance"
// Ejemplo de respuesta
{
  "balance": "100.84292",
  "currency": "USD"
}

Agregar pedido

Crear un nuevo pedido para un servicio. Los parámetros requeridos dependen del tipo de servicio.

Tipo predeterminado

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)
  • quantity - Cantidad del pedido (requerido)

Tipo paquete

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)

Tipo comentarios personalizados

  • key - Tu clave API (requerido)
  • action - "add"
  • service - ID del servicio (requerido)
  • link - URL de destino (requerido)
  • comments - Comentarios separados por salto de línea (requerido)
// Ejemplo de respuesta
{
  "order": 23501
}

Estado del pedido

Obtener el estado de uno o más pedidos. Puedes consultar un solo pedido o varios a la vez.

Pedido único

  • key - Tu clave API (requerido)
  • action - "status"
  • order - ID del pedido (requerido)

Múltiples pedidos (hasta 100)

  • key - Tu clave API (requerido)
  • action - "status"
  • orders - IDs de pedidos separados por coma (requerido)
// Ejemplo de respuesta
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

Crear reposición

Solicitar una reposición para un pedido. Solo disponible para servicios que admiten reposiciones.

Parámetros

  • key - Tu clave API (requerido)
  • action - "refill"
  • order - ID del pedido (requerido)
// Ejemplo de respuesta
{
  "refill": "1"
}

Estado de reposición

Verificar el estado de una solicitud de reposición.

Parámetros

  • key - Tu clave API (requerido)
  • action - "refill_status"
  • refill - ID de reposición (requerido)
// Ejemplo de respuesta
{
  "status": "Completed"
}

Estados de pedido

  • Pending - El pedido está esperando ser procesado
  • Processing - El pedido se está preparando
  • In progress - El pedido se está ejecutando actualmente
  • Completed - El pedido se ha completado exitosamente
  • Partial - El pedido se completó parcialmente (reembolso por el resto)
  • Canceled - El pedido fue cancelado

Manejo de errores

Cuando ocurre un error, la API devuelve un objeto JSON con un campo error describiendo el problema.

// Ejemplo de respuesta de error
{
  "error": "Invalid API key"
}

Límites de tasa

Para asegurar la calidad del servicio, se aplican los siguientes límites de tasa:

  • 5 solicitudes por segundo
  • 100 solicitudes por minuto
  • 1000 solicitudes por hora