POST AI agent ready /v1/short-url/stats

API de estatísticas de URL curta - Análise de cliques grátis

Envie o slug de um URL encurtado e receba sua contagem de cliques, URL original e carimbo de data/hora de criação. Use isso para rastrear o envolvimento em links criados por meio do endpoint /v1/short-url/create. As estatísticas são atualizadas em tempo real conforme os usuários clicam no link curto.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/short-url/stats \
  -H "Content-Type: application/json" \
  -d '{"slug":"getting-started"}'

When to use this API

Acompanhe o desempenho do link da campanha em seu painel de administração

Pesquise o endpoint de estatísticas para cada link de campanha e exiba contagens de cliques junto com os dados de conversão. Isso dá à sua equipe de marketing uma visão clara de quais canais geram tráfego.

Acione a automação quando um link atingir um limite de cliques

Verifique a contagem de cliques periodicamente. Quando um link ultrapassa um limite (por exemplo, 1.000 cliques), acione uma notificação, gire o link ou atualize um placar.

Crie uma página de relatórios para links compartilhados

Mostre aos criadores de links quantos cliques seus URLs curtos receberam. Exiba o URL original, a data de criação e o total de cliques em uma visualização analítica simples.

Frequently asked questions

As contagens de cliques são atualizadas em tempo real?

Sim. O contador aumenta a cada redirecionamento. Pode haver um atraso de menos de um segundo devido à eventual consistência no armazenamento de valores-chave, mas para fins práticos é instantâneo.

Posso redefinir o contador de cliques?

Não. Não há endpoint para redefinir contagens de cliques. Se você precisar de um contador novo, crie um novo link curto com um slug diferente.

O que acontece se o slug não existir?

A API retorna um erro 404 com o código NOT_FOUND. Verifique novamente a ortografia do slug ou crie um novo link curto.

O endpoint de estatísticas conta o tráfego de bots separadamente?

Não. O contador de cliques rastreia todas as solicitações de redirecionamento, incluindo bots, rastreadores e buscadores de visualização. Filtre o tráfego de bots do seu lado, se necessário.

Posso obter estatísticas de links criados por outros usuários?

Sim. As estatísticas são acessíveis a qualquer pessoa que conheça a lesma. Não há propriedade ou controle de acesso em links curtos individuais.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.