ASN Neighbours

This data call shows information on the network neighbours for a given ASN. This includes statistical information as well as the list of observed ASN neighbours. 

    https://stat.ripe.net/data/asn-neighbours/data.<format>?<parameters>

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&starttime=2011-12-01T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN YES
starttime ISO8601 or Unix timestamp Defines the query time for the query.
In this version of the data call, the semantics of the query parameters have been changed to the previous 3.0 version in the way that the end time is no longer taken into account. The returned results are for a specific point in time rather than a time period, which makes it more precise.
If not set, the start time will be set to the latest available data point. 		NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of "left", "right" and "unique" neighbours found. Neighbours that have been seen as left neighbours, but only as direct peers of one of our route collectors (RIS collectors), are flagged "uncertain" because our own peering with this ASN could artifically include it as neigbour. ASNs that have been seen as a left neighbour and not as a direct peer with RIS are not flagged as "uncertain".
neighbours Contains all neighbours that were seen at the defined timestamp.
asn Defines the neighbouring ASN.
type Shows information about the neighbour's position ("left" or "right"). The type "uncertain" is explained in the "neighbour_counts" section.
power This represents the number of AS paths ("path count") containing this combination of ASN neighbours with the stated type ("left"/"right"). For compatibility reasons, this attribute has kept its name but will change with the next major release.
v4_peers/v6_peers Shows the total number of (full-table) peers, grouped by IP version, seeing this neighbour/position combination. Accumulated number of routes (prefixes) seen by peers. If all peers see the same route (prefix + AS path) then this number is equal to peers * routes. It is an indicator of how widely used this AS path combination is.
query_startime/query_endtime For reasons explained in the input parameter section, the query_starttime and query_endtime refer to the same point in time that the result is valid for.
resource Defines the resource used for the query.

Example

                data: {
                    neighbour_counts: {
                        left: 1,
                        right: 0,
                        uncertain: 1,
                        unique: 2
                    },
                    neighbours: [
                        {
                            asn: 1853,
                            power: 79,
                            type: "left",
                            v4_peers: 267,
                            v6_peers: 7
                        },
                        {
                            asn: 35369,
                            power: 1,
                            type: "uncertain",
                            v4_peers: 8,
                            v6_peers: 0
                        }
                    ],
                    query_endtime: "2013-11-05T00:00:00",
                    query_starttime: "2013-11-05T00:00:00",
                    resource: "1205"
                },

deprecated - 3.0

This data call returns information about the ASNs that neigbour the queried ASN. 

            https://stat.ripe.net/data/asn-neighbours/data.<format>?<parameters>

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&starttime=2011-12-01T12:00:00&endtime=2011-12-06T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN. YES
start-/endtime ISO8601 or Unix timestamp Defines the start and end time for the query. NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of left, right and unique neighbours found.
neighbours Contains all neighbours that were seen at the defined timestamp.
asn Defines the neighbouring ASN.
type Shows information about the neighbour's position ("left" or "right").
power Shows how many times this neighbour with this type ("left"/"right") was seen in the routing data.
query_startime/query_endtime The start and end time the query results are valid for.
resource Defines the resource used for the query.

Example

                        "data": {
                            "neighbour_counts": {
                                "left": 2, 
                                "right": 0, 
                                "unique": 2
                            }, 
                            "neighbours": [
                                {
                                    "asn": 35369, 
                                    "power": 8, 
                                    "type": "left"
                                }, 
                                {
                                    "asn": 1853, 
                                    "power": 270, 
                                    "type": "left"
                                }
                            ], 
                            "resource": "1205", 
                            "query_starttime": "2012-02-15T11:30:05",
                            "query_endtime": "2012-02-15T11:30:05"
                        },

upcoming - 4.0

This data call shows information on the network neighbours for a given ASN. This includes statistical information, the list of observed ASN neighbours and, depending on the level of detail, the ASN paths that this data is based on. 

                https://stat.ripe.net/data/asn-neighbours/data.<format>?<parameters>

e.g. https://stat.ripe.net/data/asn-neighbours/data.json?resource=AS1205&query_time=2011-12-01T12:00:00

Parameters

Key Value Info Required
resource ASN for this query The data call will return all neighbours found for this ASN. YES
lod 0 or 1 Defines how many details are returned in the result. See the output section for further explanation. NO
query_time ISO8601 or Unix timestamp Defines the query time for the query.
If not set, the start time will be set to the latest available data point. 		NO

Output

Data

Key Info
neighbour_counts Shows total counts for the neighbours, including the total number of "left", "right" and "unique" neighbours found. Neighbours that have been seen as left neighbours, but only as direct peers of one of our route collectors (RIS collectors), are flagged "uncertain" because our own peering with this ASN could artifically include it as neigbour. ASNs that have been seen as a left neighbour and not as a direct peer with RIS are not flagged as "uncertain".
neighbours Contains all neighbours that were seen at the defined point in time.

Details are only returned if the level of detail ("lod") is 1:
path_count States in how many paths this neighbour/position combination has been seen.
paths Contains details about the paths, including the RRC location where it has been seen and by how many (full-table) peers.
peeer_count Summarizes the number of peers seeing this neighbour/position combination.
asn Defines the neighbour ASN.
position Shows information about the neighbour's position ("left" or "right"). The type "uncertain" is explained in the "neighbour_counts" section.
path_count Shows how many times this neighbour with this position ("left"/"right" or "uncertain") was seen in an ASN path.
peer_count Shows the total number of (full-table) peers, grouped by IP version, seeing this neighbour/position combination.
query_time Reflects the time the data is valid for.
resource Defines the resource used for the query.

Example

                data: {
                    latest_time: "2013-11-05T00:00:00",
                    lod: "1",
                    neighbour_counts: {
                        left: 1,
                        right: 0,
                        uncertain: 1,
                        unique: 2
                    },
                    neighbours: [
                    {
                        asn: 1853,
                        details: {},
                        position: "left"
                    },
                    {
                    asn: 35369,
                    details: {
                    path_count: 1,
                        paths: [
                                {
                                    locations: {
                                        v4: [
                                            {
                                                location: "rrc05",
                                                peer_count: 8
                                            }
                                            ],
                                        v6: [ ]
                                    },
                                    path: "35369 1205"
                                }
                                ],
                                peer_count: {
                                    v4: 8,
                                    v6: 0
                                }
                            },
                                position: "uncertain"
                            }
                        ],
                        query_time: "2013-11-05T00:00:00",
                        resource: "1205"
                    },