Documentação da API

A sua chave de API

Testar API

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

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

Endpoint da API

Todas as solicitações de 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 category e subcategory em serviços/produtos sempre usam nomes canônicos em inglês, mesmo quando lang está definido.

curl -X POST https://hstockplus.net/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 Solicitação:

curl -X POST https://hstockplus.net/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 Solicitação:

curl -X POST https://hstockplus.net/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://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

Lista de Lojas

Listar lojas ativas com informações básicas, quantidade de produtos e avaliações. Os nomes das lojas estão ocultos por questões de privacidade.

Exemplo de Solicitação:

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

Com paginação:

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

Lista de cupões

Lista todos os códigos de cupão das lojas que podem ser usados neste momento, com as condições de cada um. Passe um código como coupon a action=add. Os códigos feitos apenas para a sua conta (por exemplo, um orçamento para compra em grande quantidade a partir de um ticket) estão incluídos e marcados como private.

Exemplo de Solicitação:

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

Exemplo de Resposta:

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

Um cupão é descontado ao valor que resta depois do desconto de revendedor. Os campos opcionais são omitidos quando o cupão não tem essa condição.

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 os produtos especificados (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 100). O campo opcional sort=sold ordena os resultados pelas unidades de pedido pagas em ordem decrescente (mais vendidos primeiro).

Exemplo de Solicitação:

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

Filtrar por IDs de produto:

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

Com paginação:

curl -X POST https://hstockplus.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

Mais vendidos em uma subcategoria:

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

Apenas produtos recomendados:

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

Lista de Serviços

Obtenha todos os serviços disponíveis com paginação opcional. Cada linha inclui id (ID da entidade), service (número amigável do serviço), stock e entityType (smm ou product). O parâmetro opcional entityType retorna apenas linhas de product ou apenas de smm. Os parâmetros opcionais category e subcategory retornam apenas serviços daquela categoria ou subcategoria (valores da API Get Categories). O parâmetro opcional shopId retorna apenas produtos e serviços daquela loja (use shopId da Shops List). O parâmetro opcional productIds retorna apenas as linhas correspondentes (números amigáveis de serviço e/ou IDs de entidade; corresponde a linhas de product ou smm). Use action=products para filtrar apenas produtos.

Exemplo de Solicitação:

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

Com paginação:

curl -X POST https://hstockplus.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Filtrar por tipo de entidade:

curl -X POST https://hstockplus.net/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://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Cada linha inclui id (id da entidade) e service (número amigável do serviço para pedidos), stock, entityType (smm ou product) e autoDelivery. As 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 igual ao total.

As linhas de produtos incluem também os valores mostrados na página do produto: service é o número do produto (#48071 na página), sellerRating e sellerReviewCount são a classificação por estrelas do vendedor e o número de avaliações, returningBuyerRate é a percentagem de compradores recorrentes do vendedor (0.52 = 52%), sold é o número de unidades vendidas e warrantyHours é o período de pós-venda em horas contado a partir da entrega (0 = sem pós-venda). sellerRating, sellerReviewCount e returningBuyerRate são omitidos quando o vendedor não tem classificação ou tem poucos compradores.

Verificar Estoque

Obtém o estoque atual e a disponibilidade de um serviço pelo seu ID (o mesmo ID da lista de serviços). Nos produtos do marketplace, o JSON inclui subproducts: um array de variantes ativas, cada uma com subproductId, name, stock (estoque apresentado dessa variante) e o seu próprio preço e limites de encomenda: available, rate, min, max e packs nas opções vendidas em packs fixos.

Exemplo de Solicitação:

curl -X POST https://hstockplus.net/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, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

A resposta inclui taxa (por unidade, mesmo formato de string da lista de serviços), entityType (smm ou product) e autoDelivery (true = entrega automática, false = fornecedor realiza 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 de subprodutos lista cada variante ativa com estoque exibido; respostas de inventário SMM omitem subprodutos.

Cada subproduto tem a sua própria rate, min e max: são o preço unitário e o intervalo de quantidades que a adição cobra quando indica esse subproductId, antes de qualquer desconto de revendedor na sua conta. Nas opções vendidas em packs fixos, packs lista cada pack em estoque (quantity, total price, discountPercent) e tem de encomendar uma dessas quantidades; rate, min e max descrevem então o menor pack.

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

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. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

Exemplo de Solicitação:

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

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

Exemplo de Resposta:

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

Status do Pedido

Obter o status de um pedido.

Exemplo de Solicitação:

curl -X POST https://hstockplus.net/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 entrega parcial, apenas as contas entregues até o momento são retornadas.

autoDelivery: true se o pedido for atendido automaticamente (ex.: SMM, produtos automáticos/de estoque); 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"
  ]
}

