Realizar solicitudes | Documentación | Brand Alert API | WhoisXML API

Realizar solicitudes

Punto final de API

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

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": "YOUR_API_KEY",
    "sinceDate": "2024-09-27",
    "mode": "purchase",
    "withTypos": false,
    "responseFormat": "json",
    "punycode": true,
    "includeSearchTerms": [
        "google",
        "blog"
    ],
    "excludeSearchTerms": [
        "analytics"
    ]
}

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

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

includeSearchTerms

Obligatorio. Conjunto de términos de búsqueda. Todos ellos deben estar presentes en el nombre de dominio. Máximo 4 elementos. No distingue mayúsculas de minúsculas.

excludeSearchTerms

Opcional. Conjunto de términos de búsqueda. Todos ellos NO deben estar presentes en el nombre de 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 existe, 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.

mode

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.

Acceptable values: preview | purchase

Por defecto: preview

withTypos

Opcional. Si es true, el conjunto de términos de búsqueda se enriquecerá con sus posibles erratas. Por ejemplo, para el término 'google', las erratas podrían ser: 'goigle', 'gokgle', 'golgle', 'gopgle', 'goglee', 'gooogle', etc.

Valores aceptables: false | true

Por defecto: false

Con erratas incluidas - 1 solicitud cuesta 300 créditos DRS.

Más información: Prefuntas frecuentes sobre generación de errores tipográficos

punycode

Opcional. Si es true, 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

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 límite, sus solicitudes posteriores serán rechazadas hasta el segundo siguiente.

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.