API Reference

Public HTTP API for the God Mode BGP Looking Glass. No authentication required. All data comes from the RIPE RIS Live BGP feed and is refreshed continuously. Responses are cached briefly by Cloudflare CDN — use Cache-Control: no-cache or add a query string to bypass the edge cache.

Base URL: https://god.ad — All endpoints return JSON. Errors are always {"error": "..."} with an appropriate HTTP status code.

BGP Lookups

GET /lookup/{ip} IP address BGP route lookup

Param	Type	Description
ip	path · string	IPv4 or IPv6 address

curl example

curl https://god.ad/lookup/1.1.1.1

response

{
  "ip": "1.1.1.1",
  "as_info": {
    "asn": 13335,
    "name": "CLOUDFLARENET",
    "country": "US",
    "as_path": "6939 13335"
  },
  "routes": [
    {
      "prefix": "1.1.1.0", "prefix_len": 24,
      "origin_as": 13335, "as_path": "6939 13335",
      "next_hop": "2001:7f8:4::3417:1", "peer": 6939,
      "communities": "13335:10070 13335:19001",
      "timestamp": 1748476800, "is_ipv6": false
    }
  ]
}

GET /asn/{asn} All BGP routes for an ASN

Param	Type	Description
asn	path · u32	AS number — bare integer (e.g. `13335`)

curl example

curl https://god.ad/asn/13335

response

{
  "asn": 13335, "name": "CLOUDFLARENET",
  "country": "US", "route_count": 1482,
  "routes": [ /* same shape as /lookup routes array */ ]
}

GET /stats Route table statistics and live viewer count

curl example

curl https://god.ad/stats

response

{
  "total_routes": 1048931,
  "ipv4_routes": 957204,
  "ipv6_routes": 91727,
  "live_viewers": 3
}

GET /@/ip Caller's public IP address

curl example

curl https://god.ad/@/ip

response

{ "ip": "203.0.113.42" }

Domain Tools

GET /whois/{domain} WHOIS / RDAP domain registration data

Param	Type	Description
domain	path · string	Registered domain name (e.g. `cloudflare.com`)

curl example

curl https://god.ad/whois/cloudflare.com

response

{
  "domain": "cloudflare.com",
  "registrant": "Cloudflare, Inc.",
  "registrar": "SafeNames Ltd",
  "nameservers": ["ns3.cloudflare.com", "ns4.cloudflare.com"],
  "status": ["client transfer prohibited"],
  "created": "1998-09-10T00:00:00Z",
  "expires": "2028-09-09T00:00:00Z",
  "updated": "2024-08-12T00:00:00Z",
  "cached_at": 1748476800
}

GET /ct/{domain} Certificate Transparency log lookup

Param	Type	Description
domain	path · string	Domain name; wildcards allowed (e.g. `*.cloudflare.com`)

curl example

curl https://god.ad/ct/cloudflare.com

response

{
  "domain": "cloudflare.com", "total": 47,
  "certificates": [
    {
      "id": 12345678, "issuer": "E6",
      "issuer_full": "C=US, O=Let's Encrypt, CN=E6",
      "common_name": "cloudflare.com",
      "names": ["cloudflare.com", "www.cloudflare.com"],
      "not_before": "2026-01-01 00:00:00",
      "not_after": "2026-04-01 00:00:00",
      "serial": "03a1b2c3d4e5f6"
    }
  ],
  "issuers": [{ "name": "E6", "count": 31 }]
}

Data sourced from crt.sh (RIPE NCC). Results are not cached when the certificate set is empty; otherwise cached for 1h.

Real-Time Feed

WS /ws/live Real-time BGP update stream

WebSocket connection that streams live BGP route announcements and withdrawals from the RIPE RIS Live feed. Messages are rate-limited to approximately 20 events/second.

JavaScript example

const ws = new WebSocket('wss://god.ad/ws/live');
ws.onmessage = (e) => console.log(JSON.parse(e.data));

announcement event

{ "t": "a", "p": "203.0.113.0/24", "as": 13335, "path": "6939 13335" }

withdrawal event

{ "t": "w", "p": "203.0.113.0/24" }

Fields: t = type (announce / withdraw), p = prefix, as = origin ASN, path = full AS path string.

Content & Discovery

GET /learn/index.json JSON index of all Learn articles

curl example

curl https://god.ad/learn/index.json

response

{
  "posts": [
    {
      "slug": "what-is-bgp",
      "title": "What is BGP? The Internet's Routing Protocol Explained",
      "description": "Learn how BGP routes traffic across the internet...",
      "category": "BGP & Routing",
      "published": "2026-04-23",
      "url": "https://god.ad/learn/what-is-bgp"
    }
    /* ... 200+ more */
  ]
}

Cached for 5 minutes (300 s-maxage). Posts are in registration order.

GET /learn/feed.xml RSS 2.0 feed of Learn articles

RSS 2.0 feed, sorted by published date descending. Content-Type: application/rss+xml.

curl example

curl https://god.ad/learn/feed.xml

GET /sitemap.xml XML sitemap

Standard sitemap.xml covering all Learn articles, popular view pages, and top-level routes.

See live BGP routing data in action

Open Looking Glass