Possíveis Status:

Uma encomenda reembolsada devolve Canceled e uma encomenda parcialmente reembolsada devolve Partial. Quando foi reembolsado algum valor, a resposta inclui também "refunded" com o montante reembolsado em USD.

Exemplo de resposta (encomenda de produto entregue em ficheiros):

Alguns produtos (por exemplo, contas Telegram com ficheiros de sessão) são entregues em ficheiros ZIP em vez de, ou além de, credenciais em texto. A resposta inclui então um array "files". Cada ficheiro é um item entregue. Transfira um ficheiro com action=order_file.

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

Transferir ficheiro da encomenda

Transfere um ficheiro de entrega (ZIP) da sua encomenda. Em caso de sucesso, o corpo da resposta é o próprio ficheiro (Content-Type: application/zip); em caso de falha, é JSON com um campo "error".

Exemplo de Solicitação:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

Exemplo de resposta de erro:

{
  "error": "File not found"
}

Verifique o cabeçalho Content-Type antes de guardar: application/zip significa que é o ficheiro, application/json significa um erro.

Criar cancelamento

Cancelar um ou mais pedidos (formato de lote compatível com PerfectPanel). Cada pedido elegível é reembolsado em seu saldo.

Todas as condições a seguir devem ser verdadeiras. Use allowcancel para verificar a elegibilidade sem processar um reembolso.

• Cancelamento antecipado: recurso da plataforma ativado (configuração de administrador).
• Cancelamento antecipado: productType é manual, auto ou inventory (os serviços SMM auto geralmente usam productType auto).
• Cancelamento antecipado: status do pagamento é completed ou partial.
• Cancelamento antecipado: status do pedido é pending, processing ou error (erros do provedor aparecem como in progress).
• Cancelamento antecipado: sem external_id (pedido ainda não enviado a um fornecedor ou provedor externo).
• Cancelamento antecipado: pelo menos N minutos desde a conclusão do pagamento (auto_order_early_refund_minutes, padrão 30).
• Cancelamento antecipado: o cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: o pedido não foi totalmente entregue (entrega parcial gera um reembolso proporcional pela parte não entregue).
• Cancelamento antecipado: valor reembolsável restante (refundedAmount é menor que o total do pedido).
• Cancelamento antecipado: sem disputa ativa no pedido.
• Cancelamento antecipado: sem retirada do fornecedor nos status requested ou completed.

Entrega parcial gera um reembolso parcial proporcional; as contas entregues são mantidas.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Permitir cancelamento

Verificar se um ou mais pedidos podem ser cancelados agora (mesmas regras de elegibilidade do cancelamento, mas nenhum reembolso é processado). Use antes de chamar o cancelamento para evitar solicitações com falha. Suporta IDs de pedidos em lote (separados por vírgula, até 100).

Todas as condições a seguir devem ser verdadeiras. Use allowcancel para verificar a elegibilidade sem processar um reembolso.

• Cancelamento antecipado: recurso da plataforma ativado (configuração de administrador).
• Cancelamento antecipado: productType é manual, auto ou inventory (os serviços SMM auto geralmente usam productType auto).
• Cancelamento antecipado: status do pagamento é completed ou partial.
• Cancelamento antecipado: status do pedido é pending, processing ou error (erros do provedor aparecem como in progress).
• Cancelamento antecipado: sem external_id (pedido ainda não enviado a um fornecedor ou provedor externo).
• Cancelamento antecipado: pelo menos N minutos desde a conclusão do pagamento (auto_order_early_refund_minutes, padrão 30).
• Cancelamento antecipado: o cliente já não usou o auto-reembolso antecipado neste pedido.
• Cancelamento antecipado: o pedido não foi totalmente entregue (entrega parcial gera um reembolso proporcional pela parte não entregue).
• Cancelamento antecipado: valor reembolsável restante (refundedAmount é menor que o total do pedido).
• Cancelamento antecipado: sem disputa ativa no pedido.
• Cancelamento antecipado: sem retirada do fornecedor nos status requested ou completed.

Quando allowcancel é 1, a resposta inclui refundAmount (o valor que o cancelamento reembolsaria).

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

Obtenha o seu saldo atual.

Exemplo de Solicitação:

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

Exemplo de Resposta:

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

API de verificação por SMS

Endpoints dedicados para serviços de verificação por SMS.

As encomendas de SMS têm os seus próprios IDs. Use sms_code, sms_status e sms_cancel com eles; status, cancel e allowcancel destinam-se apenas a encomendas de produtos e SMM.

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

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

Respostas de Erro

Respostas de erro comuns que você pode encontrar.