API de búsqueda de ASN

Obtené el ASN, el ISP y la organización de cualquier dirección IPv4 o IPv6, y después consultá el Autonomous System: nombre, org, RIR y prefijos de muestra. Schema completo en todos los planes, incluido Free.

Registrarse Leer la documentación

Free: 1.000 req/día · HTTPS · uso comercial OK

Ejemplo

Consultá la red detrás de una IP y después el Autonomous System al que pertenece:

GET /v0/ip/{ip} · GET /v0/asn/{asn} 
$ curl -s https://api.networkdatalabs.com/v0/ip/8.8.8.8 \
    -H "Authorization: Bearer YOUR_API_KEY" | jq '.network'

{
  "asn": 15169,
  "as_org": "Google LLC",
  "isp": "Google LLC",
  "organization": "Google LLC",
  "network": "8.8.8.0/24"
}

$ curl -s https://api.networkdatalabs.com/v0/asn/AS15169 \
    -H "Authorization: Bearer YOUR_API_KEY"

{
  "asn": 15169,
  "name": "GOOGLE",
  "org": "Google LLC",
  "domain": "google.com",
  "type": "hosting",
  "country_code": "US",
  "rir": "ARIN",
  "prefixes_sample": ["8.8.8.0/24", "8.8.4.0/24"]
}

El lookup de IP devuelve el ASN, la organización y el prefijo que contiene a la IP; el lookup de ASN describe la red en sí. {asn} acepta 15169 o AS15169, y un ASN desconocido devuelve 404 NOT_FOUND. ¿Tenés una lista? POST /v0/bulk acepta hasta 100 IPs por request con el mismo schema; una IP inválida aparece en errors sin romper el lote, y cada IP cuenta para la cuota diaria.

Campos de la respuesta

  • network.asn — el número de Autonomous System al que pertenece la IP
  • network.as_org, isp, organization — nombres de la organización del AS, el ISP y la organización
  • network.network y network.rir — prefijo que la contiene (CIDR) y Regional Internet Registry (ARIN, LACNIC, RIPE, APNIC, AFRINIC)
  • GET /v0/asn/{asn} — name, org, domain, type, country_code, rir y prefixes_sample. type suele venir como unknown para la mayoría de los ASN hoy; no te bases en él para clasificar tráfico

El lookup de IP devuelve además ubicación y traits en la misma llamada; mirá la API de geolocalización IP.

Para qué lo usan los equipos

  • Abuse y seguridad — agrupar tráfico abusivo por ASN y organización, y limitar o revisar redes enteras en vez de IPs sueltas
  • Fraude y riesgo — detectar tráfico de servidores con el flag is_hosting del lookup de IP, junto con las señales de la API de detección de fraude por IP
  • Enriquecimiento y analytics — sumar nombres de ISP y organización a logs, eventos y dashboards, y segmentar tráfico por red
  • Routing y redes — mapear IPs a su Autonomous System y prefijos de muestra para routing, peering y troubleshooting

Lo que no hace

  • Los prefijos son una muestra. prefixes_sample lista algunos prefijos anunciados, no la lista completa.
  • type suele no estar disponible. Para la mayoría de los ASN hoy type vuelve como unknown (y domain / country_code pueden ser null); no uses el tipo de ASN para clasificar tráfico. Preferí el flag is_hosting del lookup de IP para señales de hosting. rir y el network que contiene a la IP también pueden faltar, así que prevé un fallback.
  • Un ASN es una red, no una persona. El ASN de un ISP cubre a muchos usuarios sin relación entre sí, así que tomalo como contexto y no como identidad.

Usá el ASN y la organización para agrupar y explicar el tráfico, y decidí con el resto de la respuesta.

Preguntas frecuentes

¿Qué diferencia hay entre el lookup de IP y el de ASN?

GET /v0/ip/{ip} te dice a qué red pertenece una IP (ASN, organización del AS, ISP, organización y prefijo), junto con ubicación y traits. GET /v0/asn/{asn} describe la red en sí: nombre, org, dominio, país, RIR y prefijos de muestra (type suele ser unknown).

¿Soporta IPv6?

Sí. GET /v0/ip/{ip} y POST /v0/bulk aceptan direcciones IPv4 e IPv6 (por ejemplo 2001:4860:4860::8888). Una IP mal formada devuelve 400 INVALID_IP.

¿Hay plan gratis?

Sí: 1.000 requests por día UTC con el schema completo, uso comercial OK. En bulk, cada IP cuenta como un request para la cuota diaria.

Empezá a construir

Creá una cuenta gratis, o leé el quickstart y la referencia completa en la documentación.

Registrarse Leer la documentación

APIs relacionadas