---
title: "/2026-01/placements/report"
method: POST
path: "/2026-01/placements/report"
tags: ["Analytics"]
---

# /2026-01/placements/report

`POST /2026-01/placements/report`

Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.
<br/><br/>
This endpoint supports data retrieval for up to three months in the past.

## Request body

- PlacementsReportQueryMessageListRequest — A top-level object that encapsulates a Criteo API request for several value objects.
  - `data` PlacementsReportQueryMessageResource[], nullable
    - `attributes` PlacementsReportQueryMessage — This is the message defining the query for Placements report
      - `adsetIds` string, nullable — Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.
      - `advertiserIds` string, required — List of advertiser IDs to report on, provided as a single comma-separated string (e.g., "123,456,789"). The advertisers must already exist. If empty, all advertisers will be used.
      - `campaignIds` string, nullable — Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.
      - `currency` string, required — The currency used for the report. ISO 4217 code (three-letter capitals).
      - `dimensions` string[], required — List of dimensions for the report. At least one dimension should be provided.
      - `disclosed` boolean — Optionally returns disclosed or undisclosed placements.
      - `endDate` string, date-time, required — End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.
      - `environment` 'Web' | 'Android' | 'Ios', nullable — Optional type of environment to filter on. If empty, all environments will be included.
      - `format` 'csv' | 'excel' | 'xml' | 'json' — Optional file format of the generated report.
      - `metrics` string[], required — List of metrics for the report. At least one dimension should be provided.
      - `placement` string, nullable — Optional filter on a specific placement domain name. If empty, all placements will be included.
      - `startDate` string, date-time, required — Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.
      - `timezone` string, nullable — Optional timezone used for the report. Timezone Database format (Tz).
    - `type` string, nullable — Type of the resource.

## Response `200`

Success

- string, binary

---

[API](https://skmtc.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)