Fazer solicitações

Visão geral

A API Typosquatting oferece quatro pontos de extremidade para detectar e investigar domínios de typosquatting. Todas as solicitações são feitas via HTTP GET.

1. Verificar domínio

Descubra a quais grupos de typosquatting um domínio pertence.

Cada solicitação custa 1 crédito DRS.

OBTER https://typosquatting.whoisxmlapi.com/api/v1/checkDomain?apiKey=YOUR_API_KEY&domainName=amoreresidences.com

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página " Meus produtos ".

nome de domínio

Obrigatório. O nome de domínio a ser verificado quanto à participação em grupos de typosquatting. Aceita qualquer sequência de caracteres UTF-8.

formato de saída

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

Exemplo de resultado

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "totalNoOfGrpMembers": 13
    }
]

Campos de saída

data
A data em que o grupo de typosquatting foi detectado, no formato AAAA-MM-DD.
número do grupo
O identificador do grupo de typosquatting para a data indicada.
total de membros do grupo
O número total de domínios neste grupo de typosquatting.

2. Verificar domínio (versão aprimorada)

Obtenha dados detalhados para todos os domínios em todos os grupos aos quais o domínio especificado pertence. Esta é a consulta de domínio único mais detalhada, retornando informações completas do WHOIS e detalhes de registro para cada membro do grupo.

Cada solicitação custa 5 créditos DRS.

OBTER https://typosquatting.whoisxmlapi.com/api/v1/checkDomainEnriched?apiKey=YOUR_API_KEY&domainName=iwin.exposed

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página " Meus produtos ".

nome de domínio

Obrigatório. O nome de domínio a ser verificado. Aceita qualquer sequência de caracteres UTF-8. O domínio de exemplo iwin.exposed é útil para testes, pois aparece em vários grupos.

formato de saída

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

Exemplo de resultado

Retorna uma matriz JSON de registros enriquecidos. Consulte a seção sobre campos de saída enriquecidos abaixo para obter descrições completas dos campos.

3. Entrar no grupo

Obter todos os domínios de um grupo específico de typosquatting (campos básicos).

Cada solicitação custa 5 créditos DRS.

OBTER https://typosquatting.whoisxmlapi.com/api/v1/getGroup?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página " Meus produtos ".

data

Obrigatório. A data de detecção no formato AAAA-MM-DD. Deve ser >= 01/07/2020.

número do grupo

Obrigatório. O número do grupo de typosquatting (número inteiro).

formato de saída

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

Exemplo de resultado

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 1,
        "totalNoOfGrpMembers": 13,
        "domain": "example1.com",
        "domainUtf": "example1.com"
    },
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 2,
        "totalNoOfGrpMembers": 13,
        "domain": "example2.com",
        "domainUtf": "example2.com"
    }
]

Campos de saída

data
A data em que o grupo de typosquatting foi detectado, no formato AAAA-MM-DD.
número do grupo
O identificador do grupo de typosquatting.
número de membro do grupo
A posição do membro dentro do grupo, ordenada de menor para maior.
total de membros do grupo
O número total de domínios neste grupo.
domínio
O nome de domínio (ASCII).
domainUtf
O nome de domínio na codificação UTF-8 (útil para nomes de domínio internacionalizados).

4. Obter grupo (enriquecido)

Obtenha todos os domínios de um grupo específico de typosquatting, com dados completos e detalhados do WHOIS e do registro.

Cada solicitação custa 5 créditos DRS.

OBTER https://typosquatting.whoisxmlapi.com/api/v1/getGroupEnriched?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Parâmetros de entrada

apiKey

Obrigatório. Obtenha sua chave de API pessoal na página " Meus produtos ".

data

Obrigatório. A data de detecção no formato AAAA-MM-DD. Deve ser >= 01/07/2020.

número do grupo

Obrigatório. O número do grupo de typosquatting (número inteiro).

formato de saída

Opcional. Formato de saída da resposta.

Valores aceitáveis: JSON | XML

Padrão: JSON

Exemplo de resultado

Retorna uma matriz JSON de registros enriquecidos. Consulte a seção sobre campos de saída enriquecidos abaixo para obter descrições completas dos campos.

Campos de saída com formatação avançada

Os endpoints enriquecidos (checkDomainEnriched, getGroupEnriched) retornam os seguintes campos para cada registro:

data
A data em que o grupo de typosquatting foi detectado, no formato AAAA-MM-DD.
número do grupo
O identificador do grupo de typosquatting.
número de membro do grupo
A posição do membro dentro do grupo.
total de membros do grupo
O número total de domínios neste grupo.
domínio
O nome de domínio (ASCII).
domainUtf
O nome de domínio na codificação UTF-8.
nome do registrante
O nome do registrante constante nos registros WHOIS.
organização do registrante
A organização do registrante.
país do registrante
País do registrante.
Estado de registro
O estado ou província do titular do registro.
Cidade do registrante
Cidade do titular do registro.
e-mail do registrante
O endereço de e-mail do titular do registro.
nome do registrador
O nome do registrador de domínios.
registradorIANAID
O ID IANA do registrador.
whoisServer
O servidor WHOIS do domínio.
servidores de nomes
Os servidores de nomes associados ao domínio.
status
Os códigos de status do domínio (por exemplo, clientTransferProhibited).
data de criação
A data de criação do domínio, conforme informada pelo registrador.
data de atualização
Data da última atualização do domínio, conforme informada pelo registrador.
data de validade
A data de vencimento do domínio, conforme informada pelo registrador.
standardRegCreatedDate
A data de criação do domínio padronizada no formato AAAA-MM-DD HH:MM:SS.
data de atualização da norma
A data da última atualização do domínio, no formato AAAA-MM-DD HH:MM:SS.
data de validade padrão
A data de validade padronizada do domínio no formato AAAA-MM-DD HH:MM:SS.
ips
Os endereços IP associados ao domínio.

Preços

Cada ponto de extremidade deduz um número fixo de créditos DRS por solicitação bem-sucedida:

A ativação da sua conta leva até um minuto após o cadastro.

Acesso gratuito

Após o cadastro, você recebe automaticamente um plano de assinatura gratuito limitado a 500 créditos DRS.

Limites de uso e moderação de solicitações

O número máximo de solicitações por segundo é 30. Caso esse limite seja ultrapassado, suas solicitações subsequentes serão rejeitadas até o segundo seguinte.

Essa API também está disponível com um balanceador de carga dedicado e um endpoint premium para permitir consultas mais rápidas como parte de nossos Serviços de API Premium e Pacotes de API Empresariais.