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).

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* ADD string

metrics

array of objects

required

The metrics or columns to retrieve from the specified reports.

metrics* ADD object

filters

array of objects

Filters to apply to your query.

filters ADD object

``200 200

Sample Report, FullPending

result

object

lastUpdateDate

string

data

object

data object

{
  "result": {
    "lastUpdateDate": "2022-02-04",
    "data": {
      "columns": [
        {
          "name": "reportId",
          "fieldType": "REPORT_ID"
        },
        {
          "name": "impressions",
          "fieldType": "METRIC"
        },
        {
          "name": "reach",
          "fieldType": "METRIC"
        },
        {
          "name": "frequency",
          "fieldType": "METRIC"
        },
        {
          "name": "spend",
          "fieldType": "METRIC"
        },
        {
          "name": "cvr",
          "fieldType": "METRIC"
        },
        {
          "name": "visits",
          "fieldType": "METRIC"
        },
        {
          "name": "cpv",
          "fieldType": "METRIC"
        },
        {
          "name": "lift",
          "fieldType": "METRIC"
        },
        {
          "name": "liftConfidence",
          "fieldType": "METRIC"
        },
        {
          "name": "behavioralLift",
          "fieldType": "METRIC"
        },
        {
          "name": "behavioralLiftConfidence",
          "fieldType": "METRIC"
        }
      ],
      "rows": [
        {
          "values": [
            "demo-id-1",
            543554,
            23071,
            23.56,
            6526.91,
            0.8252,
            448516,
            0.01,
            0.5051,
            0.99,
            null,
            null
          ]
        }
      ]
    }
  }
}