HstockPlus
HstockPlus/Documentación de la API
Iniciar sesión para obtener la clave API

Tu Clave API

Cargando...

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

Punto Final de la API

https://hstockplus.com/api/v2

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

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

ParameterDescriptionRequired
keyYour API keyYes
actioncategoriesYes

Solicitud de ejemplo:

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

Ejemplo de Respuesta:

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

Lista de Servicios

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

ParameterDescriptionRequired
keyYour API keyYes
actionservicesYes
pagePage number (default 1). Used when limit > 0.No
limitItems per page (default 0 = return all).No
categoryFilter by category name (from Get Categories). Returns only services in this category.No
subcategoryFilter by subcategory name (from Get Categories). Returns only services in this subcategory.No

Solicitud de ejemplo:

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

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"

Filter by category or subcategory:

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"

Ejemplo de Respuesta:

{
  "services": [
    {
      "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
    },
    {
      "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
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

Verificar Inventario

Obtén el stock actual y la disponibilidad de un servicio por su ID (el mismo ID que en la lista de servicios).

ParameterDescriptionRequired
keyYour API keyYes
actioninventoryYes
serviceService ID (from services list)Yes

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:

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

Agregar Pedido

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.

ParameterDescriptionRequired
keyYour API keyYes
actionaddYes
serviceService IDYes
linkLink: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.No
quantityQuantity to orderYes

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.

ParameterDescription
keyYour API key
actionstatus
orderOrder ID

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 if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

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:

PendingIn progressCompletedPartialCanceled

Saldo

Obtén tu saldo actual.

ParameterDescription
keyYour API key
actionbalance

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.

1. Obtener Proyectos SMS

Action: sms_projects

ParameterDescription
keyYour API key
actionsms_projects
countryOptional. Filter by country ID (e.g. 'us', 'gb')
[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. Obtener países de SMS

Action: sms_countries

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

3. Crear Pedido por SMS

Action: add_sms

ParameterDescriptionRequired
project_idProject ID from sms_projectsYes
quantityNumber of numbers (1-10)No (Default 1)
countryCountry code (e.g. 'us')No
phonePhone number to reuseNo
{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. Obtener código SMS

Action: sms_code

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

5. Obtener estado del pedido por SMS

Action: sms_status

{
  "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.

{"error": "Invalid API key"}
{"error": "Invalid action"}
{"error": "Service ID is required"}
{"error": "Insufficient balance"}
{"error": "Order not found"}
{"error": "Service not found"}

¿Necesitas ayuda? Contáctanos en support@hstockplus.net

Supported payment methods

Supported payment methods