La API de Recuperación de Listas Negras de Direcciones IP está diseñada para evaluar la reputación de una dirección IP al consultar simultáneamente múltiples listas negras reconocidas. Su principal objetivo es determinar si una dirección IP ha sido clasificada como potencialmente riesgosa debido a actividad sospechosa, abuso previo o comportamientos asociados con spam, malware o acceso no autorizado. Este tipo de API es esencial en entornos donde la seguridad y la fiabilidad del tráfico de red son críticas.
El endpoint proporciona un resumen claro del estado de la IP analizada, indicando si está incluida en al menos una lista negra, cuántas listas fueron consultadas y cuántas coincidencias fueron detectadas. Además, ofrece métricas adicionales como el número de listas que respondieron correctamente, las que no tenían ninguna inclusión y los posibles tiempos de espera durante la consulta. Esta información permite evaluar no solo el riesgo potencial, sino también la cobertura y fiabilidad del análisis realizado.
Uno de los aspectos más valiosos de la API es el detalle para cada lista negra donde se encuentra la IP. Para cada coincidencia, se incluyen datos como el nombre de la lista, el estado del resultado, la razón de la inclusión y parámetros técnicos adicionales. Esto facilita auditorías, análisis forenses y toma de decisiones informadas, como aplicar bloqueos automáticos, marcar tráfico para revisión o generar alertas de seguridad.
Consulta múltiples listas negras para evaluar la reputación de una IP devolviendo el estado de listado coincidencias detectadas y métricas de verificación
Verificación de lista negra - Características del Endpoint
| Objeto | Descripción |
|---|---|
ip |
[Requerido] Enter an IP address. |
{"ip":"8.8.8.8","is_listed":true,"checked_blacklists":61,"listed_count":4,"timeout_count":0,"ok_count":57,"listed_blacklists":[{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0},{"name":"\u00a0OK","status":"LISTED","reason":"8.8.8.8 was listed","ttl":0,"response_time_ms":0}],"timeouts":[],"checked_at":"2026-01-23T12:54:22Z","_cached":true,"_cache_key":"ipx_api:blacklist_check:8_8_8_8"}
curl --location --request GET 'https://zylalabs.com/api/11765/ip+address+blacklist+retrieval+api/22312/blacklist+verification?ip=8.8.8.8' --header 'Authorization: Bearer YOUR_API_KEY'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
El endpoint de verificación de listas negras devuelve datos sobre la reputación de una dirección IP incluyendo si está listada en listas negras el número de listas negras verificadas y información detallada sobre cada lista negra donde está listada la IP
Los campos clave en la respuesta incluyen "ip" (la dirección IP consultada) "is_listed" (booleano que indica si la IP está en la lista negra) "checked_blacklists" (total de listas negras consultadas) "listed_count" (número de listados encontrados) y "listed_blacklists" (detalles de cada coincidencia en la lista negra)
Los datos de respuesta están estructurados en formato JSON con un objeto principal que contiene campos de resumen y un array de "listados_blacklists" que proporciona información detallada para cada coincidencia de blacklist incluyendo nombre estado razón y tiempo de respuesta
El endpoint proporciona información sobre si una IP está en la lista negra el número total de listas negras verificadas el conteo de listados y razones detalladas para cada listado lo que ayuda a evaluar el nivel de riesgo de la IP
Se mantiene la precisión de los datos consultando múltiples listas negras reconocidas, asegurando que la información provenga de bases de datos reputables. Se realizan actualizaciones y verificaciones regulares para garantizar la fiabilidad de los datos devueltos
Los casos de uso típicos incluyen mejorar la seguridad de la red al identificar direcciones IP potencialmente dañinas automatizar el filtrado de tráfico realizar análisis forenses y generar alertas para actividades sospechosas
Los usuarios pueden utilizar los datos devueltos para tomar decisiones informadas sobre el acceso a la red como aplicar bloqueos automáticos en las IPs listadas señalar el tráfico para revisión o ajustar los protocolos de seguridad según la evaluación de riesgos proporcionada
Los usuarios pueden esperar una estructura de respuesta consistente con campos que indican el estado de la IP el número de listas negras verificadas y listados detallados Los patrones comunes incluyen múltiples listados para IPs de spam o maliciosas conocidas junto con tiempos de respuesta variables de diferentes listas negras
Nivel de Servicio:
100%
Tiempo de Respuesta:
118ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
110ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.944ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.398ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
170ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
8.137ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
390ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
105ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
188ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
573ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
968ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.535ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
55ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
223ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
626ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.103ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.230ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
369ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
639ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms