This data call returns information about neigbouring ASNs of a queried ASN extended with history.
https://stat.ripe.net/data/asn-neighbours-history/data.<format>?<parameters>
e.g. https://stat.ripe.net/data/asn-neighbours-history/data.json?resource=AS1205
Parameters
Key
|
Value
|
Info
|
Required
|
resource
|
ASN for this query
|
This is the ASN the neighbours are shown for.
|
YES
|
starttime
|
ISO8601 or Unix timestamp
|
Defines the query starttime for the query
|
NO - if not set it falls back to "endtime - 90 days"
|
endtime
|
ISO8601 or Unix timestamp
|
Defines the query endtime for the query
|
NO - if not set it falls back to the latest available data point
|
max_rows
|
integer
|
Defines the limit of neighbours to be included in the result, e.g. max_rows=50 means the result will be truncated to 50 neighbours. Has not effect if there are less neighbours anyway.
|
NO - default: 1800
|
Output
Data
Key
|
Info
|
neighbours
|
Contains neighbours included in the result with the additional timelines when they were valid
neighbour |
holds the AS number of the neighbour AS |
timelines |
holds timelines for when this AS was seen as a neighbour |
|
query_starttime/query_endtime
|
Holds the start and endtime for this query
|
latest_time
|
Holds the time until which data is available
|
resource
|
Defines the resource used for the query
|
Example
"data": {
latest_time: "2012-09-20T08:00:00",
"neighbours": [
{
"neighbour": 42,
"timelines": [
{
"endtime": "2012-07-23T08:00:24",
"starttime": "2012-07-22T08:00:00"
},
{
"endtime": "2012-07-31T16:00:11",
"starttime": "2012-07-23T20:00:02"
},
{
"endtime": "2012-08-31T16:00:12",
"starttime": "2012-08-01T08:00:03"
},
{
"endtime": "2012-09-20T08:00:00",
"starttime": "2012-09-01T08:00:03"
}
]
},
...
],
"query_endtime": "2012-09-20T08:00:00",
"query_starttime": "2012-07-22T08:00:00",
"resource": "3333"
},