Version 2026.01 of the Criteo Retail Media API is live as of January 20th, 2026 and will be supported until January 27th, 2027. A new Postman collection for 2026.01 is also available in the Criteo Postman workspace.

New SDK ReleaseA new SDK version will be available for the 2026.01 release.

This version introduces new capabilities to Criteo Retail Media API and changes to existing endpoints. This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here. The changes of versions 2026.01 are:

a new base URL,
new authorization controls to the API Authorization,
updates to Sponsored Products line item endpoints, including Conquesting, Ad Scheduling, Automated Bidding, and Flexible Start/End Date Targeting.
new Retailer Configuration endpoints, and
new Reporting endpoints, including Account Level Reporting and Fill Rate Reporting.

New Base URL

With the introduction of this new version, the base URL will now change from the old base URL:

URL

https://api.criteo.com/2025-10/retail-media/{endpoint}

to the new base URL:

URL

https://api.criteo.com/2026-01/retail-media/{endpoint}

What’s New

API Authorization Controls

We are introducing Proof Key for Code Exchange (PKCE), which is a security enhancement to the OAuth 2.0 Authorization Code flow designed for public clients that cannot securely store a client secret. PKCE makes this possible by enabling clients to add a verification step to prevent intercepted authorization codes from being misused. When PKCE is enabled, the authorization (consent) request must include a code_challenge (derived from a client-generated code_verifier) and optionally a code_challenge_method (with S256 recommended), and the subsequent token exchange must include the original code_verifier for validation. PKCE is optional to enable but once enabled, PKCE becomes mandatory for the application, and authorization requests without PKCE parameters will fail.

You can find the documentation for the PKCE OAuth Flow here.

Sponsored Product Line Item Updates

In version 2026.01, we’ve introduced new capabilities to the sponsored products line item endpoints: Conquesting A keyword targeting strategy that allows line items to target search queries associated with competing products relative to the products being promoted. Availability is retailer-dependent and must be explicitly enabled by the retailer. Ad Scheduling Enables time-based delivery controls for line-items, allowing advertisers to schedule when a campaign runs by specific days of the week and hours of the day, rather than running continuously. Ad Scheduling provides greater control over budget allocation, delivery timing, and exposure efficiency. Adaptive CPC Adaptive CPC dynamically adjusts bids in real time based on predicted conversion probability, pacing requirements, and forecasted traffic. This model operates in collaboration with bidding strategies such as Clicks, Conversions, and Revenue by optimizing for overall performance and efficiency. Flexible Start/End Date Timestamps Line items now support dateTimeOffset values, allowing users to specify dates and times according to the time zone of their choice, rather than being restricted to the account-level time zone used in previous stable versions. This update follows the ISO 8601 standard (YYYY-MM-DDThh:mm:ss±hh:mm) to ensure consistent and explicit time zone handling. If a request includes only a date without a dateTimeOffset, the value will be interpreted and submitted in the UTC time zone by default. Together, these features provide advertisers with more precise control over targeting, delivery timing, and bid optimization.

You can find the documentation for the Sponsored Product Line Item endpoints here.

Updated Endpoints

The following new endpoint can be found below:

Verb	Endpoint	Description
POST	`/retail-media/campaigns/:campaignId/auction-line-items`	Create an Open Auction Line item
PUT	`/retail-media/auction-line-items/:lineItemId`	Update a specific Open Auction Line item
GET	`/retail-media/auction-line-items/:lineItemId`	Get a specific Open Auction Line item
GET	`/retail-media/campaigns/:campaignId/auction-line-items`	Get all Open Auction Line items from a specific Campaign

Sample Requests

For POST retail-media/campaigns/{campaignId}/auction-line-items:

curl -L -X POST "https://api.criteo.com/2026-01/retail-media/campaigns/1234567890/auction-line-items" \
    -H "Authorization: Bearer <MY_ACCESS_TOKEN>" \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{
            "data": {
                "attributes": {
                    "name": "Product ABC Sponsored Weekend Conversions",
                    "targetRetailerId": "12345",
                    "status": "draft",
                    "startDate": "2025-09-01T00:00:00-04:00",
                    "endDate": "2025-12-31T23:59:59-04:00",
                    "budget": 1000.0,
                    "monthlyPacing": null,
                    "isAutoDailyPacing": false,
                    "targetBid": null,
                    "maxBid": 5,
                    "bidStrategy": "automated",
                    "optimizationStrategy": "conversion",
                    "flightSchedule": {
                        "legs": [
                            {
                                "dayOfWeek": "Weekends",
                                "startTime": "00:00",
                                "endTime": "23:59"
                            }
                        ]
                    },
                    "keywordStrategy": "genericBrandedAndConquesting"
                }
            }
        }'

import requests

headers = {
    'Authorization': 'Bearer <MY_ACCESS_TOKEN>',
    'Content-Type': 'application/json',
    'Accept': 'application/json',
}

json_data = {
    'data': {
        'attributes': {
            'name': 'Product ABC Sponsored Weekend Conversions',
            'targetRetailerId': '12345',
            'status': 'draft',
            'startDate': '2025-09-01T00:00:00-04:00',
            'endDate': '2025-12-31T23:59:59-04:00',
            'budget': 1000.0,
            'monthlyPacing': None,
            'isAutoDailyPacing': False,
            'targetBid': 1.0,
            'maxBid': 5,
            'bidStrategy': 'automated',
            'optimizationStrategy': 'conversion',
            'flightSchedule': {
                'legs': [
                    {
                        'dayOfWeek': 'Weekends',
                        'startTime': '00:00',
                        'endTime': '23:59',
                    },
                ],
            },
            'keywordStrategy': 'genericBrandedAndConquesting',
        },
    },
}

