Documentación API avanzada | Documentación | Reverse WHOIS API | WhoisXML API

Realizar solicitudes

Punto final de API

POST https://reverse-whois.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 más resultados 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",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES",
        "exclude": true
    }]
}

La búsqueda básica requiere menos configuración y produce resultados más amplios. La búsqueda avanzada permite buscar a través de campos WHOIS específicos.

Puede proporcionar hasta cuatro términos de búsqueda en una solicitud. Con varios términos de búsqueda, la salida incluye los dominios que coinciden con todos ellos.

El término de búsqueda incluye un campo exacto del registro WHOIS del dominio, uno de los siguientes:

Campos comunes

DomainName,
NameServers,
WhoisServer,
Status,
RegistrarName,
Email

El campo Correo electrónico permite buscar frente a RegistrantContact.Email, AdminContact.Email, BillingContact.Email, TechContact.Emailen una sola consulta.

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

Campos de contacto del administrador

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

Campos de contacto de facturación

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

Campos de contacto técnico

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

Encabezados

X-Authentication-Token

Puede utilizar este encabezado 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 para la búsqueda avanzada

Para la búsqueda avanzada, en lugar del bloque basicSearchTerms, utilice el bloque advancedSearchTerms con el siguiente formato:

advancedSearchTerms.field

Obligatorio. En qué campo WHOIS buscar.

advancedSearchTerms.term

Obligatorio. Cadena de búsqueda. No distingue mayúsculas de minúsculas.

advancedSearchTerms.exclude

Opcional. Booleano. Excluya el término si no debe formar parte de la búsqueda.

Valores aceptables: false | true

Por defecto: falso

advancedSearchTerms.exactMatch

Opcional. Booleano. Si el campo debe coincidir exactamente con el término de búsqueda. Si es falso, se permite que el campo contenga un término de búsqueda como subcadena.

Valores aceptables: false | true

Por defecto: falso

Tenga en cuenta que, actualmente, el parámetro solo se admite para los siguientes campos: NameServers, Status, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.StreetAddress, AdminContact.Name, AdminContact.Organization, AdminContact.StreetAddress, BillingContact.Name, BillingContact.Organization, BillingContact.StreetAddress, TechContact.Name, TechContact.Organization, TechContact.Street

Para el resto de campos, se ignora y se interpreta como verdadero.

En su lugar, puede utilizar la búsqueda con comodines para encontrar coincidencias parciales.

Búsqueda mediante comodines

Tenga en cuenta que el número de solicitudes mediante comodines está limitado a 5 por minuto.

Puede utilizar comodines para buscar en campos específicos. Tenga en cuenta que los comodines iniciales y finales no pueden utilizarse juntos para todos los campos excepto "domainName". En este caso, el comodín final se eliminará. Para el campo "domainName", los comodines intermedios no se pueden utilizar si tanto el comodín de arrastre como el principal están presentes. En este caso, se eliminará el comodín intermedio. Tenga en cuenta que estas consultas pueden ser lentas.

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Air*bnb*"
    }]
}

Ejemplo de uso de comodines

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook."
    }]
}

- devuelve 0 dominios

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook.*"
    }]
}

- devuelve más de 400 dominios