Tu Clave API

Prueba API

Selecciona una acción, completa los parámetros y envía una solicitud. Cuando hayas iniciado sesión, tu clave API se cargará automáticamente.

curl -X POST "https://hstockplus.com/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

Punto Final de la API

Todas las solicitudes de API deben enviarse mediante HTTP POST a este endpoint.

Idioma opcional (lang)

Opcional. Código de idioma de destino. Use uno de los códigos admitidos que se enumeran a continuación. Cuando se establece y no es "en", los campos traducibles se devuelven en ese idioma. Si una traducción aún no está disponible, la API devuelve inglés.

Compatible con acciones de lectura: categories, subcategory_info, services, products, inventory ((nombres de subproductos)), sms_projects, y sms_countries. Omit lang or use en for English.

Los parámetros de filtro de categoría y subcategoría en servicios/productos siempre utilizan nombres canónicos en inglés, incluso cuando lang está configurado.

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Obtener Categorías

Obtener todas las categorías y las subcategorías de cada categoría. Utilice estos valores para filtrar la Lista de Servicios por categoría o subcategoría.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

Ejemplo de Respuesta:

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

Información de Subcategoría

Obtén detalles de subcategoría por subcategoryId, incluyendo la categoría padre. Usa subcategoryId de las filas de Products List.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

Ejemplo de Respuesta:

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

Lista de Tiendas

Lista de tiendas activas con información básica, cantidad de productos y calificaciones de reseñas. Los nombres de las tiendas están ocultos por privacidad.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

Con paginación:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

Lista de Productos

Listar solo productos del marketplace (sin servicios SMM). Mismos campos que las filas de productos en la Lista de Servicios, incluyendo id (id de entidad de producto), service (número de servicio amigable), description e imageUrl. productIds opcional devuelve solo esos productos (números de servicio amigables de la lista y/o ids de entidad de producto, separados por comas o array JSON, máximo 100). sort=sold opcional ordena los resultados por unidades de pedido pagadas de forma descendente (más vendidos primero).

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

Filtrar por IDs de producto:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

Con paginación:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

Filtrar por categoría o subcategoría:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

Los más vendidos en una subcategoría:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

Solo productos recomendados:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

Lista de Servicios

Obtén todos los servicios disponibles con paginación opcional. Cada fila incluye id (ID de entidad), service (número de servicio amigable), stock y entityType (smm o product). El parámetro opcional entityType devuelve solo filas de producto o solo filas smm. Los parámetros opcionales de categoría y subcategoría devuelven solo los servicios de esa categoría o subcategoría (valores de la API Obtener Categorías). El parámetro opcional shopId devuelve solo productos y servicios de esa tienda (usa shopId de la Lista de Tiendas). El parámetro opcional productIds devuelve solo las filas coincidentes (números de servicio amigables y/o IDs de entidad; coincide con filas de producto o smm). Usa action=products para filtrar solo productos.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Con paginación:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

Filtrar por categoría o subcategoría:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Filtrar por tipo de entidad:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

Ejemplo de Respuesta:

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Cada fila incluye id (ID de entidad) y service (número de servicio amigable para pedidos), stock, entityType (smm o product) y autoDelivery. Las filas de producto también incluyen description, imageUrl, isRecommended y subcategoryId. Cuando limit es 0 o se omite, se devuelven todos los servicios y page/limit equivalen al total.

Verificar Inventario

Obtén el stock actual y la disponibilidad de un servicio por su ID (mismo ID que en la lista de servicios). Para productos de marketplace, el JSON incluye subproductos: un array de variantes activas, cada una con subproductId, nombre y stock (stock visible para esa variante).

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

Ejemplo de Respuesta (SMM):

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

Ejemplo de Respuesta (producto):

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0 }
  ]
}

La respuesta incluye rate (por unidad, mismo formato de cadena que la lista de servicios), entityType (smm o product) y autoDelivery (true = entrega automática, false = el proveedor completa manualmente). Para servicios de producto, min y max coinciden con la fila del subproducto principal en la lista de servicios; si ese subproducto no puede cumplir con tu pedido, la plataforma puede seleccionar otro subproducto y cobrar su precio unitario. El array subproducts lista cada variante activa con stock visible; las respuestas de inventario SMM omiten subproducts.

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery.

Solicitud de ejemplo:

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

Ejemplo de Respuesta:

{
  "order": 23501
}