response = requests.post(
    'https://api.criteo.com/2026-01/retail-media/campaigns/1234567890/auction-line-items',
    headers=headers,
    json=json_data,
)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n            "data": {\n                "attributes": {\n                    "name": "Product ABC Sponsored Weekend Conversions",\n                    "targetRetailerId": "12345",\n                    "status": "draft",\n                    "startDate": "2025-09-01T00:00:00-04:00",\n                    "endDate": "2025-12-31T23:59:59-04:00",\n                    "budget": 1000.0,\n                    "monthlyPacing": null,\n                    "isAutoDailyPacing": false,\n                    "targetBid": 1.0,\n                    "maxBid": 5,\n                    "bidStrategy": "automated",\n                    "optimizationStrategy": "conversion",\n                    "flightSchedule": {\n                        "legs": [\n                            {\n                                "dayOfWeek": "Weekends",\n                                "startTime": "00:00",\n                                "endTime": "23:59"\n                            }\n                        ]\n                    },\n                    "keywordStrategy": "genericBrandedAndConquesting"\n                }\n            }\n        }'
#response = requests.post(
#    'https://api.criteo.com/2026-01/retail-media/campaigns/1234567890/auction-line-items',
#    headers=headers,
#    data=data,
#)

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/campaigns/1234567890/auction-line-items"))
    .POST(BodyPublishers.ofString("{\n            \"data\": {\n                \"attributes\": {\n                    \"name\": \"Product ABC Sponsored Weekend Conversions\",\n                    \"targetRetailerId\": \"12345\",\n                    \"status\": \"draft\",\n                    \"startDate\": \"2025-09-01T00:00:00-04:00\",\n                    \"endDate\": \"2025-12-31T23:59:59-04:00\",\n                    \"budget\": 1000.0,\n                    \"monthlyPacing\": null,\n                    \"isAutoDailyPacing\": false,\n                    \"targetBid\": 1.0,\n                    \"maxBid\": 5,\n                    \"bidStrategy\": \"automated\",\n                    \"optimizationStrategy\": \"conversion\",\n                    \"flightSchedule\": {\n                        \"legs\": [\n                            {\n                                \"dayOfWeek\": \"Weekends\",\n                                \"startTime\": \"00:00\",\n                                \"endTime\": \"23:59\"\n                            }\n                        ]\n                    },\n                    \"keywordStrategy\": \"genericBrandedAndConquesting\"\n                }\n            }\n        }"))
    .setHeader("Authorization", "Bearer <MY_ACCESS_TOKEN>")
    .setHeader("Content-Type", "application/json")
    .setHeader("Accept", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

OkHttpClient client = new OkHttpClient().newBuilder()
    .build();

MediaType mediaType = MediaType.parse("application/json");

RequestBody body = RequestBody.create(mediaType, """
{
    "data": {
        "attributes": {
            "name": "Product ABC Sponsored Weekend Conversions",
            "targetRetailerId": "12345",
            "status": "draft",
            "startDate": "2025-09-01T00:00:00-04:00",
            "endDate": "2025-12-31T23:59:59-04:00",
            "budget": 1000.0,
            "monthlyPacing": null,
            "isAutoDailyPacing": false,
            "targetBid": 1.0,
            "maxBid": 5,
            "bidStrategy": "automated",
            "optimizationStrategy": "conversion",
            "flightSchedule": {
                "legs": [
                    {
                        "dayOfWeek": "Weekends",
                        "startTime": "00:00",
                        "endTime": "23:59"
                    }
                ]
            },
            "keywordStrategy": "genericBrandedAndConquesting"
        }
    }
}
""");

Request request = new Request.Builder()
    .url("https://api.criteo.com/2026-01/retail-media/campaigns/1234567890/auction-line-items")
    .method("POST", body)
    .addHeader("Authorization", "Bearer <MY_ACCESS_TOKEN>")
    .addHeader("Content-Type", "application/json")
    .addHeader("Accept", "application/json")
    .build();

Response response = client.newCall(request).execute();

Sample Response

For POST retail-media/campaigns/{campaignId}/auction-line-items:

{
    "data": {
        "id": "764555166286000000",
        "type": "SponsoredProductsLineItem",
        "attributes": {
            "name": "Product ABC Sponsored Weekend Conversions",
            "startDate": "2025-09-01T04:00:00+00:00",
            "endDate": "2026-01-01T03:59:59+00:00",
            "status": "draft",
            "targetBid": null,
            "targetRetailerId": "12345",
            "budget": 10.00,
            "campaignId": "1234567890",
            "budgetSpent": 0.00,
            "budgetRemaining": 10.00,
            "createdAt": "2025-10-10T18:29:16.3861275+00:00",
            "updatedAt": "2025-10-10T18:29:16.3861275+00:00",
            "maxBid": 0.0,
            "monthlyPacing": 1000.00,
            "dailyPacing": 0.00,
            "bidStrategy": "automated",
            "optimizationStrategy": "conversion",
            "isAutoDailyPacing": false,
            "flightSchedule": {
                "legs": [
                    {
                        "dayOfWeek": "weekends",
                        "startTime": "00:00",
                        "endTime": "23:59"
                    }
                ]
            },
            "keywordStrategy": "genericAndBranded"
        }
    },
    "warnings": [],
    "errors": []
}

Sample Requests

For PUT /retail-media/auction-line-items/:lineItemId:

curl --location --request PUT 'https://api.criteo.com/2026-01/retail-media/auction-line-items/1252' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Bearer <MY_ACCESS_TOKEN>' \
--data '{
  "data": {
    "attributes": {
      "isAutoDailyPacing": true,
      "name": "SP LI v3",
      "startDate": "2026-01-13T04:00:00+00:00",
      "status": "active",
      "bidStrategy": "manual",
      "budget": "100.00",
      "dailyPacing": null,
      "endDate": "2026-01-31T03:59:59+00:00",
      "flightSchedule": {
        "legs": [
          {
            "dayOfWeek": "friday",
            "startTime": "18:00",
            "endTime": "23:59"
          },
          {
             "dayOfWeek": "weekends",
             "startTime": "18:00",
             "endTime": "23:59"
          }
        ]
      },
      "maxBid": "2.0",
      "monthlyPacing": null,
      "optimizationStrategy": "conversion",
      "targetBid": "1.0"
    },
    "type": "<string>"
  }
}'

import requests

headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
}

