Elige un plan para la API que necesitas

Cada llamada autenticada que supera las comprobaciones de clave y origen cuenta como una solicitud: una llamada de geolocalización de visitante, cada IP consultada, cada dirección de email comprobada, cada comprobación de registro y cada comprobación de viaje imposible. Una llamada que después falla la validación de entrada también cuenta. Las llamadas rechazadas por una clave ausente o no válida, un origen no permitido o el límite de frecuencia por minuto no cuentan, ni tampoco eliminar una línea base de riesgo o consultar el estado de un trabajo de lista de emails.

Es una ventana fija de un minuto, alineada al minuto del reloj — no un promedio móvil. En el plan Free puedes hacer hasta 30 solicitudes entre, digamos, las 10:32:00 y las 10:32:59; el contador se reinicia a cero a las 10:33:00. Si excedes el límite, recibes un HTTP 429 con un encabezado Retry-After que indica cuántos segundos faltan para que la ventana se reinicie. Es independiente de tu volumen mensual de solicitudes indicado abajo — limita la tasa de ráfaga, no el uso total. El límite cuenta llamadas a la API, no elementos: un lote de hasta 100 IP o direcciones de correo, o la creación de un trabajo de lista de correos, cuenta como una sola solicitud — mientras que cada IP o dirección que contiene sigue contando por separado en tu volumen mensual de solicitudes.

No desactivamos tu clave automáticamente. Si estás cerca del límite de tu plan de forma constante, actualiza en cualquier momento desde tu panel — sin necesidad de cambiar código ni claves de API.

La geolocalización de visitantes lee datos de la solicitud en el edge y deriva el enriquecimiento regional localmente, lo que mantiene su costo — y precio — muy por debajo de los niveles equivalentes de la mayoría de los proveedores. La búsqueda de IP del lado del servidor está incluida en el mismo plan y precio en lugar de venderse por separado: cada plan incluye tanto un límite de solicitudes como una asignación de búsquedas de IP, ambos extraídos del mismo grupo mensual compartido de ese plan.

Las respuestas de geolocalización de visitantes y de consulta de IP incluyen enriquecimiento regional cuando hay datos de origen disponibles. Los planes elegibles también incluyen indicadores de seguridad basados en listas. Las comprobaciones de email devuelven un resultado aparte, a nivel de dominio. La latencia varía según la solicitud y las funciones activadas.

Sí. GET /v1/geo sigue siendo solo la autobúsqueda del visitante, del lado del cliente, resolviendo la IP que realmente se conecta. Para la búsqueda de una IP arbitraria, GET /v1/lookup/{ip} (individual) y POST /v1/lookup (por lotes, hasta 100 IP por llamada) son endpoints de servidor a servidor autenticados con una clave secreta en lugar de tu clave publicable — la clave permanece en tu backend y nunca se envía a un navegador. Ambos se basan en una base de datos de geolocalización de IP de terceros en lugar de nuestros propios datos de red en tiempo real, con una estructura de respuesta diferente y sin una clasificación de precisión relativa verificada — consulta las fuentes de datos para conocer el proveedor específico y la atribución requerida — y el uso se cobra por IP buscada, extraído del grupo mensual compartido de tu plan uno a uno con una solicitud de geolocalización (consulta la asignación de búsquedas de IP de tu plan arriba para conocer el límite independiente del total de búsquedas). Debido a que este endpoint busca IP que tu cliente proporciona en lugar del visitante que llama por sí mismo, esto convierte a Watch-IP en un procesador de esos datos de terceros en tu nombre — consulta el DPA para saber qué significa esto para tus propias obligaciones de cumplimiento.

POST /v1/risk/check compara la ubicación resuelta por un tercero de una IP proporcionada con una línea base almacenada del usuario y devuelve un riesgo bajo/medio/alto y una marca impossibleTravel. Usa una clave secreta Bearer de backend. Contáctanos para confirmar la disponibilidad, el aprovisionamiento y el precio; la aplicación independiente de un plan de riesgo y la preparación del checkout no han sido verificadas. Los cambios de VPN y el enrutamiento móvil pueden causar falsos positivos.

Sí. POST /v1/email/validate usa una clave publicable restringida por origen para comprobar la sintaxis, los dominios desechables conocidos, si el dominio tiene servidor de correo, los errores tipográficos probables y las direcciones genéricas, y devuelve un veredicto de aceptar, revisar o rechazar con sus motivos. Desde tu backend, POST /v1/email/batch comprueba hasta 100 direcciones por llamada, los trabajos de lista admiten hasta 100.000, y POST /v1/signup/check añade las señales de red de la IP que se registra. Cada dirección comprobada cuenta como una solicitud en la cuota mensual de tu plan (un trabajo de lista cobra cada dirección distinta una sola vez). Ninguna de estas comprobaciones contacta con el buzón, así que no verifican la existencia, la titularidad ni la entregabilidad de un buzón.

