Conviva Connect

Welcome to the Conviva APIs and data to guide you through Conviva Connect, Conviva API implementation, and Session Source Data (SSD).

Conviva Connect

Conviva Connect enables scheduled delivery of Conviva data, including content and ad session-level information for every video play or attempted play in a given day. It also allows to choose traffic rule accounts for content session data pipelines. To enable Conviva Connect, reach out to your Conviva representative or contact Conviva Support.

• Content Summary

• SPI Calculation based on Content Summary

• Content Summary (Parquet)

• Ad Summary

• Identity Summary

Conviva APIs

Conviva APIs provide programmatic access to the real-time and historical data visualized in the Conviva Pulse web portal. You can use this interface to build custom dashboards, extract data for warehouse purposes, or ingest data into third-party tools. These APIs can be easily integrated into your applications and provide HTTP response codes to indicate API errors.

VSI APIs:

• Metrics v3 API

  Metics v3 API Reference

• Sessions v3 API

  Sessions v3 API Reference

• Bulk Filters API

  Bulk Filters API Reference

• AI Alerts API

  AI Alerts API Reference

• Precision Policy API

  Precision API Reference

• PII Opt-Out API

DPI APIs:

• DPI Flow API

• Flow API Quick Start

 

 

Access Limits for Conviva APIs. Rate limits are based on the number of requests and applied filters. A 500 concurrent request limit is reached with either 100 requests with 5 filters or 500 requests with 1 filter.

API	Endpoint	Access Limit
Global	all API endpoints	3000 requests per 5 minutes per IP address
Real-Time Metrics V3	/insights/3.0/real-time-metrics	500 concurrent requests per c3 account per minute
Historical Metrics V3	/insights/3.0/metrics	400 concurrent requests per c3 account per minute (Shared)
Sessions V3	/insights/3.0/sessions/*
Sessions V2	/insights/2.*/sessions/*
Viewer Module V2	/insights/2.*/viewer/metrics
Real-Time Metrics V2	/insights/2.*/metrics.json	100 concurrent requests per c3 account per minute (requests with 5 filters, max 500 filter-requests per minute)
Metrics V2	/insights/2.*/metrics.json	64 concurrent requests per c3 account per minute (requests with 5 filters, max 320 filter-requests per minute)
Precision Policy API	POST /precision/v1.*/policies/activate	40 concurrent requests per c3 account per minute up to 160 requests per hour
Precision Policy API	POST /precision/v1.*/policies/reorder	40 concurrent requests per c3 account per minute up to 160 requests per hour

 

Note: If the access limit is exceeded, API servers throttle the requests and return HTTP 429 Too Many Requests error response.
For more information about rate plans, please contact your Conviva representative.

 

For Conviva application API User and Reference Guides, refer to developer.conviva.com.

 

Additional API guides:

Conviva APIs

Session Source Data (SSD)

SSD is a daily offline historical log that provides session-level information for every video play or attempted play in a given day.

• Session Source Data
• Session Source Data (Parquet)
• Ads Session Source Data

 

API Rate Limits Access Limits API Rate Limits