json_data = {
    'data': {
        'attributes': {
            'isAutoDailyPacing': True,
            'name': 'SP LI v3',
            'startDate': '2026-01-13T04:00:00+00:00',
            'status': 'active',
            'bidStrategy': 'manual',
            'budget': '100.00',
            'dailyPacing': None,
            'endDate': '2026-01-31T03:59:59+00:00',
            'flightSchedule': {
                'legs': [
                    {
                        'dayOfWeek': 'friday',
                        'startTime': '18:00',
                        'endTime': '23:59',
                    },
                    {
                        'dayOfWeek': 'weekends',
                        'startTime': '18:00',
                        'endTime': '23:59',
                    },
                ],
            },
            'maxBid': '2.0',
            'monthlyPacing': None,
            'optimizationStrategy': 'conversion',
            'targetBid': '1.0',
        },
        'type': '<string>',
    },
}

response = requests.put('https://api.criteo.com/2026-01/retail-media/auction-line-items/1252', headers=headers, json=json_data)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/auction-line-items/1252');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n  \"data\": {\n    \"attributes\": {\n      \"isAutoDailyPacing\": true,\n      \"name\": \"SP LI v3\",\n      \"startDate\": \"2026-01-13T04:00:00+00:00\",\n      \"status\": \"active\",\n      \"bidStrategy\": \"manual\",\n      \"budget\": \"100.00\",\n      \"dailyPacing\": null,\n      \"endDate\": \"2026-01-31T03:59:59+00:00\",\n      \"flightSchedule\": {\n        \"legs\": [\n          {\n            \"dayOfWeek\": \"friday\",\n            \"startTime\": \"18:00\",\n            \"endTime\": \"23:59\"\n          },\n          {\n             \"dayOfWeek\": \"weekends\",\n             \"startTime\": \"18:00\",\n             \"endTime\": \"23:59\"\n          }\n        ]\n      },\n      \"maxBid\": \"2.0\",\n      \"monthlyPacing\": null,\n      \"optimizationStrategy\": \"conversion\",\n      \"targetBid\": \"1.0\"\n    },\n    \"type\": \"<string>\"\n  }\n}");
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/auction-line-items/1252"))
    .PUT(BodyPublishers.ofString("{\n  \"data\": {\n    \"attributes\": {\n      \"isAutoDailyPacing\": true,\n      \"name\": \"SP LI v3\",\n      \"startDate\": \"2026-01-13T04:00:00+00:00\",\n      \"status\": \"active\",\n      \"bidStrategy\": \"manual\",\n      \"budget\": \"100.00\",\n      \"dailyPacing\": null,\n      \"endDate\": \"2026-01-31T03:59:59+00:00\",\n      \"flightSchedule\": {\n        \"legs\": [\n          {\n            \"dayOfWeek\": \"friday\",\n            \"startTime\": \"18:00\",\n            \"endTime\": \"23:59\"\n          },\n          {\n             \"dayOfWeek\": \"weekends\",\n             \"startTime\": \"18:00\",\n             \"endTime\": \"23:59\"\n          }\n        ]\n      },\n      \"maxBid\": \"2.0\",\n      \"monthlyPacing\": null,\n      \"optimizationStrategy\": \"conversion\",\n      \"targetBid\": \"1.0\"\n    },\n    \"type\": \"<string>\"\n  }\n}"))
    .setHeader("Content-Type", "application/json")
    .setHeader("Accept", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Response

For PUT /retail-media/auction-line-items/:lineItemId:

{
    "data": {
        "id": "1252",
        "type": "SponsoredProductsLineItem",
        "attributes": {
            "name": "SP LI v3",
            "startDate": "2026-01-13T04:00:00+00:00",
            "endDate": "2026-01-31T03:59:59+00:00",
            "status": "draft",
            "targetBid": 1.0000,
            "targetRetailerId": "180",
            "budget": 100.00,
            "campaignId": "1285",
            "budgetSpent": 0.00,
            "budgetRemaining": 100.00,
            "createdAt": "2020-03-10T15:00:03.0698531+00:00",
            "updatedAt": "2026-01-12T21:12:09.5901347+00:00",
            "maxBid": 2.0,
            "monthlyPacing": 0.00,
            "dailyPacing": 5.26,
            "optimizationStrategy": "conversion",
            "isAutoDailyPacing": true,
            "flightSchedule": {
                "legs": [
                    {
                        "dayOfWeek": "friday",
                        "startTime": "18:00",
                        "endTime": "23:59"
                    },
                    {
                        "dayOfWeek": "weekends",
                        "startTime": "18:00",
                        "endTime": "23:59"
                    }
                ]
            },
            "keywordStrategy": "genericAndBranded",
            "bidStrategy": "manual"
        }
    },
    "warnings": [],
    "errors": []
}

Sample Requests

For GET /retail-media/auction-line-items/:lineItemId:

curl --location 'https://api.criteo.com/2026-01/retail-media/auction-line-items/1252' \
--header 'Accept: application/json' \
--header 'Bearer <MY_ACCESS_TOKEN>'

import requests

headers = {
    'Accept': 'application/json',
}

response = requests.get('https://api.criteo.com/2026-01/retail-media/auction-line-items/1252', headers=headers)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/auction-line-items/1252');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/auction-line-items/1252"))
    .GET()
    .setHeader("Accept", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Requests

For GET /retail-media/campaigns/:campaignId/auction-line-items:

curl --location 'https://api.criteo.com/2026-01/retail-media/campaigns/1285/auction-line-items' \
--header 'Accept: application/json' \
--header 'Bearer <MY_ACCESS_TOKEN>'

import requests

headers = {
    'Accept': 'application/json',
}

response = requests.get('https://api.criteo.com/2026-01/retail-media/campaigns/1285/auction-line-items', headers=headers)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/campaigns/1285/auction-line-items');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
]);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newBuilder()
    .followRedirects(HttpClient.Redirect.NORMAL)
    .build();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/campaigns/1285/auction-line-items"))
    .GET()
    .setHeader("Accept", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Response

For GET: /retail-media/auction-line-items/:lineItemId: For GET: /retail-media/campaigns/:campaignId/auction-line-items:

{
    "metadata": {
        "count": 1,
        "offset": 0,
        "limit": 25
    },
    "data": [
        {
            "id": "1252",
            "type": "SponsoredProductsLineItem",
            "attributes": {
                "name": "SP LI v3",
                "startDate": "2026-01-13T04:00:00+00:00",
                "endDate": "2026-01-31T03:59:59+00:00",
                "status": "draft",
                "targetBid": 1.0000,
                "targetRetailerId": "180",
                "budget": 100.00,
                "campaignId": "1285",
                "budgetSpent": 0.00,
                "budgetRemaining": 100.00,
                "createdAt": "2020-03-10T15:00:03.0698531+00:00",
                "updatedAt": "2026-01-12T21:12:09.5901347+00:00",
                "maxBid": 2.0000,
                "monthlyPacing": 0.00,
                "dailyPacing": 5.26,
                "optimizationStrategy": "conversion",
                "isAutoDailyPacing": false,
                "flightSchedule": {
                    "legs": [
                        {
                            "dayOfWeek": "friday",
                            "startTime": "18:00",
                            "endTime": "23:59"
                        },
                        {
                            "dayOfWeek": "weekends",
                            "startTime": "18:00",
                            "endTime": "23:59"
                        }
                    ]
                },
                "keywordStrategy": "genericAndBranded",
                "bidStrategy": "manual"
            }
        }
    ],
    "warnings": [],
    "errors": []
}

Retailer Search

In version 2026.01, we’ve introduced new retailer search capabilities that represent what retailers you are eligible to target as well as the eligible Campaign Types, Buy Types, and whether the retailer has them enabled for certain Page Types and Environments. This allows users to programmatically determine targeting eligibility across available retailers and configuration constraints before creating or updating campaigns.

This endpoint is recommended for integration moving forward, as it provides a more real-time and descriptive representation than the existing /retail-media/accounts/:accountId/retailers endpoint. The /retail-media/accounts/:accountId/retailers endpoint will not be released in this version or in any future versions. However, versions released between 2025-04 and 2025-10 will remain operational in accordance with our Versioning Policy.

You can find the documentation for the Retailer Search endpoint here.

Updated Endpoints

The following new endpoint can be found below:

Verb	Endpoint	Description
POST	`/accounts/{accountId}/retailers/search`	Search for Retailers associated with specific account

Sample Requests

For POST /accounts/{accountId}/retailers/search:

curl -X POST "https://api.criteo.com/2026-01/retail-media/accounts/1234567890/retailers/search" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer <MY_ACCESS_TOKEN>" \
  -H 'Content-Type: application/json' \
  -d '{
          "data": {
              "attributes": {
                  "retailerIdFilter": [
                      12345
                  ]
              }
          }
     }'

