network_bgp_route_lookup
Retrieve live BGP routing data for an IPv4/IPv6 address or CIDR prefix: origin AS, AS-PATH, and alternative paths.
Instructions
BGP Route Lookup. Resolve an IPv4/IPv6 address or CIDR prefix to live BGP routing data: origin AS, AS-PATH, announced prefix, upstream/alternative paths, and path analysis. Makes a live outbound network call to a public BGP looking-glass API (BGPView), so results depend on third-party availability and may vary between calls. Use this when you need the routing path / AS-PATH for an address; use network_asn_lookup for plain AS number and network ownership, network_whois for registry/registration records, and network_ip_geolocation for physical location. Read-only and non-destructive, but not idempotent (reflects current global routing state). Anonymous callers are limited to 10 requests/minute, 60/hour, 200/day; CAPTCHA is required above 30 requests/hour. Returns primaryRoute (asPath, origin, asNames), alternativePaths, routeCount, pathAnalysis, and the routeServer used.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | IPv4/IPv6 address or CIDR prefix to look up (e.g. 8.8.8.8 or 8.8.8.0/24). Required; validated as an IP or CIDR before any query. | |
| routeServer | No | Routing data source. Only bgpview is implemented; route-views and ripe-ris fall back to BGPView. | bgpview |
| showAlternativePaths | No | Include up to three upstream/alternative AS paths in the result. | |
| showRouteAttributes | No | Include path-analysis attributes (hop count, geographic path, diversity). | |
| resolveASNNames | No | Resolve AS numbers to organisation names in the asNames map. | |
| showPathLatency | No | Include estimated path-latency analysis (best-effort; latency is not measured). | |
| worker_id | No | Optional registered healthy worker peer ID. Omit to use the default master-server behavior. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| primaryRoute | No | Best-matching route, or null if no route was found. | |
| alternativePaths | No | Up to three upstream AS paths (when showAlternativePaths is true). | |
| routeCount | No | Total routes found (primary plus alternatives). | |
| pathAnalysis | No | Path metrics (present when showRouteAttributes or showPathLatency is true). | |
| routeServer | No | Routing data source actually used. | |
| error | No | Present only on failure (400/500): describes the error. |