Traffic Summary Trend

Returns per-time-bucket traffic metrics for the selected date range, along with period totals and granularity metadata.

curl -X POST "https://api.5centscdn.com/v2/analytics/traffic/summary/line" \
  -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": "1h"
}'

import requests
import json

url = "https://api.5centscdn.com/v2/analytics/traffic/summary/line"
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": "1h"
}

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

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

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

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

{
  "period": {
    "current": {
      "from": "2026-01-01T00:00:00Z",
      "to": "2026-01-31T23:59:59Z"
    },
    "previous": {
      "from": "2025-12-01T00:00:01Z",
      "to": "2026-01-01T00:00:00Z"
    }
  },
  "current": {
    "-": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "BYPASS": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "MISS": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "HIT": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "STALE": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "EXPIRED": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "UPDATING": {
      "count": 1172166,
      "formatted": "1.172M"
    }
  },
  "previous": {
    "-": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "BYPASS": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "MISS": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "HIT": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "STALE": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "EXPIRED": {
      "count": 1172166,
      "formatted": "1.172M"
    },
    "UPDATING": {
      "count": 1172166,
      "formatted": "1.172M"
    }
  },
  "deviation": {
    "-": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "BYPASS": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "MISS": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "HIT": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "STALE": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "EXPIRED": {
      "percent": -0.08,
      "formatted": "-8%"
    },
    "UPDATING": {
      "percent": -0.08,
      "formatted": "-8%"
    }
  }
}

POST

/analytics/traffic/summary/line

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.

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.

Allowed values:1m5m15m30m1h3h6h12h24h

Responses

periodobject

Date range boundaries for the current and previous comparison periods.

currentobject

Start and end timestamps for the selected (current) period.

fromstring

Start timestamp of the current period (ISO 8601 UTC).

tostring

End timestamp of the current period (ISO 8601 UTC).

previousobject

Start and end timestamps for the equivalent preceding period.

fromstring

Start timestamp of the previous period (ISO 8601 UTC).

tostring

End timestamp of the previous period (ISO 8601 UTC).

currentobject

Request counts keyed by cache status. Known statuses include HIT, MISS, EXPIRED, BYPASS, STALE, UPDATING, "-".

-object

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

BYPASSobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

MISSobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

HITobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

STALEobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

EXPIREDobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

UPDATINGobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

previousobject

Request counts keyed by cache status. Known statuses include HIT, MISS, EXPIRED, BYPASS, STALE, UPDATING, "-".

-object

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

BYPASSobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

MISSobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

HITobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

STALEobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

EXPIREDobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

UPDATINGobject

Request count for a single cache status.

countinteger

Raw request count for this cache status.

formattedstring

Human-readable request count for this cache status.

deviationobject

Per-status period-over-period deviation values showing relative change for each cache status.

-object

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

BYPASSobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

MISSobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

HITobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

STALEobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

EXPIREDobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

UPDATINGobject

Period-over-period change for a single cache status.

percentnumber

Relative change as a decimal. Negative values indicate a decrease, positive values indicate an increase.

formattedstring

Human-readable change string showing the percentage shift (e.g. "-8%").

Was this page helpful?

curl -X POST "https://api.5centscdn.com/v2/analytics/traffic/summary/line" \ -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": "1h" }'

{ "period": { "current": { "from": "2026-01-01T00:00:00Z", "to": "2026-01-31T23:59:59Z" }, "previous": { "from": "2025-12-01T00:00:01Z", "to": "2026-01-01T00:00:00Z" } }, "current": { "-": { "count": 1172166, "formatted": "1.172M" }, "BYPASS": { "count": 1172166, "formatted": "1.172M" }, "MISS": { "count": 1172166, "formatted": "1.172M" }, "HIT": { "count": 1172166, "formatted": "1.172M" }, "STALE": { "count": 1172166, "formatted": "1.172M" }, "EXPIRED": { "count": 1172166, "formatted": "1.172M" }, "UPDATING": { "count": 1172166, "formatted": "1.172M" } }, "previous": { "-": { "count": 1172166, "formatted": "1.172M" }, "BYPASS": { "count": 1172166, "formatted": "1.172M" }, "MISS": { "count": 1172166, "formatted": "1.172M" }, "HIT": { "count": 1172166, "formatted": "1.172M" }, "STALE": { "count": 1172166, "formatted": "1.172M" }, "EXPIRED": { "count": 1172166, "formatted": "1.172M" }, "UPDATING": { "count": 1172166, "formatted": "1.172M" } }, "deviation": { "-": { "percent": -0.08, "formatted": "-8%" }, "BYPASS": { "percent": -0.08, "formatted": "-8%" }, "MISS": { "percent": -0.08, "formatted": "-8%" }, "HIT": { "percent": -0.08, "formatted": "-8%" }, "STALE": { "percent": -0.08, "formatted": "-8%" }, "EXPIRED": { "percent": -0.08, "formatted": "-8%" }, "UPDATING": { "percent": -0.08, "formatted": "-8%" } } }