import requests

headers = {
    'Accept': 'application/json',
    'Authorization': 'Bearer <MY_ACCESS_TOKEN>',
    'Content-Type': 'application/json',
}

json_data = {
    'data': {
        'attributes': {
            'retailerIdFilter': [
                12345,
            ],
        },
    },
}

response = requests.post(
    'https://api.criteo.com/2026-01/retail-media/accounts/1234567890/retailers/search',
    headers=headers,
    json=json_data,
)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/accounts/1234567890/retailers/search');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Accept: application/json',
    'Authorization: Bearer <MY_ACCESS_TOKEN>',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n          \"data\": {\n              \"attributes\": {\n                  \"retailerIdFilter\": [\n                      12345\n                  ]\n              }\n          }\n     }");

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/accounts/1234567890/retailers/search"))
    .POST(BodyPublishers.ofString("{\n          \"data\": {\n              \"attributes\": {\n                  \"retailerIdFilter\": [\n                      12345\n                  ]\n              }\n          }\n     }"))
    .setHeader("Accept", "application/json")
    .setHeader("Authorization", "Bearer <MY_ACCESS_TOKEN>")
    .setHeader("Content-Type", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Response

For POST /accounts/{accountId}/retailers/search:

{
    "metadata": {
        "count": 1,
        "offset": 0,
        "limit": 5
    },
    "data": [
        {
            "id": "299",
            "type": "RetailerResult",
            "attributes": {
                "name": "Retailer 1234",
                "campaignAvailabilities": [
                    {
                        "campaignType": "onsiteDisplay",
                        "buyType": "auction",
                        "isAvailable": true,
                        "validCombinations": [
                            {
                                "pageType": "home",
                                "pageEnvironmentType": "web"
                            },
                            {
                                "pageType": "home",
                                "pageEnvironmentType": "ios"
                            },
                            {
                                "pageType": "search",
                                "pageEnvironmentType": "web"
                            },
                            {
                                "pageType": "category",
                                "pageEnvironmentType": "web"
                            },
                            {
                                "pageType": "productDetail",
                                "pageEnvironmentType": "web"
                            },

                            // ...

                            {
                                "pageType": "confirmation",
                                "pageEnvironmentType": "web"
                            }
                        ]
                    },
                    {
                        "campaignType": "onsiteDisplay",
                        "buyType": "preferredDeals",
                        "isAvailable": true,
                        "validCombinations": [
                            {
                                "pageType": "home",
                                "pageEnvironmentType": "web"
                            },

                            // ...

                            {
                                "pageType": "confirmation",
                                "pageEnvironmentType": "web"
                            }
                        ]
                    },
                    {
                        "campaignType": "onsiteDisplay",
                        "buyType": "sponsorship",
                        "isAvailable": false,
                        "validCombinations": []
                    },
                    {
                        "campaignType": "sponsoredProducts",
                        "buyType": "auction",
                        "isAvailable": true,
                        "validCombinations": [
                            {
                                "pageType": "home",
                                "pageEnvironmentType": "web"
                            },

                            // ...

                            {
                                "pageType": "confirmation",
                                "pageEnvironmentType": "web"
                            }
                        ]
                    },
                    {
                        "campaignType": "sponsoredProducts",
                        "buyType": "sponsorship",
                        "isAvailable": true,
                        "validCombinations": [
                            {
                                "pageType": "home",
                                "pageEnvironmentType": "web"
                            },

                            // ...

                            {
                                "pageType": "confirmation",
                                "pageEnvironmentType": "web"
                            }
                        ]
                    },
                    {
                        "campaignType": "offsite",
                        "buyType": "offsite",
                        "isAvailable": false,
                        "validCombinations": []
                    }
                ]
            }
        }
    ],
    "warnings": [],
    "errors": []
}

Account Level Reporting

In version 2026.01, we’ve introduced a new reporting endpoint that enables Retail Media partners to generate flexible, asynchronous performance reports aggregated at the account level, rather than being limited to individual campaigns or line items. It allows reporting across up to 5 account IDs in a single request, while still supporting the same set of metrics, dimensions, filters, attribution windows, and formats already available in existing DSP analytics endpoints. Functionally, this endpoint extends existing reporting capabilities by introducing the accountIds attribute and enforcing a maximum 31-day date range per request. It also supports both campaign-level and line-item–level aggregation.

You can find the documentation for the Account level reporting endpoint here.

Updated Endpoint

The following new endpoint can be found below:

Verb	Endpoint	Description
POST	`/retail-media/reports/accounts`	Request a flexible reporting at the account level

Sample Request

For /retail-media/reports/accounts:

curl -X POST https://api.criteo.com/2026-01/retail-media/reports/accounts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "type": "AsyncAccountsReportRequest",
      "attributes": {
        "accountIds": ["12345", "67890"],
        "reportType": "summary",
        "aggregationLevel": "campaign",
        "searchTermTypes": ["entered"],
        "searchTermTargetings": ["automatic"],
        "targetedKeywordTypes": ["generic"],
        "campaignType": "all",
        "salesChannel": "all",
        "mediaType": "all",
        "format": "json-compact",
        "clickAttributionWindow": "none",
        "viewAttributionWindow": "none",
        "dimensions": ["date", "accountId"],
        "metrics": ["impressions"],
        "startDate": "2025-10-10",
        "endDate": "2025-10-10",
        "timezone": "UTC"
      }
    }
  }'