Depende del tipo de clave. Las claves publicables — usadas para GET /v1/geo y POST /v1/email/validate — están pensadas para incluirse en el código fuente de la página, como una clave publicable de Stripe o Google Maps; el control de acceso es la restricción por origen: cada clave solo funciona desde los dominios que registras, y CORS solo se concede a un origen coincidente. Las claves secretas — usadas para la consulta de IP, la comprobación masiva de emails y las comprobaciones de registro y viaje imposible — deben quedarse en tu backend y no aparecer nunca en código del navegador.

Existen paquetes fuente de SDK para JavaScript/TypeScript, Python, PHP, Go y Flutter/Dart. Verifica la disponibilidad en el registro y el soporte de endpoints antes de usarlos. GET /v1/geo siempre ubica a quien se conecta; una llamada desde el backend no ubica al visitante de tu sitio web. Usa la búsqueda con clave secreta para una IP proporcionada.

Sí, pero es opcional: agrega ?include=hostname a la solicitud (o include: ["hostname"] en el SDK) y la respuesta incluirá un campo hostname, resuelto mediante una búsqueda PTR por DNS sobre HTTPS. Es nulo cuando no hay un registro PTR. A diferencia de los campos de enriquecimiento siempre activos anteriores, esto realiza una búsqueda de red real dentro de la solicitud, por lo que está desactivado de forma predeterminada en lugar de agregar latencia a cada llamada.

Los planes elegibles incluyen los indicadores basados en listas isVpn, isTor, isDatacenter, isThreat e isSanctionedNetwork tanto en las respuestas de geolocalización de visitantes como en las de consulta de IP; Free omite la seguridad. IPv4 admite coincidencia por listas y por ASN. IPv6 admite rangos de VPN, centros de datos y amenazas además de coincidencia por ASN, pero no tiene cobertura de Tor. La cobertura en producción depende de los feeds disponibles. False significa que no hubo coincidencia en los datos disponibles, no una garantía de seguridad; estas señales no son un control de sanciones definitivo.

Sí — cada respuesta incluye un objeto compliance: isGDPR (UE/EEE + Reino Unido), usPrivacyLaw (la ley estatal de EE. UU. aplicable, por ejemplo CCPA/CPRA o VCDPA, según el estado del visitante), isLGPD (Brasil), una marca derivada requiresCookieConsent, una dataResidencyZone aproximada, e isEmbargoedCountry (embargos integrales de país de la OFAC). Se incluye sin costo adicional en todos los planes, igual que la moneda y el código telefónico. Es una señal preliminar de jurisdicción calculada a partir de la ubicación del visitante, no un asesoramiento legal — confirma siempre los requisitos de cumplimiento con tu propio asesor legal.

Sí — cada respuesta incluye un objeto locale: suggestedLocale es una configuración regional BCP47 que combina el país del visitante con el encabezado Accept-Language de su propio navegador, prefiriendo un idioma realmente hablado allí (por ejemplo, un Accept-Language de "fr" de un visitante canadiense produce "fr-CA", no "fr-FR"), y recurre a la configuración regional predeterminada del país cuando nada en el encabezado coincide. El mismo objeto también incluye measurementSystem (métrico/imperial), firstDayOfWeek y dateFormat, para que no tengas que volver a derivar tú mismo las convenciones de formato regional. Se incluye sin costo adicional en todos los planes.

Sí — cada respuesta incluye un objeto holiday: isPublicHolidayToday, todayHolidayName y nextHoliday (fecha y nombre) para el país del visitante, calculado a partir de una tabla estática curada (actualmente unos 40 países — el G20 más la UE/EEE y el Reino Unido) obtenida de Nager.Date y actualizada de forma manual, una o dos veces al año, en lugar de calcularse en el momento de la solicitud. Es nulo para países fuera de esa lista, y solo cuenta días festivos nacionales, no observancias exclusivas de un estado o provincia. Incluido sin costo adicional en todos los planes; se pueden agregar más países a solicitud.

Las asignaciones estáticas proporcionan indicaciones de edad y jurisdicción basadas en la ubicación aproximada por IP. No verifican identidad ni edad; confirma los requisitos aplicables de forma independiente.