API v1 Documentation

DNS History Request

http://api.completedns.com/v1/ns-history/youtube.com?key=YOUR_API_KEY

You can find the API key in your account, in the API section.

JSON Encoded Response

Headers

..
Content-Type:application/json
Date:Mon, 10 Oct 2016 20:13:12 GMT
Host:..
requestsLeft:994 #shows how many reports are left
..

Response

{
  "drops": 0,
  "changes": 6,
  "years": "11",
  "data": [
    [
      "2009-01-01",
      {
        "type": "ns_change",
        "nameservers": [
          [
            "added_ns",
            "ns1.google.com"
          ],
          [
            "deleted_ns",
            "ash-ns1.ash.youtube.com"
          ],
          //more
        ]
      }
    ],
    //more
  ],
  "supported": true
}

drops: how many times domain was dropped (nameservers removed).

changes: how many changes we've recorded.

years: years since the first event recorded.

data: holds the recorded events.

 ..
 "data": [
    [
      "2009-01-01", //when the change was recorded
      {
        //available types:
        //started_tracking
        //ns_change
        //new_domain
        //deleted_domain
        "type": "ns_change",
        "nameservers": [ //changes happened on that date
          [
            "added_ns",
            "ns1.google.com"
          ],
          ..
          [
            "deleted_ns",
            "ash-ns1.ash.youtube.com"
          ]
        ]
      }
    ],
 ]
 ..