Ad InsertionExport Tracking Events

Export Tracking Events

Custom Plan Downloads raw VAST tracking beacon events for a date range as a CSV file. Limited to 25,000 matching rows.

curl -X GET "https://api.5centscdn.com/v2/streams/pull/123/adinsertion/tracking/events/export?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&event_type=impression" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{}
GET
/streams/pull/{streamid}/adinsertion/tracking/events/export
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
Options: impression, start, firstQuartile, midpoint, thirdQuartile, complete
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.

event_typestring
Allowed values:impressionstartfirstQuartilemidpointthirdQuartilecomplete

Responses

CSV file of matching rows.