Looking Glass

This data call returns information commonly coming from a Looking Glass. The data is based on a data feed from the RIPE NCC's network of BGP route collectors (RIS, see https://www.ripe.net/data-tools/stats/ris for more information).
The data processing usually happens with a small delay and can be considered near real-time.
The output is structured by collector node (RRC) accompanied by the location and the BGP peers which provide the routing information.

https://stat.ripe.net/data/looking-glass/data.<format>?<parameters> 

e.g. https://stat.ripe.net/data/looking-glass/data.json?resource=140.78.0.0/16

Parameters

Key Value Info Required
resource A prefix or an IP address. Prefixes need to match exactly a prefix found in the routing data. If given as IP address, the data call will try to find the encompassing prefix for the IP address. YES
look_back_limit Defines the cut-off threshold in seconds for the recency of the entries. Any results older than the cut-off threshold are not returned. This is useful when data is delayed and should not show up. NO - default is 86400 (= 24 hours)

Output

Data

Key Info
rrcs There is one entry for each collector node (RRC) that provides data for the given input resource. Each RRC entry holds the location and the ID of the RRC together with the list of BGP peer information.
The BGP peer information contains:
  • origin: type of BGP origin
  • last_updated: the timestamp when this route was last changed
  • lastest_time: the timestamp when this route was last confirmed
  • as_path: the path of ASNs seen for this route
  • community: BGP community information for this route
  • asn_orgin: the originating ASN for the matched prefix
  • prefix: the matched prefix based on the query input resource
  • next_hop: the next hop from the perspective of this peer
  • peer: IP address of the peer interface
latest_time Provides info on how recent the data is.

Example

  {
    "messages": [],
    "see_also": [],
    "version": "2.1",
    "data_call_status": "supported",
    "cached": false,
    "data": {
        "rrcs": [
            {
                "rrc": "RRC06",
                "location": "Tokyo, Japan",
                "peers": [
                    {
                        "asn_origin": 3333,
                        "as_path": "2497 6939 3333",
                        "community": "",
                        "last_updated": "2020-07-14T16:11:25",
                        "prefix": "2001:67c:2e8::/48",
                        "peer": "2001:200:0:fe00::9c1:0",
                        "origin": "IGP",
                        "next_hop": "2001:200:0:fe00:0:0:9c1:0",
                        "latest_time": "2020-09-10T14:14:32"
                    },
                    {
                        "asn_origin": 3333,
                        "as_path": "4777 6939 3333",
                        "community": "",
                        "last_updated": "2020-04-01T03:49:44",
                        "prefix": "2001:67c:2e8::/48",
                        "peer": "2001:200:0:fe00::12a9:0",
                        "origin": "IGP",
                        "next_hop": "2001:200:0:fe00:0:0:12a9:0",
                        "latest_time": "2020-09-10T14:14:07"
                    },
                    {
                        "asn_origin": 3333,
                        "as_path": "25152 6939 3333",
                        "community": "",
                        "last_updated": "2020-07-14T16:12:16",
                        "prefix": "2001:67c:2e8::/48",
                        "peer": "2001:200:0:fe00::6249:0",
                        "origin": "IGP",
                        "next_hop": "2001:200:0:fe00:0:0:6249:0",
                        "latest_time": "2020-09-10T14:14:34"
                    }
                ]
            },
              ...
              {
                "asn_origin": 3333,
                "as_path": "328608 6939 3333",
                "community": "",
                "last_updated": "2020-09-09T21:01:51",
                "prefix": "2001:67c:2e8::/48",
                "peer": "2001:43f8:6d0::10:12",
                "origin": "IGP",
                "next_hop": "2001:43f8:6d0:0:0:0:10:12",
                "latest_time": "2020-09-10T14:14:30"
            },
            {
                "asn_origin": 3333,
                "as_path": "37271 6939 3333",
                "community": "37271:1005 37271:2150 37271:2154 37271:3826 37271:4004 37271:5002 37271:5200 37271:5207",
                "last_updated": "2020-08-18T18:51:59",
                "prefix": "2001:67c:2e8::/48",
                "peer": "2c0f:fa90:200:3:6::e",
                "origin": "IGP",
                "next_hop": "2c0f:fa90:200:3:6:0:0:e",
                "latest_time": "2020-09-10T14:14:08"
            }
        ]
    }
],
"query_time": "2020-09-10T14:14:36",
"latest_time": "2020-09-10T14:14:11",
"parameters": {
    "resource": "2001:67c:2e8::/48"
}
},
"query_id": "20200910141436-75f0673f-bc7a-4fed-94f7-a4454d27cdc2",
"process_time": 76,
"server_id": "app122",
"build_version": "live.2020.9.10.103",
"status": "ok",
"status_code": 200,
"time": "2020-09-10T14:14:36.432143"
}
  }

deprecated - n.a.

-

upcoming - n.a.