Pular para o conteúdo principal

Endpoint

GET https://api.bunny.build/api/v1/domain-availability/:domain

Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)

Visão geral

Verifique se um domínio está disponível para registro ou já foi registrado. A Bunny retorna o status de disponibilidade, registrador atual, data de registro, data de expiração e flags de status, tudo em uma única chamada de API.

Casos de uso

  • Ferramentas de busca e sugestão de domínios
  • Monitorar registros de domínios de concorrentes
  • Validar nomes de domínio fornecidos por usuários
  • Criar integrações com marketplaces de domínios

Detalhes

Suporta qualquer TLD público. Retorna available: true se nenhum registro for encontrado. O array status contém códigos de status EPP padrão ICANN (ex.: clientTransferProhibited).

Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
domainstringSimDomínio a verificar (ex.: example.com)

Resposta

200 OK

CampoTipoDescrição
domainstringO domínio verificado
availablebooleantrue se o domínio está disponível para registro
tldstringExtensão do domínio (ex.: com)
Exemplo
{
  "domain": "example.com",
  "available": false,
  "tld": "com"
}

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 domínio inválido.
{
  "detail": "Invalid domain format"
}

429 Too Many Requests

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

Exemplo cURL

curl https://api.bunny.build/api/v1/domain-availability/example.com \
  -H "X-API-Key: bun_sua_chave_api"