POST AI agent ready /v1/redirect/trace

API Redirect Trace - Siga cadeias de redirecionamento HTTP com tempo

Envia uma solicitação HEAD para um URL e segue cada salto de redirecionamento até que o destino final ou o limite máximo de saltos seja atingido. Retorna o URL original, o URL final, a contagem total de redirecionamentos, o tempo total e uma matriz de saltos com URL, código de status, latência, cabeçalho do servidor, cabeçalho do local e tipo de conteúdo.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/redirect/trace \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bit.ly/example"}'

When to use this API

Auditoria de redirecionamento de SEO

Rastreie os URLs do seu site por meio deste endpoint para encontrar cadeias de redirecionamento com mais de um salto. O Google recomenda redirecionamentos diretos; cadeias de 301s diluem o valor do link e tornam a indexação de páginas lenta.

Depuração de encurtador de URL

Cole um URL abreviado e veja cada salto da cadeia. Identifique qual serviço de redirecionamento está envolvido, se ele usa redirecionamentos 301 (permanentes) ou 302 (temporários) e onde chega o destino final.

Análise da cadeia de elos de marketing

Rastreie URLs de campanha por meio de wrappers UTM, rastreadores afiliados e redirecionamentos de CDN. Meça a latência que cada salto adiciona e identifique oportunidades para encurtar a cadeia.

Frequently asked questions

Quantos redirecionamentos ele segue?

O endpoint segue até 10 saltos de redirecionamento. Se a cadeia exceder 10 saltos, ela para e retorna os saltos coletados até o momento com um sinalizador indicando que a cadeia foi truncada.

Ele segue redirecionamentos de JavaScript?

Não. O endpoint segue redirecionamentos no nível HTTP (301, 302, 303, 307, 308). Redirecionamentos baseados em JavaScript (window.location) ou metatags de atualização não são detectados.

Qual é a diferença entre isso e /v1/link/expand?

O endpoint /v1/link/expand retorna apenas o URL de destino final. Este endpoint retorna a cadeia completa com cada salto intermediário, códigos de status, tempo e cabeçalhos de servidor.

Ele envia solicitações GET ou HEAD?

Ele envia solicitações HEAD para minimizar a largura de banda e evitar o desencadeamento de efeitos colaterais no servidor de destino. O salto final também usa uma solicitação HEAD, portanto content_type está disponível, mas o corpo da resposta não é obtido.

Posso rastrear redirecionamentos para endpoints POST?

Não. Este endpoint rastreia apenas cadeias de redirecionamento GET/HEAD. Os redirecionamentos POST seguem semânticas HTTP diferentes (303 vs 307) e não são suportados.

Get your API key

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