Realización de solicitudes | Documentación | Registrant Alert API | WhoisXML API

Realizar solicitudes

Punto final de API

POST https://registrant-alert.whoisxmlapi.com/api/v2
La activación de la cuenta tarda un minuto tras el registro.

Tenga en cuenta que los resultados de la búsqueda están limitados a 10.000 registros. Si desea obtener resultados más relevantes, intente optimizar su consulta de búsqueda o utilice la búsqueda avanzada.

Compilación Postman

Postman es una aplicación web y de escritorio que permite realizar llamadas a la API desde una interfaz gráica. Le recomendamos que utilice Postmancon los puntos finales de las API de WhoisXML cuando explore la funcionalidad de las API, así como cuando esté identificando problemas con su aplicación.

La compilación Postman de API de WhoisXML está disponible en los siguientes enlaces:

La compilación incluye un entorno preconfigurado. Tendrá que configurar la api_key para realizar cada solicitud. Obtenga su clave de API personal en la página Mis productos. Si tiene preguntas relacionadas con la API, póngase en contacto con nosotros.

Ejemplo de cuerpo de solicitud POST

{
    "apiKey": "API_KEY",
    "sinceDate": "2019-04-20",
    "mode": "purchase",
    "punycode": true,
    "basicSearchTerms":
    {
        "include": [
            "Airbnb",
            "US"
        ],
        "exclude": [
            "Europe",
            "EU"
        ]
    }
}

Puede proporcionar hasta cuatro términos de búsqueda de inclusión y exclusión en una misma solicitud. Con varios términos de búsqueda de inclusión/exclusión, el resultado incluye los dominios que tienen todos los términos de inclusión y ninguno de los términos de exclusión.

La salida incluye dominios añadidos o eliminados por registrantes que tengan los términos en cualquiera de los siguientes campos:

Campos de contacto del registrante

RegistrantContact.City, RegistrantContact.Country, RegistrantContact.Email, RegistrantContact.Fax, RegistrantContact.FaxExtension, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.PostalCode, RegistrantContact.State, RegistrantContact.StreetAddress, RegistrantContact.Telephone, RegistrantContact.TelephoneExtension

Cabeceras

X-Authentication-Token

Puede utilizar esta cabecera o el parámetro apiKey para las llamadas a la API.

Obtenga su CLAVE API personal en la página Mis productos.

Parámetros de entrada

apiKey

Es necesario. Obtenga su clave API personal en la página Mis productos.

basicSearchTerms.include

Obligatorio. Matriz de cadenas de búsqueda. Todas ellas deben estar presentes en los detalles del registrante del dominio. Máximo 4 elementos. No distingue mayúsculas de minúsculas.

basicSearchTerms.exclude

Opcional. Matriz de cadenas de búsqueda. Todas NO deben estar presentes en los detalles del registrante del dominio. Máximo 4 elementos. No distingue entre mayúsculas y minúsculas.

sinceDate

Opcional. Fecha en formato "AAAA-MM-DD".

Las fechas permitidas están en el intervalo [Hoy menos 14 días - Hoy].

La fecha de ayer por defecto.

Tenga en cuenta que los resultados de ayer suelen estar disponibles entre las 10 y las 12 de la mañana UTC.

Si está presente, busca entre las actividades descubiertas desde la fecha dada. A veces hay una latencia entre la fecha real de adición/renovación/expiración y la fecha en que nuestro sistema detectó este cambio. Le recomendamos que utilice este campo en sus herramientas de supervisión para filtrar los cambios.

modo

Opcional.

preview - devuelve solo el número de dominios. No se deducen créditos.

purchase - devuelve la lista real de dominios (limitada a 10.000). 1 solicitud cuesta 10 créditos DRS.

Valores aceptables: preview | purchase

Default: preview

punycode

Opcional. Si es verdadero, los nombres de dominio de la respuesta se codificarán en Punycode.

Valores aceptables: false | true

Por defecto: true

responseFormat

Opcional. Formato de salida de la respuesta.

Valores aceptables: json | xml

Por defecto: json

createdDateFrom

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios creados después de la fecha dada.

createdDateTo

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios creados antes de la fecha dada.

updatedDateFrom

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios creados después de la fecha dada.

updatedDateTo

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios actualizados antes de la fecha dada.

expiredDateFrom

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios expirados después de la fecha dada.

expiredDateTo

Opcional. Fecha en formato "AAAA-MM-DD".

Si está presente, busca entre los dominios expirados antes de la fecha dada.

Acceso gratuito

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

Límites de uso y de velocidad de solicitudes

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

Esta API también está disponible con un equilibrador de carga dedicado y un punto final premium para permitir consultas más rápidas como parte de nuestros Servicios API Premium y Paquetes API de Empresa.

Documentos de la API de búsqueda avanzada

La búsqueda avanzada permite buscar a través de campos WHOIS concretos.