Estado del Pedido

Obtener el estado de un pedido.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

Ejemplo de Respuesta:

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

Para pedidos de productos (por ejemplo, cuentas), cuando el pedido se entrega total o parcialmente, la respuesta incluye un array "accounts" con las credenciales de las cuentas entregadas (una cadena por cuenta). Para entregas parciales, solo se devuelven las cuentas entregadas hasta el momento.

autoDelivery: true si el pedido se cumple automáticamente (por ejemplo, SMM, productos de inventario/automáticos); false si el proveedor debe cumplirlo manualmente (puede tomar algo de tiempo).

Ejemplo de respuesta (pedido de producto con cuentas entregadas):

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

Posibles Estados:

Crear cancelación

Cancelar uno o más pedidos (formato de lote compatible con PerfectPanel). Cada pedido elegible se reembolsa a tu saldo.

Todo lo siguiente debe ser cierto. Usa allowcancel para verificar la elegibilidad sin procesar un reembolso.

• Cancelación anticipada: función de plataforma habilitada (configuración de administrador).
• Early cancel: productType is manual, auto, or inventory (SMM auto services typically use productType auto).
• Cancelación anticipada: el estado del pago es completado o parcial.
• Cancelación anticipada: el estado del pedido es pendiente, en proceso o error (los errores del proveedor aparecen como en curso).
• Cancelación temprana: sin external_id (el pedido aún no se ha enviado a un proveedor o prestador externo).
• Cancelación anticipada: al menos N minutos desde la finalización del pago (auto_order_early_refund_minutes, valor predeterminado 30).
• Cancelación anticipada: el cliente no ha utilizado ya el reembolso anticipado automático en este pedido.
• Cancelación anticipada: el pedido no se ha entregado por completo (la entrega parcial genera un reembolso proporcional por la parte no entregada).
• Cancelación anticipada: el importe reembolsable permanece (refundedAmount es menor que el total del pedido).
• Cancelación anticipada: no hay una disputa activa en el pedido.
• Cancelación anticipada: no hay retiro de proveedor en estado solicitado o completado.

La entrega parcial genera un reembolso parcial proporcional; las cuentas entregadas se conservan.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

Ejemplo de Respuesta:

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

Permitir cancelación

Verificar si uno o más pedidos pueden cancelarse en este momento (mismas reglas de elegibilidad que cancelar, pero no se procesa ningún reembolso). Úselo antes de llamar a cancelar para evitar solicitudes fallidas. Admite IDs de pedidos en lote (separados por coma, hasta 100).

Todo lo siguiente debe ser cierto. Usa allowcancel para verificar la elegibilidad sin procesar un reembolso.

• Cancelación anticipada: función de plataforma habilitada (configuración de administrador).
• Early cancel: productType is manual, auto, or inventory (SMM auto services typically use productType auto).
• Cancelación anticipada: el estado del pago es completado o parcial.
• Cancelación anticipada: el estado del pedido es pendiente, en proceso o error (los errores del proveedor aparecen como en curso).
• Cancelación temprana: sin external_id (el pedido aún no se ha enviado a un proveedor o prestador externo).
• Cancelación anticipada: al menos N minutos desde la finalización del pago (auto_order_early_refund_minutes, valor predeterminado 30).
• Cancelación anticipada: el cliente no ha utilizado ya el reembolso anticipado automático en este pedido.
• Cancelación anticipada: el pedido no se ha entregado por completo (la entrega parcial genera un reembolso proporcional por la parte no entregada).
• Cancelación anticipada: el importe reembolsable permanece (refundedAmount es menor que el total del pedido).
• Cancelación anticipada: no hay una disputa activa en el pedido.
• Cancelación anticipada: no hay retiro de proveedor en estado solicitado o completado.

Cuando allowcancel es 1, la respuesta incluye refundAmount (el monto que cancel devolvería).

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

Ejemplo de Respuesta:

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

Saldo

Obtén tu saldo actual.

Solicitud de ejemplo:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Ejemplo de Respuesta:

{
  "balance": "100.00",
  "currency": "USD"
}

SMS Verification API

Puntos de acceso dedicados para servicios de verificación por SMS.

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}

{
  "status": "code_received",
  "phone": "+1234567890",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "expires_at": "2023-01-01T12:00:00.000Z"
}

Respuestas de Error

Respuestas de error comunes que puedes encontrar.