network_asn_lookup
Identify the Autonomous System (ASN) owning or routing an IP address, domain, or AS number, providing organization, country, and registry.
Instructions
ASN Lookup. Resolve an IP address, domain name, or AS number to its Autonomous System (ASN number, owning organization, country, RIR registry) by making an outbound query to an external ASN/geolocation data source (ip-api.com), optionally via a registered remote worker peer. Makes a live network call, so results depend on third-party data and are not deterministic. Use this to identify who owns/routes an IP. Use network_whois for domain/IP registration and contact records, network_bgp_route_lookup for AS-PATH and prefix routing analysis, and network_ip_geolocation for detailed geographic/ISP data. Anonymous limit 15/min, 90/hour, 300/day (authenticated 30/180/600); CAPTCHA after 30 requests/hour. Returns the resolved IP, an asn object, and the data source; geolocation only when requested (prefixes and upstreams are not populated by the default ip-api.com source).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | IP address, domain name, or AS number to look up, for example 8.8.8.8, google.com, or AS15169. | |
| includeGeolocation | No | When true, include a geolocation object (country, region, city, zip, timezone, coordinates). | |
| includePrefixes | No | When true, request announced prefixes (not populated by the default ip-api.com source; needs a BGP data source/worker). | |
| includeUpstreams | No | When true, request upstream AS peers (not populated by the default ip-api.com source; needs a BGP data source/worker). | |
| worker_id | No | Optional registered healthy worker peer ID. Omit to use the default master-server behavior. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | True when the lookup completed. | |
| target | No | The input target, echoed back. | |
| resolvedIp | No | IP the target resolved to (null for direct AS-number input). | |
| asn | No | Autonomous System details, or null when none found. | |
| geolocation | No | Present only when includeGeolocation is true; null otherwise. | |
| prefixes | No | Announced prefixes when includePrefixes is true (empty from the default source); null otherwise. | |
| upstreams | No | Upstream AS peers when includeUpstreams is true (empty from the default source); null otherwise. | |
| dataSource | No | Origin of the data, e.g. ip-api.com, Direct ASN input, or Private/Reserved IP. | |
| timestamp | No | ISO-8601 response time. |