import requests

headers = {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
}

json_data = {
    'data': {
        'type': 'AsyncAccountsReportRequest',
        'attributes': {
            'accountIds': [
                '12345',
                '67890',
            ],
            'reportType': 'summary',
            'aggregationLevel': 'campaign',
            'searchTermTypes': [
                'entered',
            ],
            'searchTermTargetings': [
                'automatic',
            ],
            'targetedKeywordTypes': [
                'generic',
            ],
            'campaignType': 'all',
            'salesChannel': 'all',
            'mediaType': 'all',
            'format': 'json-compact',
            'clickAttributionWindow': 'none',
            'viewAttributionWindow': 'none',
            'dimensions': [
                'date',
                'accountId',
            ],
            'metrics': [
                'impressions',
            ],
            'startDate': '2025-10-10',
            'endDate': '2025-10-10',
            'timezone': 'UTC',
        },
    },
}

response = requests.post('https://api.criteo.com/2026-01/retail-media/reports/accounts', headers=headers, json=json_data)

# Note: json_data will not be serialized by requests
# exactly as it was in the original request.
#data = '{\n    "data": {\n      "type": "AsyncAccountsReportRequest",\n      "attributes": {\n        "accountIds": ["12345", "67890"],\n        "reportType": "summary",\n        "aggregationLevel": "campaign",\n        "searchTermTypes": ["entered"],\n        "searchTermTargetings": ["automatic"],\n        "targetedKeywordTypes": ["generic"],\n        "campaignType": "all",\n        "salesChannel": "all",\n        "mediaType": "all",\n        "format": "json-compact",\n        "clickAttributionWindow": "none",\n        "viewAttributionWindow": "none",\n        "dimensions": ["date", "accountId"],\n        "metrics": ["impressions"],\n        "startDate": "2025-10-10",\n        "endDate": "2025-10-10",\n        "timezone": "UTC"\n      }\n    }\n  }'
#response = requests.post('https://api.criteo.com/2026-01/retail-media/reports/accounts', headers=headers, data=data)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/reports/accounts');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer YOUR_ACCESS_TOKEN',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n    \"data\": {\n      \"type\": \"AsyncAccountsReportRequest\",\n      \"attributes\": {\n        \"accountIds\": [\"12345\", \"67890\"],\n        \"reportType\": \"summary\",\n        \"aggregationLevel\": \"campaign\",\n        \"searchTermTypes\": [\"entered\"],\n        \"searchTermTargetings\": [\"automatic\"],\n        \"targetedKeywordTypes\": [\"generic\"],\n        \"campaignType\": \"all\",\n        \"salesChannel\": \"all\",\n        \"mediaType\": \"all\",\n        \"format\": \"json-compact\",\n        \"clickAttributionWindow\": \"none\",\n        \"viewAttributionWindow\": \"none\",\n        \"dimensions\": [\"date\", \"accountId\"],\n        \"metrics\": [\"impressions\"],\n        \"startDate\": \"2025-10-10\",\n        \"endDate\": \"2025-10-10\",\n        \"timezone\": \"UTC\"\n      }\n    }\n  }");

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/reports/accounts"))
    .POST(BodyPublishers.ofString("{\n    \"data\": {\n      \"type\": \"AsyncAccountsReportRequest\",\n      \"attributes\": {\n        \"accountIds\": [\"12345\", \"67890\"],\n        \"reportType\": \"summary\",\n        \"aggregationLevel\": \"campaign\",\n        \"searchTermTypes\": [\"entered\"],\n        \"searchTermTargetings\": [\"automatic\"],\n        \"targetedKeywordTypes\": [\"generic\"],\n        \"campaignType\": \"all\",\n        \"salesChannel\": \"all\",\n        \"mediaType\": \"all\",\n        \"format\": \"json-compact\",\n        \"clickAttributionWindow\": \"none\",\n        \"viewAttributionWindow\": \"none\",\n        \"dimensions\": [\"date\", \"accountId\"],\n        \"metrics\": [\"impressions\"],\n        \"startDate\": \"2025-10-10\",\n        \"endDate\": \"2025-10-10\",\n        \"timezone\": \"UTC\"\n      }\n    }\n  }"))
    .setHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .setHeader("Content-Type", "application/json")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Response

