ForHosting KIT · Ferramentas para dev

Cliques do link encurtado

A consulta de estatísticas de link encurtado devolve, por chamada de API, os números de um link curto: quantos cliques ele recebeu e como eles se distribuem no tempo. É a peça que faltava para quem dispara links em SMS, WhatsApp ou e-mail e precisa provar resultado.

● Estávelpor linkUS$ 0,002

Executar — US$ 0,002 Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Rode online

Rode nos nossos servidores com a sua conta. As ferramentas grátis rodam no seu navegador; esta aqui é descontada do seu saldo do KIT pelo preço acima.

O que a consulta devolve

Para cada link curto criado por aqui, a API devolve os números que interessam: o total de cliques e a distribuição deles ao longo do tempo. Você faz uma chamada com o identificador do link e recebe o retrato daquele momento, em JSON, pronto para cair em planilha, painel ou relatório. Consultou de novo amanhã? Novo retrato, com os cliques que chegaram no meio do caminho.

Campanha sem número é opinião

Quem dispara links por SMS, WhatsApp ou e-mail costuma medir sucesso “no feeling” — o cliente respondeu, então funcionou. As estatísticas de clique trocam essa impressão por dado: quantas pessoas abriram, em que dia a campanha rendeu, quando o interesse esfriou. Com dois links diferentes para o mesmo destino, um por canal, você descobre em uma semana qual canal merece o orçamento.

Integração de dez linhas

A consulta é uma chamada HTTP simples: envia o identificador do link, recebe JSON. Dez linhas de código bastam para puxar as estatísticas de todos os links de uma campanha e gravar numa planilha. Agências fazem isso uma vez por mês, na véspera do relatório do cliente; times de produto plugam a consulta direto no painel interno e acompanham em ritmo diário.

Preço por consulta

Cada link consultado custa US$ 0,002. O relatório mensal de uma campanha com 200 links sai por US$ 0,40 — menos que um cafezinho, e sem assinatura de plataforma de analytics. Como a cobrança é por uso, consultar pouco custa quase nada e consultar muito continua barato. Não existe mensalidade nem franquia mínima: o ritmo de consulta é decisão sua, mês a mês, com pagamento via PayPal.

Casos de uso

Qual link de bio rende mais

Márcia Regina Oliveira, social media em Recife, usa dois links curtos para a mesma página — um no Instagram, outro no TikTok. No fim do mês, a consulta mostra qual rede realmente leva gente para a loja.

Relatório mensal de agência

Uma agência de São Paulo administra 200 links de campanhas de clientes. Um script roda no dia 30, consulta tudo via API e monta o relatório com a evolução de cliques — trabalho que antes tomava uma tarde inteira.

O canal de rastreio que ninguém abria

A Distribuidora Horizonte Verde S.A. descobriu, consultando as estatísticas, que quase ninguém clicava no link de rastreio enviado por e-mail — e que o mesmo link por SMS era aberto no dia. O canal mudou, e a central do “cadê meu pedido” esvaziou.

Perguntas frequentes

Funciona com link do Bitly ou de outro encurtador?

Não — a consulta cobre os links curtos criados pelo próprio serviço de encurtamento daqui. É o par natural: um cria, o outro mede.

Os números são em tempo real?

Cada consulta devolve os cliques registrados até aquele momento. Consultou às 9h e de novo às 15h? A diferença entre as duas respostas é a manhã da sua campanha.

Vocês identificam quem clicou, com nome ou telefone?

Não. As estatísticas trabalham com contagem de acessos, não com identificação de pessoas — o que também simplifica a sua vida com a LGPD na hora de usar os números em relatório.

Como é cobrado?

US$ 0,002 por link consultado, a cada consulta. Puxar 50 links uma vez por semana custa US$ 0,40 ao mês, pagos por uso via PayPal, sem plano.

Consigo consultar vários links de uma vez?

A cobrança é por link consultado, então o custo é o mesmo consultando um a um ou em série num script. Estruture do jeito mais simples para o seu código.

Preciso ter conta para acessar as estatísticas?

Não há cadastro: a compra é direta e o uso é via API. Quem criou o link é quem tem o identificador para consultá-lo.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/dev/short-url-stats

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/dev/short-url-stats \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/short-url-stats", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/dev/short-url-stats",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/short-url-stats", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/short-url-stats", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "dev.short_url_stats",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →