API

Início rápido

Todas as requisições são feitas via POST, aceitando application/x-www-form-urlencoded (form-data) ou application/json no corpo — escolha o formato que preferir. As respostas são sempre em JSON.

Método POST
URL da API
https://hipergram.com.br/api/v2
Sua Chave (key) Faça login para acessar sua chave
Resposta JSON

Listar Serviços

Retorna todos os serviços disponíveis para sua conta, com preço, tipo e limites de quantidade.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser services
Resposta
[
    {
        "service": 1,
        "name": "Seguidores",
        "type": "Default",
        "category": "Primeira Categoria",
        "rate": "0.90",
        "min": "50",
        "max": "10000"
    },
    {
        "service": 2,
        "name": "Comentários",
        "type": "Custom Comments",
        "category": "Segunda Categoria",
        "rate": "8",
        "min": "10",
        "max": "1500"
    }
]

Novo Pedido — Padrão

Para serviços do tipo Default ou Package (link + quantidade). Em serviços do tipo Pacote a quantidade já é fixa, então quantity pode ser omitido.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser add
serviceobrigatórioID do serviço
linkobrigatórioURL ou nome de usuário do perfil/post
quantityobrigatórioQuantidade desejada (não se aplica a serviços do tipo Pacote)
runsopcionalNúmero de execuções (drip-feed)
intervalopcionalIntervalo em minutos entre execuções (drip-feed)
Resposta
{
    "order": 23501
}

Novo Pedido — Comentários Personalizados

Para serviços do tipo Custom Comments. A quantity é calculada automaticamente com base no número de linhas em comments.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser add
serviceobrigatórioID do serviço
linkobrigatórioURL do post
commentsobrigatórioLista de comentários, um por linha
Resposta
{
    "order": 23502
}

Novo Pedido — Assinaturas

Para serviços do tipo Subscriptions (curtidas/visualizações automáticas por perfil).

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser add
serviceobrigatórioID do serviço
usernameobrigatórioNome de usuário do perfil
minobrigatórioQuantidade mínima por post
maxobrigatórioQuantidade máxima por post
postsobrigatórioNúmero de posts a cobrir
delayopcionalAtraso em minutos entre posts
expiryopcionalData de expiração (ex.: 2026-12-31)
Resposta
{
    "order": 23503
}

Novo Pedido — Postagem Automática

Para serviços de postagem automática, que entregam em novos posts do perfil sem que você precise enviar quantidade, prazo ou intervalo — esses valores já vêm configurados no serviço.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser add
serviceobrigatórioID do serviço
linkobrigatórioURL ou nome de usuário do perfil
Resposta
{
    "order": 23504
}

Status do Pedido

Consulta o status de um pedido específico feito através da API.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser status
orderobrigatórioID do pedido
Resposta
// Pedido padrão
{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "BRL"
}

// Pedido com drip-feed
{
    "status": "Active",
    "runs": "5"
}

// Pedido do tipo assinatura
{
    "status": "Active",
    "posts": "10"
}

Saldo da Conta

Retorna o saldo atual disponível na sua conta.

ParâmetroObrigatórioDescrição
keyobrigatórioSua chave de API
actionobrigatórioDeve ser balance
Resposta
{
    "balance": "100.84292",
    "currency": "BRL"
}

Códigos de Erro

Sempre que algo dá errado, a resposta traz error (mensagem) e status (código) — use o código abaixo para tratar cada caso no seu sistema.

101Dados incompletos (faltando key ou action)
102Chave de API inválida
103Conta inativa
104Pedido não encontrado
105Serviço desativado ou indisponível
107Campos obrigatórios não preenchidos
108Quantidade abaixo do mínimo permitido
109Quantidade acima do máximo permitido
110Quantidade mínima maior que a máxima (serviços de assinatura)
111Quantidade mínima abaixo do permitido pelo serviço
112Quantidade máxima acima do permitido pelo serviço
113Saldo insuficiente, ou já existe um pedido pendente para este link
114Perfil do Instagram é privado, ou erro ao processar o pedido

Exemplo de Código

  Ver exemplo em PHP