For /retail-media/reports/accounts:

{
  "data": {
    "type": "RetailMediaReportStatus",
    "id": "f5a2cd3d-1e83-41b1-98b1-abcde1234567",
    "attributes": {
      "status": "pending",
      "rowCount": null,
      "fileSizeBytes": null,
      "md5Checksum": null,
      "createdAt": null,
      "expiresAt": null,
      "message": null
    }
  }
}

Fill Rate Reporting

In version 2026.01, we’ve introduced new fill rate reporting endpoints that provide retailers with a comprehensive view of how effectively their available ad placements are being monetized by comparing the number of successfully filled placement impressions against the total number of delivered placements. By analyzing fill rate and related coverage metrics across dimensions such as placement, page type, or environment, for example, retailers can identify gaps between supply and demand that limit revenue potential. This insight helps surface where inventory is underutilized or insufficient, or where technical or configuration issues prevent ads from rendering, enabling more informed optimization decisions to maximize yield. Retailers can request either a standard fill rate report or a more granular unfilled placements report that breaks down the specific reasons inventory went unfilled. Together, the fill rate and unfilled reasons reports give retailers both a high-level performance signal and actionable diagnostics, making it easier to prioritize demand growth, improve inventory coverage, and resolve supply-side constraints that impact monetization.

You can find the documentation for Fill Rate reporting endpoints here.

Updated Endpoints

The following new endpoint can be found below:

Verb	Endpoint	Description
POST	`/reports/fillrate`	Request a fill rate report creation
POST	`/reports/unfilled-placements`	Request an unfilled reasons report

Sample Request

For /retail-media/reports/fillrate:

curl -X 'POST' \
  'https://api.criteo.com/2026-01/retail-media/reports/fillrate' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json-patch+json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -d '{
  "data": {
    "type": "string",
    "attributes": {
      "supplyAccountIds": [
        "8639134211138xxxx"
      ],
      "dimensions": [
          "date",
          "retailerId",
          "retailerName",
          "placementId",
          "placementName",
          "pageTypeName",
          "environment",
          "servedCategory",
          "retailerCategoryId",
          "retailerCategoryName",
          "adServerType"
      ],
      "metrics": [
          "pageViews",
          "availablePlacements",
          "unfilledPlacements",
          "fillRate",
          "placementImpressions",
          "productImpressions",
          "impressions",
          "placementClicks",
          "productClicks",
          "clicks",
          "placementImpressionsCTR",
          "productImpressionsCTR",
          "cpm",
          "cpc",
          "placementImpressionsRevenue",
          "productClicksRevenue",
          "revenue",
          "workingMedia",
          "netRevenue",
          "nonDeliverablePlacements",
          "deliverablePlacements",
          "placementsWithCandidates",
          "coveredPlacements",
          "coverageRate"
                ],
      "adServerType": "all",
      "format": "csv",
      "startDate": "2025-09-08",
      "endDate": "2025-09-09",
      "timezone": "America/New_York"
    }
  }
}'

import requests

headers = {
    'accept': 'text/plain',
    'Content-Type': 'application/json-patch+json',
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
}

data = '{\n  "data": {\n    "type": "string",\n    "attributes": {\n      "supplyAccountIds": [\n        "8639134211138xxxx"\n      ],\n      "dimensions": [\n          "date",\n          "retailerId",\n          "retailerName",\n          "placementId",\n          "placementName",\n          "pageTypeName",\n          "environment",\n          "servedCategory",\n          "retailerCategoryId",\n          "retailerCategoryName",\n          "adServerType"\n      ],\n      "metrics": [\n          "pageViews",\n          "availablePlacements",\n          "unfilledPlacements",\n          "fillRate",\n          "placementImpressions",\n          "productImpressions",\n          "impressions",\n          "placementClicks",\n          "productClicks",\n          "clicks",\n          "placementImpressionsCTR",\n          "productImpressionsCTR",\n          "cpm",\n          "cpc",\n          "placementImpressionsRevenue",\n          "productClicksRevenue",\n          "revenue",\n          "workingMedia",\n          "netRevenue",\n          "nonDeliverablePlacements",\n          "deliverablePlacements",\n          "placementsWithCandidates",\n          "coveredPlacements",\n          "coverageRate"\n                ],\n      "adServerType": "all",\n      "format": "csv",\n      "startDate": "2025-09-08",\n      "endDate": "2025-09-09",\n      "timezone": "America/New_York"\n    }\n  }\n}'

