Traffic Summary Card

Returns current-period totals, equivalent previous-period totals, and percentage deviations for all core traffic metrics.

curl -X POST "https://api.5centscdn.com/v2/analytics/traffic/summary/card" \
  -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",
    "ghi56hash"
  ],
  "granularity": "24h"
}'

import requests
import json

url = "https://api.5centscdn.com/v2/analytics/traffic/summary/card"
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",
    "ghi56hash"
  ],
  "granularity": "24h"
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://api.5centscdn.com/v2/analytics/traffic/summary/card", {
  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",
    "ghi56hash"
  ],
  "granularity": "24h"
})
});

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",
    "ghi56hash"
  ],
  "granularity": "24h"
}`)

    req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/analytics/traffic/summary/card", 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/card')
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",
    "ghi56hash"
  ],
  "granularity": "24h"
}'

response = http.request(request)
puts response.body

{
  "current": {
    "traffic": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "traffic_cached": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "hits": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "requests": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "unique_visitors": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "caching_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    },
    "traffic_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    }
  },
  "previous": {
    "traffic": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "traffic_cached": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "hits": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "requests": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "unique_visitors": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "caching_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    },
    "traffic_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    }
  },
  "deviation": {
    "traffic": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "traffic_cached": {
      "bytes": 1262343731219,
      "formatted": "1.26 TB",
      "percent": "+35.67%"
    },
    "hits": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "requests": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "unique_visitors": {
      "count": 1172166,
      "formatted": "1.172M",
      "percent": "+51.24%"
    },
    "caching_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    },
    "traffic_efficiency": {
      "percent": 0.71,
      "formatted": "+71%"
    }
  }
}

POST

/analytics/traffic/summary/card

POST

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)

X-API-Keystring

Required

API key (sent in header)

Content-Typestring

Required

The media type of the request body

Options: application/json

rstring

Required

Date range in "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss" format (UTC).

resource_typestring

Resource category to filter by. Use all to include all resources (omit resource_hashes when using all).

Options: push, pull, all, livestream

resource_hashesarray

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.

granularitystring

Defines the time interval for data aggregation. Defaults to "24h".

Options: 1m, 5m, 15m, 30m, 1h, 3h, 6h, 12h, 24h

Request Preview

Response

Response will appear here after sending the request

Authentication

header

X-API-Keystring

Required

API Key for authentication. Provide your API key in the header.

Body

application/json

rstring

Required

Date range in "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss" format (UTC).

Example:

2026-01-01 00:00:00 - 2026-01-31 23:59:59

resource_typestring

Resource category to filter by. Use all to include all resources (omit resource_hashes when using all).

Allowed values:pushpullalllivestream

resource_hashesarray

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.

Example:

["abc12hash","def34hash","ghi56hash"]

granularitystring

Defines the time interval for data aggregation. Defaults to "24h".

Allowed values:1m5m15m30m1h3h6h12h24h

Responses

currentobject

Aggregate traffic metrics for a period or resource, including bandwidth, request counts, unique visitors, and efficiency ratios.

trafficobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

traffic_cachedobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

hitsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

requestsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

unique_visitorsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

caching_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

traffic_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

previousobject

Aggregate traffic metrics for a period or resource, including bandwidth, request counts, unique visitors, and efficiency ratios.

trafficobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

traffic_cachedobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

hitsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

requestsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

unique_visitorsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

caching_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

traffic_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

deviationobject

Aggregate traffic metrics for a period or resource, including bandwidth, request counts, unique visitors, and efficiency ratios.

trafficobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

traffic_cachedobject

A bandwidth metric consisting of raw bytes and a human-readable string, with an optional percentage of total.

bytesinteger

Raw byte count for this traffic metric.

formattedstring

Human-readable bandwidth value (e.g. "1.26 TB").

percentstring

Share of the response-level total for this dimension value. Only present in breakdown and line data items.

hitsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

requestsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

unique_visitorsobject

A count metric consisting of a raw integer count and a human-readable string, with an optional percentage of total.

countinteger

Raw integer count for this metric.

formattedstring

Human-readable count value (e.g. "1.172M").

percentstring

Share of the response-level total. Only present in breakdown and line data items.

caching_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

traffic_efficiencyobject

A cache-efficiency or traffic-efficiency ratio expressed as a decimal and a formatted percentage.

percentnumber

Efficiency ratio as a decimal between 0 and 1.

formattedstring

Human-readable formatted percentage value.

Was this page helpful?

curl -X POST "https://api.5centscdn.com/v2/analytics/traffic/summary/card" \ -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", "ghi56hash" ], "granularity": "24h" }'

{ "current": { "traffic": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "traffic_cached": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "hits": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "requests": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "unique_visitors": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "caching_efficiency": { "percent": 0.71, "formatted": "+71%" }, "traffic_efficiency": { "percent": 0.71, "formatted": "+71%" } }, "previous": { "traffic": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "traffic_cached": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "hits": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "requests": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "unique_visitors": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "caching_efficiency": { "percent": 0.71, "formatted": "+71%" }, "traffic_efficiency": { "percent": 0.71, "formatted": "+71%" } }, "deviation": { "traffic": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "traffic_cached": { "bytes": 1262343731219, "formatted": "1.26 TB", "percent": "+35.67%" }, "hits": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "requests": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "unique_visitors": { "count": 1172166, "formatted": "1.172M", "percent": "+51.24%" }, "caching_efficiency": { "percent": 0.71, "formatted": "+71%" }, "traffic_efficiency": { "percent": 0.71, "formatted": "+71%" } } }