Data

The data endpoint allows you to pull a desired set of rows from a specific report. You can specify the reportIds (retrieved via the reports endpoint), then include your desired:

  • Metrics, offering volume, performance, and comparative performance details. (Learn more)
  • Dimensions, including media partners, TV categories, demographics, geographies, day/time parts, stores, and more. (Learn more)
  • Filters, limiting the dimensions/values shown. Operators can be applied (i.e. IN, NOT_IN, BETWEEN, LIKE, GREATER_THAN, LESS_THAN).
📘

Examples available!

Click the Examples dropdown in the codebox to the right. We have prepared a number of templates that should help you get started!

These examples will be applied to the language/framework of your choice.

Body Params
reportIds
array of strings
required

Array of Placement or Custom Report IDs. If a single reportId is specified, the result will be returned synchronously. If multiple reportIds are specified, the result will be returned asynchronously.

reportIds*
metrics
array of objects
required

The metrics or columns to retrieve from the specified reports.

metrics*
filters
array of objects

Filters to apply to your query.

filters
Response

Language
Credentials
Basic
base64
:
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json