Geolocalización IP, comprobación de emails y señales de riesgo de inicio de sesión en una sola API.
Localiza a los visitantes de tu sitio desde el navegador, consulta direcciones IP desde tu backend, detecta dominios desechables y errores tipográficos en los emails de registro, y señala viajes imposibles al iniciar sesión — todo con un solo plan y una sola cuota mensual de solicitudes. La tarjeta muestra una vista previa de los datos edge y del enriquecimiento local de esta solicitud de página; no es una respuesta de la API.
request.cf216.73.216.231
- Coordenadas
- 39.9612, -82.9988
- Zona horaria
- America/New_York
- Código postal
- 43215
- Continente
- NA
- Red
- Anthropic, PBC
- ASN
- AS16509
- Moneda
- $ USD
- Código telefónico
- +1
- Amanecer / atardecer
- 7:49 / 18:42
- Dispositivo
- —
- Seguridad
- No disponible — no verificado
Elige la API para tu tarea
Ubica al visitante en tu sitio web
Llama a la API de geolocalización de visitantes directamente desde el navegador con una clave publicable restringida a tus orígenes permitidos. Usa datos aproximados de país y ciudad, zona horaria y contexto regional disponible para sugerir una experiencia más relevante.
Explora la geolocalización de visitantes →Busca una IP desde tu backend
¿Ya tienes una dirección IP en tu aplicación? Envíala al endpoint de búsqueda de IP desde tu servidor. Una clave secreta autentica la solicitud, y la respuesta contiene campos de ubicación de una base de datos de geolocalización de IP de terceros.
Explora la API de búsqueda de IP →Procesa una lista de direcciones IP
Envía hasta 100 direcciones IP en una sola solicitud por lotes y recibe una lista ordenada de resultados de búsqueda para reportes, enriquecimiento y otros flujos de trabajo de backend. El uso de búsqueda se mide por IP, no por solicitud de lote.
Explora la búsqueda masiva de IP →Comprobar direcciones de email en el registro
Comprueba la sintaxis, los dominios desechables conocidos, si el dominio tiene servidor de correo, los errores tipográficos probables y las direcciones genéricas, y obtén un veredicto de aceptar, revisar o rechazar con sus motivos. Llámala desde tu formulario con una clave publicable, o comprueba hasta 100 direcciones por solicitud — o listas de hasta 100.000 — desde tu backend o el panel.
Explorar la comprobación de emails →Puntuar un registro nuevo en una sola llamada
POST /v1/signup/check combina la comprobación del email con el país y la red de la IP que se registra, los indicadores de VPN, Tor y centro de datos según el plan, y la antigüedad del dominio del email, en una puntuación de 0 a 100 y un veredicto con motivos. La puntuación es contexto para tu decisión, no una prueba de abuso.
Ver el flujo contra el abuso en registros →Señalar viajes imposibles al iniciar sesión
POST /v1/risk/check compara la ubicación aproximada de la IP de inicio de sesión con la ubicación anterior guardada del usuario y devuelve la distancia, el tiempo transcurrido, la velocidad implícita y un nivel de riesgo. Puede producir falsos positivos y no demuestra el robo de una cuenta.
Explorar la detección de viajes imposibles →Ejemplo de integración en el navegador y vista previa de borde
El ejemplo muestra cómo llamar a GET /v1/geo desde un navegador. No se ejecutó para generar esta vista previa. La ubicación proviene de esta solicitud de página; el enriquecimiento se deriva localmente. Los valores faltantes no están disponibles, y no se ejecutan verificaciones de seguridad.
Solicitud de ejemplo — no ejecutada
import { WatchIP } from "@digitload/watch-ip-sdk";
const client = new WatchIP("wip_pub_xxxxxxxx");
const { country, city, timezone, currency, callingCode } = await client.getGeo();Vista previa de la solicitud de página — no es una respuesta de la API
{
"ip": "216.73.216.231",
"country": "US",
"region": "Ohio",
"regionCode": "OH",
"city": "Columbus",
"postalCode": "43215",
"latitude": 39.96118,
"longitude": -82.99879,
"continent": "NA",
"timezone": "America/New_York",
"isEUCountry": false,
"asn": 16509,
"asOrganization": "Anthropic, PBC",
"currency": {
"code": "USD",
"name": "US Dollar",
"symbol": "$"
},
"callingCode": "+1",
"compliance": {
"isGDPR": false,
"usPrivacyLaw": null,
"isLGPD": false,
"requiresCookieConsent": false,
"dataResidencyZone": "US",
"isEmbargoedCountry": false
},
"locale": {
"suggestedLocale": "en-US",
"measurementSystem": "imperial",
"firstDayOfWeek": 0,
"dateFormat": "MM/DD/YYYY"
},
"sun": {
"sunrise": "2026-10-23T11:49:40.834Z",
"sunset": "2026-10-23T22:42:44.749Z"
},
"holiday": {
"isPublicHolidayToday": false,
"todayHolidayName": null,
"nextHoliday": {
"date": "2026-11-11",
"name": "Veterans Day"
}
},
"age": {
"ageOfMajority": 18,
"drinkingAge": 21,
"adultContentVerificationRequired": true,
"jurisdictionNote": "HB 96 (2025)"
},
"tax": {
"jurisdictionCode": "US-OH",
"taxSystem": "US_SALES_TAX",
"rate": null
},
"userAgent": {
"browser": null,
"browserVersion": null,
"os": null,
"osVersion": null,
"deviceType": "bot"
}
}Geolocalización de visitantes y de backend
Usa GET /v1/geo en el navegador del visitante con una clave publicable. Usa GET /v1/lookup/{ip} o POST /v1/lookup en tu backend con una clave secreta para direcciones IP proporcionadas.
Un solo plan para todas las comprobaciones
Geolocalización, consulta de IP y comprobaciones de email, registro y viaje imposible consumen la misma cuota mensual de solicitudes — una solicitud por llamada, por IP o por dirección comprobada. No hay un producto aparte que comprar, y todos los planes, incluido Free, pueden emitir ambos tipos de clave.
Comprobaciones de email a nivel de dominio
Las comprobaciones de email analizan la sintaxis, si el dominio es desechable y sus registros de servidor de correo, los errores tipográficos probables y las direcciones genéricas. Nunca contactan con el buzón, así que ningún resultado confirma que una dirección exista o pueda recibir correo.
Claves restringidas por origen
Tu clave de API es publicable, como una clave de Stripe o Google Maps. Las solicitudes solo se atienden — y CORS solo se otorga — a los orígenes que registres.
Geolocalización de borde
GET /v1/geo lee datos de ubicación a nivel de red para la IP que se conecta. La ubicación por IP es aproximada; el tiempo de respuesta depende de la solicitud y de las funciones habilitadas.
Enriquecimiento regional
Las respuestas de visitantes derivan moneda, código telefónico, horarios de salida y puesta del sol, e indicios de dispositivo a partir de la ubicación y los encabezados de la solicitud. Los campos pueden ser nulos cuando los datos de origen no están disponibles.
Indicaciones de cumplimiento regional
Las asignaciones estáticas de país y región proporcionan indicaciones de cumplimiento normativo. No establecen obligaciones legales ni garantizan el cumplimiento.
Negociación de configuración regional, ya resuelta
Cada respuesta incluye un objeto locale: la configuración regional BCP47 más adecuada (combinando el país del visitante con el encabezado Accept-Language de su navegador, de modo que un visitante francófono en Canadá obtiene fr-CA, no fr-FR), además del sistema de medidas, el primer día de la semana y el formato de fecha — evita volver a implementar esto en tu propia capa de i18n.
Calendario de días festivos
Cada respuesta incluye un objeto holiday: si hoy es un día festivo en el país del visitante, su nombre, y el próximo día festivo — útil para mensajes de "hoy estamos cerrados" en un widget de soporte, mensajes de checkout o lógica de programación, cubriendo una lista curada de unos 40 países.
Indicaciones de jurisdicción por edad
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.
Indicaciones de jurisdicción fiscal
Las asignaciones estáticas proporcionan contexto fiscal regional. No son un cálculo de impuestos ni sustituyen un motor fiscal mantenido activamente.
Paquetes fuente de SDK
El repositorio incluye clientes de JavaScript/TypeScript, Python, PHP, Go y Flutter/Dart. El soporte de endpoints varía; consulta la documentación y verifica la disponibilidad del paquete antes de instalarlo.
Señales de VPN, Tor y red
Los planes de visitantes elegibles incluyen indicadores basados en listas de VPN, Tor, centro de datos, amenazas y redes sancionadas. Una alerta falsa significa que no hubo coincidencia en los datos disponibles, no que el visitante sea seguro. La cobertura de IPv6 es parcial; Tor sobre IPv6 no está cubierto.
Subdominios de marca
Growth y Scale incluyen una ruta de configuración de dominio personalizado en el panel. La disponibilidad depende de la elegibilidad de la cuenta y de una configuración exitosa de DNS y SSL; las integraciones deben usar la URL base configurada.
Señal de viaje imposible
POST /v1/risk/check compara la ubicación aproximada de una IP proporcionada con una línea base almacenada del usuario. Puede producir falsos positivos y no demuestra el robo de una cuenta. Contáctanos para confirmar la disponibilidad y el aprovisionamiento.
Entiende la respuesta antes de integrar
Las API de visitantes y de búsqueda atienden solicitudes distintas y devuelven datos diferentes. La geolocalización de visitantes usa la geolocalización de borde de la solicitud entrante y agrega contexto regional. La búsqueda de IP resuelve la dirección que proporcionas usando una base de datos de geolocalización de IP de terceros. Las respuestas de búsqueda no contienen todo el enriquecimiento disponible en la geolocalización de visitantes — por ejemplo, la fuente de datos actual no incluye código postal ni zona horaria. Las comprobaciones de email, registro y riesgo trabajan cada una con los datos que envías — una dirección, o un ID de usuario y una IP — y cada fila de abajo consume la misma cuota mensual de solicitudes.
| Tu tarea | Endpoint | Clave | Enfoque de datos |
|---|---|---|---|
| Ubicar al visitante que se conecta al sitio web | GET /v1/geo | Publicable, restringida por origen | Ubicación del visitante y contexto regional |
| Buscar una IP proporcionada | GET /v1/lookup/{ip} | Clave secreta Bearer | Resultado de ubicación de una base de datos de geolocalización de IP de terceros |
| Buscar varias IP proporcionadas | POST /v1/lookup | Clave secreta Bearer | Hasta 100 resultados de ubicación ordenados |
| Comprobar un email en un formulario de registro | POST /v1/email/validate | Publicable, restringida por origen | Señales de sintaxis, dominio desechable, servidor de correo y errores tipográficos, con un veredicto |
| Comprobar emails de forma masiva | POST /v1/email/batch, /v1/email/jobs | Clave secreta Bearer | Hasta 100 por solicitud, o hasta 100.000 por trabajo de lista asíncrono |
| Puntuar un registro nuevo | POST /v1/signup/check | Clave secreta Bearer | Puntuación de 0 a 100 a partir de señales de email, red IP y antigüedad del dominio |
| Comparar un inicio de sesión con la ubicación anterior | POST /v1/risk/check | Clave secreta Bearer | Distancia, velocidad implícita e indicador de viaje imposible |
Preguntas frecuentes
¿Puede Watch-IP geolocalizar una dirección IP que yo proporcione?
Sí. Usa la API de búsqueda de IP del lado del servidor con una clave secreta. El endpoint de visitantes del navegador ubica al cliente que se conecta y no acepta una IP arbitraria para buscar.
¿Puedo usar Watch-IP desde JavaScript en un navegador?
Usa la geolocalización de visitantes con una clave publicable configurada para el origen de tu sitio web. Las claves secretas de búsqueda pertenecen a tu backend y nunca deben aparecer en código de navegador.
¿Es la geolocalización de IP lo mismo que la API de geolocalización del navegador?
No. Watch-IP estima la ubicación a partir de una conexión IP. La API de geolocalización del navegador es un mecanismo distinto que puede solicitar permiso para obtener la ubicación proporcionada por el dispositivo.
¿Puedo buscar direcciones IPv4 e IPv6?
Los endpoints de búsqueda aceptan direcciones IPv4 e IPv6 válidas, sujetas a los registros disponibles en la base de datos. La cobertura de señales de seguridad es una cuestión aparte y varía según el indicador y la versión de IP.
¿Tiene Watch-IP un plan gratuito?
Sí. El plan Free incluye una cuota mensual de solicitudes y una cuota menor de consultas de IP; consulta la página de precios para ver los límites actuales. Las comprobaciones de email, registro y viaje imposible consumen la misma cuota, sin un plan aparte.
¿La comprobación de email verifica que un buzón existe?
No. Watch-IP comprueba la sintaxis, el dominio (listas de desechables, registros de servidor de correo, antigüedad) y patrones de la dirección como errores tipográficos y cuentas genéricas. No contacta con el servidor de correo, así que ningún resultado confirma que un buzón exista o pueda recibir correo.
¿Las comprobaciones de email y de riesgo necesitan un plan aparte?
No. Cada dirección comprobada, comprobación de registro o de viaje imposible cuenta como una solicitud en la misma cuota mensual que tus llamadas de geolocalización y consulta. Los endpoints de backend usan una clave secreta emitida desde tu panel.
¿Significa una alerta de seguridad falsa que el visitante es seguro?
No. Significa que la verificación no encontró una coincidencia en los datos que utiliza. La cobertura faltante, las redes no listadas y las señales no disponibles deben considerarse por separado.
Elige tu primera integración
Empieza con la guía de visitantes para un sitio web, la página del producto de consulta para una aplicación backend, o la comprobación de email para tu formulario de registro.