Busca una dirección IP desde tu backend

Resuelve una dirección IP proporcionada en datos disponibles de país, región, ciudad y coordenadas aproximadas. La API de búsqueda de IP de Watch-IP acepta entradas IPv4 e IPv6 y devuelve un resultado JSON basado en una base de datos de geolocalización de IP de terceros. Usa una clave secreta de API en tu servidor, y construye tu aplicación considerando coincidencias explícitas, registros faltantes y campos de ubicación nulos.

Ver planes de búsqueda Conversa sobre el acceso a búsqueda →

Proporciona la dirección que quieres resolver

Llama a GET /v1/lookup/{ip} con una dirección IP recopilada por tu aplicación, autenticada con Authorization: Bearer y una clave secreta. La búsqueda resuelve la dirección en la URL en lugar de la conexión usada para hacer la solicitud, lo que la hace adecuada para flujos de trabajo de backend que ya contienen direcciones IP, incluidos reportes y enriquecimiento regional. Verifica cómo tu aplicación obtiene la IP de un usuario final antes de depender de encabezados reenviados; confía solo en la ruta de proxy que tú controlas. Para una integración común de visitante de sitio web, el endpoint de geolocalización del navegador ofrece una ruta diferente con una clave publicable y enriquecimiento regional.

Pasa de una dirección a un lote

Si tu flujo de trabajo contiene varias direcciones IP, el endpoint por lotes acepta hasta 100 en una sola solicitud y devuelve los resultados en el mismo orden. Usa la misma forma de resultado de búsqueda y el mismo modelo de autenticación con clave secreta del lado del servidor. El procesamiento por lotes cambia cómo envías las solicitudes — el uso de búsqueda se sigue midiendo por IP, así que un lote no es una sola unidad de uso de búsqueda.

Construye considerando datos aproximados

Una IP puede representar una puerta de enlace compartida, una red de hosting, una salida de VPN o una conexión de operador móvil. Los registros de ubicación pueden estar incompletos o diferir entre proveedores de datos. Usa la búsqueda como contexto para la dirección que proporcionaste, no como prueba de la residencia o identidad de una persona.

Campos de respuesta

ip: La dirección de entrada asociada con este resultado.
found: Si se encontró un registro coincidente en la base de datos. False también puede significar que la base de datos no está disponible o no se ha cargado — no demuestra que la dirección no tenga datos de ubicación.
country, continent: Códigos de país y continente, cuando están disponibles.
region: Un identificador de subdivisión de la asignación actual, no siempre un nombre de región completo.
city, latitude, longitude: Ciudad y coordenadas aproximadas, cuando están disponibles en la base de datos de origen.
postalCode, timezone: No son proporcionados por la fuente de datos actual — siempre nulos.

Realiza una solicitud del lado del servidor

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Configura WATCH_IP_SECRET_KEY en el entorno de tu servidor primero. 8.8.8.8 es una dirección de ejemplo sintácticamente válida; este fragmento no garantiza un país, ciudad o respuesta en particular para ella.

Preguntas frecuentes

¿Puedo usar esta API para buscar la dirección IP de otra persona?

El endpoint acepta una dirección IP proporcionada y devuelve los datos de ubicación disponibles en la base de datos, no el nombre, la dirección exacta ni la identidad de una persona. Usa solo datos que estés autorizado a procesar.

¿Admite IPv6?

El endpoint valida entradas IPv4 e IPv6. Una dirección válida aún puede carecer de un registro en la base de datos o de algunos campos de ubicación.

¿La búsqueda incluye zona horaria, ASN o detección de VPN?

No. La respuesta de búsqueda actual no incluye ASN ni indicadores de seguridad, y su fuente de base de datos de terceros no proporciona campos de zona horaria ni código postal. Revisa la geolocalización de visitantes por separado si su modelo de cliente que se conecta se ajusta a tu aplicación.

¿Puedo enviar la solicitud desde JavaScript de navegador?

No — nunca expongas una clave secreta de búsqueda en código de navegador. Realiza las llamadas de búsqueda desde tu backend, y usa el endpoint de visitante con una clave publicable para la geolocalización directa en el navegador.

¿Está incluido con una clave de visitante gratuita?

No. La búsqueda usa una clave y una familia de planes separadas; el plan gratuito de visitante no otorga acceso a la búsqueda del lado del servidor.

¿Qué significa found: false?

La búsqueda no devolvió un registro coincidente. En la implementación actual, esto también puede ocurrir cuando la base de datos no está disponible o no se ha cargado, así que muestra "Ubicación no disponible" y mantén este resultado separado de la entrada inválida, los fallos de autenticación y los errores de límite de tasa.