Ad InsertionList Tracking Events

List Tracking Events

Custom Plan Returns raw VAST tracking beacon events for a date range. Requires the Advanced Analytics add-on for filters beyond crid/session_id.

curl -X GET "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/tracking/events?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&page=1&event_type=impression&order=desc" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "result": "success",
  "message": "example_string",
  "items": [
    {
      "id": "evt_9f21c8",
      "service_id": 10001,
      "session_id": "sess_4a1b2c",
      "ad_break_id": "brk_7e21c9",
      "sequence": 1,
      "crid": "creative-abc123",
      "event_type": "complete",
      "seg": 3,
      "total_segs": 6,
      "beacon_count": 1,
      "beacon_urls": [
        "https://tracking.example.com/complete?crid=creative-abc123"
      ],
      "created_at": "2026-01-15T10:32:14Z"
    }
  ],
  "total": 15230,
  "page": 1,
  "limit": 20,
  "pages": 762
}
GET
/streams/pull/{streamid}/adinsertion/tracking/events
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
event_typestring

Filter to a specific tracking event type.

Options: impression, start, firstQuartile, midpoint, thirdQuartile, complete
query
orderstring

Sort order by event time.

Options: asc, desc
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.

pageinteger
Example:
1
event_typestring

Filter to a specific tracking event type.

Allowed values:impressionstartfirstQuartilemidpointthirdQuartilecomplete
orderstring

Sort order by event time.

Allowed values:ascdesc

Responses

resultstring
Allowed values:successerror
messagestring
itemsarray
totalinteger
pageinteger
limitinteger
pagesinteger