Fast DNS Traffic Reporting API v1

Retrieve DNS hit information to monitor traffic in real time.

Learn more:


Overview

Welcome to Akamai’s Enhanced DNS service. Enhanced DNS is designed to integrate easily with your existing DNS infrastructure to provide a secure, high performance, highly available and scalable solution for DNS hosting. As part of this service, Akamai runs name servers in multiple networks and in many geographic locations that are capable of resolving queries for your zones. Akamai’s IP Anycast technology is also capable of providing an unprecedented level of reliability and performance for name resolution.

This report is based on the logs retrieved from all DNS Edge Servers. Because it takes some time to retrieve and process the logs, the most recent data is estimated based on a sample of your traffic. It is normal for this estimated, real-time data to be incomplete resulting in gaps in the estimated data set, depending on the samples aggregated for that time frame. These gaps disappear once the logs are completed, aggregated and shown under historical data. The window for this estimation is usually the past 4–5 hours. If estimated data is included in the report, the start of the estimation data window displays above the columns of the report: Estimated data start date/time: Each row represents the total number of DNS requests, as well as the total number of NXDOMAIN responses for a five-minute period.

Example request

GET /data-dns/v1/traffic/example.com?start=20130909&start_time=00:00&end=20130909&end_time=01:00

START DATE/TIME,ALL DNS HITS,NXDOMAIN HITS
09/09/2013 00:00 GMT,9199,145
09/09/2013 00:05 GMT,8035,25
09/09/2013 00:10 GMT,7929,20
09/09/2013 00:15 GMT,9433,157
09/09/2013 00:20 GMT,8025,35
09/09/2013 00:25 GMT,8469,33
09/09/2013 00:30 GMT,9540,140
09/09/2013 00:35 GMT,8118,23
09/09/2013 00:40 GMT,8094,26
09/09/2013 00:45 GMT,9771,138
09/09/2013 00:50 GMT,8104,17
09/09/2013 00:55 GMT,8167,30
09/09/2013 01:00 GMT,9173,135

Resources

This section provides details on the API’s URL operation.

API summary

Operation Method Endpoint
Get Traffic Report GET /data-dns/v1/traffic/{zone}{?start,start_time,end,end_time,end_time,time_zone,include_estimates}

Get traffic report

GET /data-dns/v1/traffic/{zone}{?start,start_time,end,end_time,end_time,time_zone,include_estimates}

Example: /data-dns/v1/traffic/example.com?start=20131231&start_time=00:30&end=20140101&end_time=14:30&end_time&time_zone=example.com=GMT–08%3A00&include_estimates=false

Parameter Type Sample Description
Required
end String 20140101 End date, in yyyymmdd format.
end_time String 14:30 End time, in HH:mm format.
start String 20131231 Start date, in yyyymmdd format.
start_time String 00:30 Start time, in HH:mm format.
zone String example.com Name of Zone.
Optional
include_estimates Boolean false Flag to include estimated data.
time_zone String GMT-08%3A00 Timezone to use when formatting result set.

Status 200 text/csv

Response:

START DATE/TIME,ALL DNS HITS,NXDOMAIN HITS
09/09/2013 00:00 GMT,9199,145
09/09/2013 00:05 GMT,8035,25
09/09/2013 00:10 GMT,7929,20
09/09/2013 00:15 GMT,9433,157
09/09/2013 00:20 GMT,8025,35
09/09/2013 00:25 GMT,8469,33
09/09/2013 00:30 GMT,9540,140
09/09/2013 00:35 GMT,8118,23
09/09/2013 00:40 GMT,8094,26
09/09/2013 00:45 GMT,9771,138
09/09/2013 00:50 GMT,8104,17
09/09/2013 00:55 GMT,8167,30
09/09/2013 01:00 GMT,9173,135