Ad InsertionGet Tracking Report

Get Tracking Report

Custom Plan Returns aggregate and time-series ad insertion delivery metrics for a date range. Requires the Advanced Analytics add-on for filters beyond crid/session_id. The response is capped at 1,440 time-series data points, so the selected range must not exceed granularity * 1440 minutes.

curl -X GET "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/tracking/reports?r=2026-01-01%2000%3A00%3A00%20-%202026-01-31%2023%3A59%3A59&crid=example_string&session_id=example_string&client_ip=example_string&os=example_string&browser=example_string&content_id=example_string&continent_geoname_id=123&country_geoname_id=123&subdivision1_geoname_id=123&subdivision2_geoname_id=123&city_geoname_id=123&granularity=1440" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "result": "success",
  "message": "example_string",
  "summary": {
    "from": "2026-01-01T00:00:00Z",
    "to": "2026-01-31T23:59:59Z",
    "impressions": 96210,
    "starts": 95800,
    "first_quartiles": 91000,
    "midpoints": 85000,
    "third_quartiles": 78000,
    "completes": 68500,
    "view_rate_25": 94.6,
    "view_rate_50": 88.3,
    "view_rate_75": 81.1,
    "completion_rate": 71.2,
    "unique_sessions": 42130
  },
  "data": [
    {
      "time": "2026-01-15T10:00:00Z",
      "impressions": 512,
      "starts": 508,
      "first_quartiles": 480,
      "midpoints": 450,
      "third_quartiles": 410,
      "completes": 360
    }
  ]
}
GET
/streams/pull/{streamid}/adinsertion/tracking/reports
GET
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)

path
streamidinteger
Required

Numeric stream ID.

query
rstring

Date-time range: YYYY-MM-DD HH:MM:SS - YYYY-MM-DD HH:MM:SS

query
cridstring

Filter to a specific creative ID.

query
session_idstring

Filter to a specific ad insertion playback session ID.

query
client_ipstring

Filter to a specific viewer client IP. Requires the Advanced Analytics add-on.

query
osstring

Filter to a specific viewer operating system. Requires the Advanced Analytics add-on.

query
browserstring

Filter to a specific viewer browser. Requires the Advanced Analytics add-on.

query
content_idstring

Filter to a specific content ID. Requires the Advanced Analytics add-on.

query
continent_geoname_idinteger

Filter to a specific continent geoname ID. Requires the Advanced Analytics add-on.

query
country_geoname_idinteger

Filter to a specific country geoname ID. Requires the Advanced Analytics add-on.

query
subdivision1_geoname_idinteger

Filter to a specific first-level subdivision geoname ID. Requires the Advanced Analytics add-on.

query
subdivision2_geoname_idinteger

Filter to a specific second-level subdivision geoname ID. Requires the Advanced Analytics add-on.

query
city_geoname_idinteger

Filter to a specific city geoname ID. Requires the Advanced Analytics add-on.

query
granularityinteger

Time-bucket size, in minutes.

Options: 1, 5, 10, 15, 30, 60, 180, 360, 720, 1440, 2880, 10080
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.

Path Parameters

streamidinteger
Required

Numeric stream ID.

Query Parameters

rstring

Date-time range: YYYY-MM-DD HH:MM:SS - YYYY-MM-DD HH:MM:SS

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

Filter to a specific creative ID.

session_idstring

Filter to a specific ad insertion playback session ID.

client_ipstring

Filter to a specific viewer client IP. Requires the Advanced Analytics add-on.

osstring

Filter to a specific viewer operating system. Requires the Advanced Analytics add-on.

browserstring

Filter to a specific viewer browser. Requires the Advanced Analytics add-on.

content_idstring

Filter to a specific content ID. Requires the Advanced Analytics add-on.

continent_geoname_idinteger

Filter to a specific continent geoname ID. Requires the Advanced Analytics add-on.

country_geoname_idinteger

Filter to a specific country geoname ID. Requires the Advanced Analytics add-on.

subdivision1_geoname_idinteger

Filter to a specific first-level subdivision geoname ID. Requires the Advanced Analytics add-on.

subdivision2_geoname_idinteger

Filter to a specific second-level subdivision geoname ID. Requires the Advanced Analytics add-on.

city_geoname_idinteger

Filter to a specific city geoname ID. Requires the Advanced Analytics add-on.

granularityinteger

Time-bucket size, in minutes.

Allowed values:15101530601803607201440288010080

Responses

resultstring
Allowed values:successerror
messagestring
summaryobject
dataarray

Per-time-bucket metrics for the requested range and granularity.