Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/url-checker

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Verifique se qualquer URL está acessível e inspecione sua resposta em tempo real. O URL Checker da Bunny segue redirecionamentos, mede o tempo de resposta, extrai o título da página e retorna a URL final, dando uma visão completa da saúde do link.

​
Casos de uso

  • Validar URLs antes de armazená-las em um banco de dados
  • Monitorar links externos em conteúdo de CMS
  • Criar verificadores de links quebrados para websites
  • Verificar cadeias de redirecionamento para auditorias de SEO

​
Detalhes

Segue até 10 saltos de redirecionamento. final_url contém a URL após todos os redirecionamentos. response_time_ms é medido a partir do primeiro byte. URLs que expiram após 10 segundos são retornadas com reachable: false.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
urlstringSimA URL a verificar (deve incluir o esquema, ex.: https://)

​
Exemplo

{
  "url": "https://example.com"
}

​
Resposta

​
200 OK

CampoTipoDescrição
urlstringA URL verificada
reachablebooleantrue se a URL respondeu com sucesso
status_codeint | nullCódigo de status HTTP retornado pela URL
safebooleantrue se a URL não está marcada como maliciosa
redirects_tostring | nullURL final após redirecionamentos (se houver)
Exemplo 
{
  "url": "https://example.com",
  "reachable": true,
  "status_code": 200,
  "safe": true,
  "redirects_to": null
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

Formato de URL inválido. 
{
  "detail": "Invalid URL format"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/url-checker \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'