Realizar solicitudes

Resumen

La API de Typosquatting ofrece cuatro puntos de conexión para detectar e investigar dominios de typosquatting. Todas las solicitudes se realizan mediante HTTP GET.

1. Compruebe el dominio

Identifique los grupos de typosquatting a los que pertenece un dominio.

Cada solicitud cuesta 1 crédito DRS.

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

Parámetros de entrada

apiKey

Es obligatorio. Obtenga su clave API personal en la página «Mis productos ».

nombre de dominio

Obligatorio. El nombre de dominio que se va a comprobar para detectar si forma parte de un grupo de typosquatting. Admite cualquier cadena en formato UTF-8.

formato de salida

Opcional. Formato de salida de la respuesta.

Valores válidos: JSON | XML

Predeterminado: JSON

Ejemplo de resultado

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

Campos de salida

fecha
La fecha en la que se detectó el grupo de typosquatting, en formato AAAA-MM-DD.
número de grupo
El identificador del grupo de typosquatting correspondiente a la fecha indicada.
número total de miembros del grupo
El número total de dominios de este grupo de typosquatting.

2. Comprobar el dominio (enriquecido)

Obtenga datos ampliados sobre todos los dominios de todos los grupos a los que pertenece el dominio indicado. Se trata de la consulta de dominio único más detallada, que proporciona los datos completos de WHOIS y de registro de cada miembro del grupo.

Cada solicitud cuesta 5 créditos DRS.

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

Parámetros de entrada

apiKey

Es obligatorio. Obtenga su clave API personal en la página «Mis productos ».

nombre de dominio

Obligatorio. El nombre de dominio que se va a comprobar. Admite cualquier cadena en UTF-8. El dominio de ejemplo «iwin.exposed» resulta útil para realizar pruebas, ya que aparece en varios grupos.

formato de salida

Opcional. Formato de salida de la respuesta.

Valores válidos: JSON | XML

Predeterminado: JSON

Ejemplo de resultado

Devuelve una matriz JSON de registros enriquecidos. Consulte la sección sobre campos de salida enriquecidos que figura a continuación para obtener descripciones completas de los campos.

3. Únase al grupo

Obtenga todos los dominios de un grupo específico de typosquatting (campos básicos).

Cada solicitud cuesta 5 créditos DRS.

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

Parámetros de entrada

apiKey

Es obligatorio. Obtenga su clave API personal en la página «Mis productos ».

fecha

Obligatorio. La fecha de detección en formato AAAA-MM-DD. Debe ser >= 01-07-2020.

número de grupo

Obligatorio. El número del grupo de typosquatting (entero).

formato de salida

Opcional. Formato de salida de la respuesta.

Valores válidos: JSON | XML

Predeterminado: JSON

Ejemplo 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 salida

fecha
La fecha en la que se detectó el grupo de typosquatting, en formato AAAA-MM-DD.
número de grupo
El identificador del grupo de typosquatting.
Número de miembro del grupo
La posición del miembro dentro del grupo, ordenada de menor a mayor.
número total de miembros del grupo
El número total de dominios de este grupo.
dominio
El nombre de dominio (ASCII).
domainUtf
El nombre de dominio en codificación UTF-8 (útil para nombres de dominio internacionalizados).

4. Obtener grupo (enriquecido)

Obtenga todos los dominios de un grupo específico de typosquatting con datos completos y detallados de WHOIS y de registro.

Cada solicitud cuesta 5 créditos DRS.

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

Parámetros de entrada

apiKey

Es obligatorio. Obtenga su clave API personal en la página «Mis productos ».

fecha

Obligatorio. La fecha de detección en formato AAAA-MM-DD. Debe ser >= 01-07-2020.

número de grupo

Obligatorio. El número del grupo de typosquatting (entero).

formato de salida

Opcional. Formato de salida de la respuesta.

Valores válidos: JSON | XML

Predeterminado: JSON

Ejemplo de resultado

Devuelve una matriz JSON de registros enriquecidos. Consulte la sección sobre campos de salida enriquecidos que figura a continuación para obtener descripciones completas de los campos.

Campos de salida enriquecidos

Los métodos enriquecidos (checkDomainEnriched, getGroupEnriched) devuelven los siguientes campos para cada registro:

fecha
La fecha en la que se detectó el grupo de typosquatting, en formato AAAA-MM-DD.
número de grupo
El identificador del grupo de typosquatting.
Número de miembro del grupo
La posición del miembro dentro del grupo.
número total de miembros del grupo
El número total de dominios de este grupo.
dominio
El nombre de dominio (ASCII).
domainUtf
El nombre de dominio en codificación UTF-8.
nombre del titular
El nombre del titular que figura en los registros WHOIS.
organización del solicitante
La organización del solicitante.
país del titular del registro
El país del titular del registro.
Estado de registro
El estado o provincia del solicitante.
ciudad del titular del registro
La ciudad del solicitante.
correo electrónico del solicitante
La dirección de correo electrónico del titular del registro.
nombre del registrador
El nombre del registrador de dominios.
registrarIANAID
El identificador IANA del registrador.
whoisServer
El servidor WHOIS del dominio.
servidores de nombres
Los servidores de nombres asociados al dominio.
estado
Los códigos de estado del dominio (por ejemplo, «clientTransferProhibited»).
fecha de creación
La fecha de creación del dominio según la información facilitada por el registrador.
fecha de actualización
La fecha de la última actualización del dominio, según la información facilitada por el registrador.
fecha de caducidad
La fecha de vencimiento del dominio según la información facilitada por el registrador.
standardRegCreatedDate
La fecha de creación del dominio, estandarizada en el formato AAAA-MM-DD HH:MM:SS.
fecha de actualización de la norma
La fecha de última actualización del dominio, estandarizada en el formato AAAA-MM-DD HH:MM:SS.
fecha de caducidad estándar
La fecha de caducidad estandarizada del dominio en formato AAAA-MM-DD HH:MM:SS.
ips
Las direcciones IP asociadas al dominio.

Precios

Cada punto final deduce un número fijo de créditos DRS por cada solicitud aceptada:

La activación de su cuenta tarda hasta un minuto tras el registro.

Acceso gratuito

Tras registrarse, obtendrá automáticamente un plan de suscripción gratuito limitado a 500 créditos DRS.

Límites de uso y limitación de solicitudes

El número máximo de solicitudes por segundo es de 30. En caso de que se supere dicho límite, sus solicitudes posteriores serán rechazadas hasta el segundo siguiente.

Esta API también está disponible con un equilibrador de carga específico y un punto de conexión premium para permitir consultas más rápidas, como parte de nuestros servicios de API Premium y paquetes de API Enterprise.