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://example.com/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

Lista solo productos de marketplace (sin servicios SMM). Mismos campos que las filas de producto en Services List, incluyendo id (ID de entidad de producto), service (número de servicio amigable), description y imageUrl. El 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).

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"

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 entityType opcional devuelve solo filas de producto o solo de smm. Los parámetros opcionales category y subcategory devuelven solo servicios en esa categoría o subcategoría (valores de la API Get Categories). El shopId opcional devuelve solo productos y servicios para esa tienda (usa shopId de Shops List). El productIds opcional devuelve solo productos de marketplace coincidentes (los servicios SMM se omiten cuando se establece productIds).

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://example.com/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:

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.