response = requests.post('https://api.criteo.com/2026-01/retail-media/reports/fillrate', headers=headers, data=data)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/reports/fillrate');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: text/plain',
    'Content-Type: application/json-patch+json',
    'Authorization: Bearer YOUR_ACCESS_TOKEN',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n  \"data\": {\n    \"type\": \"string\",\n    \"attributes\": {\n      \"supplyAccountIds\": [\n        \"8639134211138xxxx\"\n      ],\n      \"dimensions\": [\n          \"date\",\n          \"retailerId\",\n          \"retailerName\",\n          \"placementId\",\n          \"placementName\",\n          \"pageTypeName\",\n          \"environment\",\n          \"servedCategory\",\n          \"retailerCategoryId\",\n          \"retailerCategoryName\",\n          \"adServerType\"\n      ],\n      \"metrics\": [\n          \"pageViews\",\n          \"availablePlacements\",\n          \"unfilledPlacements\",\n          \"fillRate\",\n          \"placementImpressions\",\n          \"productImpressions\",\n          \"impressions\",\n          \"placementClicks\",\n          \"productClicks\",\n          \"clicks\",\n          \"placementImpressionsCTR\",\n          \"productImpressionsCTR\",\n          \"cpm\",\n          \"cpc\",\n          \"placementImpressionsRevenue\",\n          \"productClicksRevenue\",\n          \"revenue\",\n          \"workingMedia\",\n          \"netRevenue\",\n          \"nonDeliverablePlacements\",\n          \"deliverablePlacements\",\n          \"placementsWithCandidates\",\n          \"coveredPlacements\",\n          \"coverageRate\"\n                ],\n      \"adServerType\": \"all\",\n      \"format\": \"csv\",\n      \"startDate\": \"2025-09-08\",\n      \"endDate\": \"2025-09-09\",\n      \"timezone\": \"America/New_York\"\n    }\n  }\n}");

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/reports/fillrate"))
    .POST(BodyPublishers.ofString("{\n  \"data\": {\n    \"type\": \"string\",\n    \"attributes\": {\n      \"supplyAccountIds\": [\n        \"8639134211138xxxx\"\n      ],\n      \"dimensions\": [\n          \"date\",\n          \"retailerId\",\n          \"retailerName\",\n          \"placementId\",\n          \"placementName\",\n          \"pageTypeName\",\n          \"environment\",\n          \"servedCategory\",\n          \"retailerCategoryId\",\n          \"retailerCategoryName\",\n          \"adServerType\"\n      ],\n      \"metrics\": [\n          \"pageViews\",\n          \"availablePlacements\",\n          \"unfilledPlacements\",\n          \"fillRate\",\n          \"placementImpressions\",\n          \"productImpressions\",\n          \"impressions\",\n          \"placementClicks\",\n          \"productClicks\",\n          \"clicks\",\n          \"placementImpressionsCTR\",\n          \"productImpressionsCTR\",\n          \"cpm\",\n          \"cpc\",\n          \"placementImpressionsRevenue\",\n          \"productClicksRevenue\",\n          \"revenue\",\n          \"workingMedia\",\n          \"netRevenue\",\n          \"nonDeliverablePlacements\",\n          \"deliverablePlacements\",\n          \"placementsWithCandidates\",\n          \"coveredPlacements\",\n          \"coverageRate\"\n                ],\n      \"adServerType\": \"all\",\n      \"format\": \"csv\",\n      \"startDate\": \"2025-09-08\",\n      \"endDate\": \"2025-09-09\",\n      \"timezone\": \"America/New_York\"\n    }\n  }\n}"))
    .setHeader("accept", "text/plain")
    .setHeader("Content-Type", "application/json-patch+json")
    .setHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Request

For retail-media/reports/unfilled-placements:

curl -X 'POST' \
  'https://api.criteo.com/2026-01/retail-media/reports/unfilled-placements' \
  -H 'accept: text/plain' \
  -H 'Content-Type: application/json-patch+json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -d '{
  "data": {
    "type": "string",
    "attributes": {
      "supplyAccountIds": [
        "8639134211138xxxx"
      ],
      "dimensions": [
        "adServerType", "date"
      ],
      "metrics": [
              "totalUnfilledPlacements",
              "unfilledNotEnoughDemand",
              "nonDeliverableUnmappedCategories",
              "nonDeliverablePagesWithUnknownProducts",
              "nonDeliverableBlockedOptOut",
              "nonDeliverableBlockedPageCategory",
              "nonDeliverableInsufficientOrganicResults",
              "nonDeliverableTestPlacement",
              "uncoveredSearchTermWithoutCategory",
              "uncoveredNoDemandBrandedKeywordConquestingEnabled",
              "uncoveredNoDemandBrandedKeywordConquestingDisabled",
              "uncoveredNoDemandUnbrandedInventory",
              "uncoveredFilteredOutDemand",
              "uncoveredBrokenPlacement",
              "uncoveredNotPainted",
              "availablePlacements",
              "fillRate",
              "placementImpressions",
              "productImpressions",
              "placementClicks",
              "productClicks",
              "clicks",
              "placementImpressionsCTR",
              "productImpressionsCTR",
              "cpm",
              "cpc",
              "placementImpressionsRevenue",
              "productClicksRevenue",
              "revenue",
              "nonDeliverablePlacements",
              "placementsWithCandidates",
              "coveredPlacements",
              "coverageRate"
      ],
      "format": "csv",
      "startDate": "2025-09-08",
      "endDate": "2025-09-09",
      "timezone": "America/New_York"
    }
  }
}'

import requests

headers = {
    'accept': 'text/plain',
    'Content-Type': 'application/json-patch+json',
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
}

data = '{\n  "data": {\n    "type": "string",\n    "attributes": {\n      "supplyAccountIds": [\n        "8639134211138xxxx"\n      ],\n      "dimensions": [\n        "adServerType", "date"\n      ],\n      "metrics": [\n              "totalUnfilledPlacements",\n              "unfilledNotEnoughDemand",\n              "nonDeliverableUnmappedCategories",\n              "nonDeliverablePagesWithUnknownProducts",\n              "nonDeliverableBlockedOptOut",\n              "nonDeliverableBlockedPageCategory",\n              "nonDeliverableInsufficientOrganicResults",\n              "nonDeliverableTestPlacement",\n              "uncoveredSearchTermWithoutCategory",\n              "uncoveredNoDemandBrandedKeywordConquestingEnabled",\n              "uncoveredNoDemandBrandedKeywordConquestingDisabled",\n              "uncoveredNoDemandUnbrandedInventory",\n              "uncoveredFilteredOutDemand",\n              "uncoveredBrokenPlacement",\n              "uncoveredNotPainted",\n              "availablePlacements",\n              "fillRate",\n              "placementImpressions",\n              "productImpressions",\n              "placementClicks",\n              "productClicks",\n              "clicks",\n              "placementImpressionsCTR",\n              "productImpressionsCTR",\n              "cpm",\n              "cpc",\n              "placementImpressionsRevenue",\n              "productClicksRevenue",\n              "revenue",\n              "nonDeliverablePlacements",\n              "placementsWithCandidates",\n              "coveredPlacements",\n              "coverageRate"\n      ],\n      "format": "csv",\n      "startDate": "2025-09-08",\n      "endDate": "2025-09-09",\n      "timezone": "America/New_York"\n    }\n  }\n}'

