Traffic Summary
Returns aggregate traffic metrics for the selected date range.
curl -X POST "https://api.5centscdn.com/v2/analytics/traffic/summary" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
"resource_type": "push",
"resource_hashes": [
"abc12hash",
"def34hash"
],
"granularity": "1h"
}'
import requests
import json
url = "https://api.5centscdn.com/v2/analytics/traffic/summary"
headers = {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
data = {
"r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
"resource_type": "push",
"resource_hashes": [
"abc12hash",
"def34hash"
],
"granularity": "1h"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api.5centscdn.com/v2/analytics/traffic/summary", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
},
body: JSON.stringify({
"r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
"resource_type": "push",
"resource_hashes": [
"abc12hash",
"def34hash"
],
"granularity": "1h"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
"resource_type": "push",
"resource_hashes": [
"abc12hash",
"def34hash"
],
"granularity": "1h"
}`)
req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/analytics/traffic/summary", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.5centscdn.com/v2/analytics/traffic/summary')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
request.body = '{
"r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
"resource_type": "push",
"resource_hashes": [
"abc12hash",
"def34hash"
],
"granularity": "1h"
}'
response = http.request(request)
puts response.body
{
"summary": {
"traffic": {
"bytes": 1262343731219,
"formatted": "1.26 TB"
},
"traffic_cached": {
"bytes": 864713098005,
"formatted": "864.71 GB"
},
"hits": {
"count": 1172166,
"formatted": "1.172M"
},
"requests": {
"count": 1646341,
"formatted": "1.646M"
},
"unique_visitors": {
"count": 27056,
"formatted": "27.06k"
},
"caching_efficiency": {
"percent": 0.71,
"formatted": "+71%"
},
"traffic_efficiency": {
"percent": 0.69,
"formatted": "+69%"
}
}
}
/analytics/traffic/summary
Target server for requests. Edit to use your own host.
API key (sent in header)
The media type of the request body
Date range in "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss" format (UTC).
Resource category to filter by. Use all to include all resources (omit resource_hashes when using all).
Array of resource hashes to filter by (from /analytics/traffic/resources). Required when resource_type is push, pull, or livestream. Omit when resource_type is all.
Defines the time interval for data aggregation.
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Provide your API key in the header.
Body
Date range in "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss" format (UTC).
2026-01-01 00:00:00 - 2026-01-31 23:59:59Resource category to filter by. Use all to include all resources (omit resource_hashes when using all).
pushpullalllivestreamArray of resource hashes to filter by (from /analytics/traffic/resources). Required when resource_type is push, pull, or livestream. Omit when resource_type is all.
["abc12hash","def34hash"]Defines the time interval for data aggregation.
1m5m15m30m1h3h6h12h24hResponses
Aggregated traffic totals for the requested period and resource set.
Total bytes transferred across all requests (cached and uncached).
Raw byte count for total traffic.
Human-readable total traffic value.
Total bytes served from cache.
Raw byte count for cache-served traffic.
Human-readable cached traffic value.
Total cache hit request count for the period.
Raw cache hit count.
Human-readable cache hit count.
Total request count including cache hits and misses.
Raw total request count.
Human-readable total request count.
Count of distinct visitor IP addresses for the period.
Raw unique visitor count.
Human-readable unique visitor count.
Ratio of cache hits to total requests.
Caching efficiency as a decimal between 0 and 1.
Human-readable caching efficiency percentage.
Ratio of cached bytes to total traffic bytes.
Traffic efficiency as a decimal between 0 and 1.
Human-readable traffic efficiency percentage.