Sua Chave API

Testar API

Selecione uma ação, preencha os parâmetros e envie uma solicitação. Quando estiver logado, sua chave de API é carregada automaticamente.

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

Endpoint da API

Todas as requisições da API devem ser enviadas via HTTP POST para este endpoint.

Idioma opcional (lang)

Opcional. Código do idioma de destino. Use um dos códigos suportados listados abaixo. Quando definido e diferente de en, os campos traduzíveis são retornados nesse idioma. Se uma tradução ainda não estiver disponível, a API retorna em inglês.

Suportado em ações de leitura: categories, subcategory_info, services, products, inventory ((nomes de subprodutos)), sms_projects, e sms_countries. Omita lang ou use en para inglês.

Os parâmetros de filtro de categoria e subcategoria em serviços/produtos sempre usam nomes canônicos em inglês, mesmo quando lang está definido.

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

Obter Categorias

Obtenha todas as categorias e as subcategorias de cada categoria. Use esses valores para filtrar a Lista de Serviços por categoria ou subcategoria.

Exemplo de Requisição:

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

Exemplo de Resposta:

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

Informações da Subcategoria

Obter detalhes da subcategoria pelo subcategoryId, incluindo a categoria pai. Use o subcategoryId das linhas da Lista de Produtos.

Exemplo de Requisição:

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

Exemplo de Resposta:

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

Lista lojas ativas com informações básicas, contagem de produtos e avaliações. Os nomes das lojas são mascarados por privacidade.

Exemplo de Requisição:

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

Com paginação:

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

Lista de Produtos

Listar apenas produtos do marketplace (sem serviços SMM). Mesmos campos das linhas de produtos na Lista de Serviços, incluindo id (id da entidade do produto), service (número amigável do serviço), description e imageUrl. O campo opcional productIds retorna apenas esses produtos (números amigáveis de serviço da lista e/ou ids de entidade do produto, separados por vírgula ou array JSON, máximo de 100).

Exemplo de Requisição:

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

Filtrar por IDs de produto:

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

Com paginação:

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

Filtrar por categoria ou subcategoria:

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"

Apenas produtos recomendados:

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

Lista de Serviços

Obter todos os serviços disponíveis com paginação opcional. Cada linha inclui id (ID da entidade), serviço (número amigável do serviço), estoque e entityType (smm ou product). O entityType opcional retorna apenas linhas de produto ou apenas de smm. Os parâmetros opcionais de categoria e subcategoria retornam apenas serviços nessa categoria ou subcategoria (valores da API Get Categories). O shopId opcional retorna apenas produtos e serviços para essa loja (use o shopId da Lista de Lojas). O productIds opcional retorna apenas produtos de marketplace correspondentes (serviços SMM são omitidos quando productIds é definido).

Exemplo de Requisição:

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

Com paginação:

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

Filtrar por categoria ou subcategoria:

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 entidade:

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

Exemplo de Resposta:

{
  "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 linha inclui id (id da entidade) e service (número de serviço amigável para pedidos), stock, entityType (smm ou product) e autoDelivery. Linhas de produto também incluem description, imageUrl, isRecommended e subcategoryId. Quando limit é 0 ou omitido, todos os serviços são retornados e page/limit igualam o total.

Verificar Estoque

Obtenha o estoque atual e a disponibilidade de um serviço pelo seu ID (mesmo ID da lista de serviços). Para produtos de marketplace, o JSON inclui subproducts: uma matriz de variantes ativas, cada uma com subproductId, nome e stock (estoque exibido para essa variante).

Exemplo de Requisição:

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

Exemplo de Resposta (SMM):

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

Exemplo de Resposta (produto):

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

A resposta inclui rate (por unidade, mesmo formato de string da lista de serviços), entityType (smm ou product) e autoDelivery (true = entrega automática, false = fornecedor atende manualmente). Para serviços de produto, min e max correspondem à linha do subproduto principal na lista de serviços; se esse subproduto não puder atender ao seu pedido de adição, a plataforma pode selecionar outro subproduto e cobrar seu preço unitário. A matriz subproducts lista todas as variantes ativas com estoque exibido; respostas de inventário SMM omitem 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.

Exemplo de Requisição:

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"

Exemplo de Resposta:

{
  "order": 23501
}

Status do Pedido

Obtenha o status de um pedido.

Exemplo de Requisição:

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

Exemplo de Resposta:

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

Para pedidos de produtos (ex.: contas), quando o pedido é entregue total ou parcialmente, a resposta inclui um array "accounts" com as credenciais das contas entregues (uma string por conta). Para entregas parciais, apenas as contas entregues até o momento são retornadas.

autoDelivery: true se o pedido for atendido automaticamente (ex.: SMM, produtos automáticos/de inventário); false se o fornecedor precisar atender manualmente (pode levar algum tempo).

Exemplo de Resposta (pedido de produto com contas entregues):

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

Status Possíveis:

Saldo

Obtenha seu saldo atual.

Exemplo de Requisição:

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

Exemplo de Resposta:

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

SMS Verification API

Endpoints dedicados para serviços de verificação 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"
}

Respostas de Erro

Respostas de erro comuns que você pode encontrar.