response = requests.post('https://api.criteo.com/2026-01/retail-media/reports/unfilled-placements', headers=headers, data=data)

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.criteo.com/2026-01/retail-media/reports/unfilled-placements');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'accept: text/plain',
    'Content-Type: application/json-patch+json',
    'Authorization: Bearer YOUR_ACCESS_TOKEN',
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, "{\n  \"data\": {\n    \"type\": \"string\",\n    \"attributes\": {\n      \"supplyAccountIds\": [\n        \"8639134211138xxxx\"\n      ],\n      \"dimensions\": [\n        \"adServerType\", \"date\"\n      ],\n      \"metrics\": [\n              \"totalUnfilledPlacements\",\n              \"unfilledNotEnoughDemand\",\n              \"nonDeliverableUnmappedCategories\",\n              \"nonDeliverablePagesWithUnknownProducts\",\n              \"nonDeliverableBlockedOptOut\",\n              \"nonDeliverableBlockedPageCategory\",\n              \"nonDeliverableInsufficientOrganicResults\",\n              \"nonDeliverableTestPlacement\",\n              \"uncoveredSearchTermWithoutCategory\",\n              \"uncoveredNoDemandBrandedKeywordConquestingEnabled\",\n              \"uncoveredNoDemandBrandedKeywordConquestingDisabled\",\n              \"uncoveredNoDemandUnbrandedInventory\",\n              \"uncoveredFilteredOutDemand\",\n              \"uncoveredBrokenPlacement\",\n              \"uncoveredNotPainted\",\n              \"availablePlacements\",\n              \"fillRate\",\n              \"placementImpressions\",\n              \"productImpressions\",\n              \"placementClicks\",\n              \"productClicks\",\n              \"clicks\",\n              \"placementImpressionsCTR\",\n              \"productImpressionsCTR\",\n              \"cpm\",\n              \"cpc\",\n              \"placementImpressionsRevenue\",\n              \"productClicksRevenue\",\n              \"revenue\",\n              \"nonDeliverablePlacements\",\n              \"placementsWithCandidates\",\n              \"coveredPlacements\",\n              \"coverageRate\"\n      ],\n      \"format\": \"csv\",\n      \"startDate\": \"2025-09-08\",\n      \"endDate\": \"2025-09-09\",\n      \"timezone\": \"America/New_York\"\n    }\n  }\n}");

$response = curl_exec($ch);

curl_close($ch);

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.criteo.com/2026-01/retail-media/reports/unfilled-placements"))
    .POST(BodyPublishers.ofString("{\n  \"data\": {\n    \"type\": \"string\",\n    \"attributes\": {\n      \"supplyAccountIds\": [\n        \"8639134211138xxxx\"\n      ],\n      \"dimensions\": [\n        \"adServerType\", \"date\"\n      ],\n      \"metrics\": [\n              \"totalUnfilledPlacements\",\n              \"unfilledNotEnoughDemand\",\n              \"nonDeliverableUnmappedCategories\",\n              \"nonDeliverablePagesWithUnknownProducts\",\n              \"nonDeliverableBlockedOptOut\",\n              \"nonDeliverableBlockedPageCategory\",\n              \"nonDeliverableInsufficientOrganicResults\",\n              \"nonDeliverableTestPlacement\",\n              \"uncoveredSearchTermWithoutCategory\",\n              \"uncoveredNoDemandBrandedKeywordConquestingEnabled\",\n              \"uncoveredNoDemandBrandedKeywordConquestingDisabled\",\n              \"uncoveredNoDemandUnbrandedInventory\",\n              \"uncoveredFilteredOutDemand\",\n              \"uncoveredBrokenPlacement\",\n              \"uncoveredNotPainted\",\n              \"availablePlacements\",\n              \"fillRate\",\n              \"placementImpressions\",\n              \"productImpressions\",\n              \"placementClicks\",\n              \"productClicks\",\n              \"clicks\",\n              \"placementImpressionsCTR\",\n              \"productImpressionsCTR\",\n              \"cpm\",\n              \"cpc\",\n              \"placementImpressionsRevenue\",\n              \"productClicksRevenue\",\n              \"revenue\",\n              \"nonDeliverablePlacements\",\n              \"placementsWithCandidates\",\n              \"coveredPlacements\",\n              \"coverageRate\"\n      ],\n      \"format\": \"csv\",\n      \"startDate\": \"2025-09-08\",\n      \"endDate\": \"2025-09-09\",\n      \"timezone\": \"America/New_York\"\n    }\n  }\n}"))
    .setHeader("accept", "text/plain")
    .setHeader("Content-Type", "application/json-patch+json")
    .setHeader("Authorization", "Bearer YOUR_ACCESS_TOKEN")
    .build();

HttpResponse&lt;String&gt; response = client.send(request, HttpResponse.BodyHandlers.ofString());

Sample Response

For /retail-media/reports/fillrate: For retail-media/reports/unfilled-placements:

{
  "data": {
    "attributes": {
      "status": "pending",
      "rowCount": 0,
      "fileSizeBytes": 0,
      "md5CheckSum": null,
      "createdAt": "2025-09-15T19:45:55.758Z",
      "expiresAt": null,
      "message": null,
      "id": "4dcd1f71-77f0-4bf2-b225-3e7a0dxxxxx"
    },
    "id": "4dcd1f71-77f0-4bf2-b225-3e7a0ddxxxxxx",
    "type": "StatusResponse"
  },
  "warnings": [],
  "errors": []
}

​New Base URL

​What’s New

​API Authorization Controls

​Sponsored Product Line Item Updates

​Updated Endpoints

​Sample Requests

​Sample Response

​Sample Requests

​Sample Response

​Sample Requests

​Sample Requests

​Sample Response

​Retailer Search

​Updated Endpoints

​Sample Requests

​Sample Response

​Account Level Reporting

​Updated Endpoint

​Sample Request

​Sample Response

​Fill Rate Reporting

​Updated Endpoints

​Sample Request

​Sample Request

​Sample Response

New Base URL

What’s New

API Authorization Controls

Sponsored Product Line Item Updates

Updated Endpoints

Sample Requests

Sample Response

Sample Requests

Sample Response

Sample Requests

Sample Requests

Sample Response

Retailer Search

Updated Endpoints

Sample Requests

Sample Response

Account Level Reporting

Updated Endpoint

Sample Request

Sample Response

Fill Rate Reporting

Updated Endpoints

Sample Request

Sample Request

Sample Response