asnzone
ES - Español
Registrarse →

API · v1

Una sola API JSON.
Cada página de este sitio, y más.

Capa gratuita con límites generosos hoy; los planes de pago desbloquean profundidad histórica, eventos de transferencia, flujo BGP, confianza en geolocalización y exportación masiva. Se sirven OpenAPI 3.1, JSON-LD y llms.txt.

Documentación interactivaObtén una clave de API →
// base url https://api.asn.zone/v1OpenAPI 3.1 · JSON-LD · llms.txt

Inicio rápido

sin autenticación en el nivel gratuito
# High-level totals
curl https://api.asn.zone/v1/overview | jq
 
# Drill into Google
curl https://api.asn.zone/v1/asn/15169 | jq
 
# Per-IP geolocation with full delegation history
curl https://api.asn.zone/v1/ip/8.8.8.8/geo | jq
 
# Recent transfers, last 30 days, country US
curl "https://api.asn.zone/v1/transfers?to_country=US&days=30" | jq

Nivel gratuito

60 solicitudes/min, 1k solicitudes/día. No se necesita clave de API. Autentícate con una clave para límites más altos y acceso a los endpoints developer+.

Frescura de los datos

Las estadísticas delegadas de RIR y los registros de transferencias se sincronizan a diario; CAIDA + IPXO Geolocation, mensualmente. Cada respuesta lleva una cabecera Last-Modified.

Endpoints

Endpoints de detalle y listado en cada superficie pública. El nivel indica el plan más bajo con acceso. Referencia completa en el documento OpenAPI.

openapi.jsonllms.txt
MétodoRutaQué haceNivel
GET/v1/overviewHigh-level dataset totalsfree
GET/v1/asnsList ASNs, filterable by country and registryfree
GET/v1/asn/{id}Single ASN with org reference, country, peer/presence summariesfree
GET/v1/asn/{id}/peersProviders, peers, customers (CAIDA AS-Rank)free
GET/v1/asn/{id}/facilitiesPhysical facility presence (PeeringDB)free
GET/v1/asn/{id}/ixInternet Exchange membershipsfree
GET/v1/asn/{id}/prefixesAnnounced BGP prefixes for the ASN (CAIDA pfx2as)developer
GET/v1/org/{registry}/{id}Organization with name, address, contacts, holdingsfree
GET/v1/org/{registry}/{id}/timelineCombined allocation + transfer timelinedeveloper
GET/v1/countriesList countries with stats and 30-day deltasfree
GET/v1/country/{cc}Country detail with top organizations and recent ASNsfree
GET/v1/continentsContinent-level allocation totalsfree
GET/v1/transfersRecent transfer events across the RIR transfer logsfree
GET/v1/ip/{address}/ownerIP → registered holder, ASN, prefixfree
GET/v1/ip/{address}/geoMulti-source IP geolocation with cross-source consensusdeveloper
GET/v1/bgp/announcementsRecent BGP announcements (RouteViews / RIPE RIS)developer
GET/v1/bgp/byoipBring-Your-Own-IP prefixesdeveloper
GET/v1/searchSearch ASNs, organizations, prefixes, and countriesfree
GET/v1/health/sourcesPer-source freshness with 4-state status ladder (ok / degraded / stale / error)free
GET/v1/meCaller customer profile + per-day quota + remaining requestsfree
GET/v1/auditConsumer-facing audit feed (org renames, tag changes, transfers added)free

Descarga masiva

Every dataset as NDJSON. Snake_case keys, contract-locked under v1.1. Pass ?since=<ISO> for incremental fetch; HEAD + If-Modified-Since short-circuits to 304 on no-change days. Errors return application/problem+json (RFC 7807).

  • /v1/datasets/asns.jsonl
  • /v1/datasets/organizations.jsonl
  • /v1/datasets/ipv4-blocks.jsonl
  • /v1/datasets/ipv6-blocks.jsonl
  • /v1/datasets/transfers.jsonl
  • /v1/datasets/asn-prefixes.jsonl
  • /v1/datasets/bgp-byoip.jsonl
  • /v1/datasets/manifest

SDK de TypeScript

@asn-zone/sdk ships AsyncIterable streaming helpers over every bulk dataset endpoint plus the audit feed. Codegen from OpenAPI 3 Zod schemas; RFC 7807 errors parsed into a typed exception class; 429 retry-once respecting Retry-After.

// Stream the latest day of IPv4 allocations
for await (const row of streamIpv4Blocks({
  bearer, since: yesterday
})) { console.log(row.org_id) }

Autenticación

El nivel gratuito no necesita clave - abierto, con límite de tasa por IP. Para límites más altos y los endpoints developer+, regístrate para obtener una clave y pásala como cabecera Bearer.

curl https://api.asn.zone/v1/asn/15169 \
  -H 'Authorization: Bearer azk_live_...'
Crear una clave

Fuentes de datos

Cada dato es rastreable. La lista completa de fuentes con sus cadencias está en la página Acerca de.

  • RIR delegated statsARIN · RIPE · APNIC · AFRINIC · LACNICdiario
  • RIR transfer logsARIN · RIPE · APNICdiario
  • CAIDA AS-Rank + AS-Organizationsasrank.caida.orgmensual
  • PeeringDBfac · ix · netixlandiario
  • IPXO GeolocationIPv4 / IPv6 → citymensual
Lista completa de fuentes →
Construido también para agentes de IA
El sitio expone llms.txt, JSON-LD en cada página y un robots.txt indexado que da la bienvenida explícita a los principales rastreadores de IA y de búsqueda. Crea agentes que lean el registro público de la red sin hacer scraping.
llms.txt →