Retailers
Getting Started
- A retailer offers a selection of products from multiple brands.
- Retailers act as publishers, providing advertising inventory for brands to promote their products.
- An account can have access to one or more retailers, with this access typically managed by Criteo.
Endpoint
| Method | Endpoint | Description |
|---|---|---|
| GET | /accounts/{accountId}/retailers | Get all retailers |
Retailer Attributes
id
Data Type: string
Values: int64
Description: Retailer ID
Data Type: string
Values: 100 char limit
Description: Retailer name
Data Type: string array
Values: Auction,Preferred, Offsite, OffsiteCpc
Description: The campaign types this retailer is eligible to leverage
Get All Retailers
This endpoint retrieves a list of all retailers that carry the brands associated with an account. The results are provided in a paginated format.

https://api.criteo.com/{version}/retail-media/accounts/{accountId}/retailers
Sample Request
curl -X GET "https://api.criteo.com/{version}/retail-media/accounts/18446744073709551616/retailers" \
-H "Authorization: Bearer <MY_ACCESS_TOKEN>"import requests
url = "https://api.criteo.com/2023-07/retail-media/accounts/4/retailers"
payload={}
headers = {
'Accept': 'application/json',
'Authorization': 'Bearer <MY_ACCESS_TOKEN>'
}
response = requests.request("GET", url, headers=headers, data=payload)
print(response.text)OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://api.criteo.com/2023-07/retail-media/accounts/4/retailers")
.method("GET", body)
.addHeader("Accept", "application/json")
.addHeader("Authorization", "Bearer <MY_ACCESS_TOKEN>")
.build();
Response response = client.newCall(request).execute();<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.criteo.com/2023-07/retail-media/accounts/4/retailers');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
'follow_redirects' => TRUE
));
$request->setHeader(array(
'Accept' => 'application/json',
'Authorization' => 'Bearer <MY_ACCES_TOKEN>'
));
try {
$response = $request->send();
if ($response->getStatus() == 200) {
echo $response->getBody();
}
else {
echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
$response->getReasonPhrase();
}
}
catch(HTTP_Request2_Exception $e) {
echo 'Error: ' . $e->getMessage();
}Sample Response
{
"data": [
{
"id": "3239117063738827231",
"type": "RetailMediaRetailer",
"attributes": {
"name": "Retailer 123",
"campaignEligibilities": [
"auction",
"preferred",
"offsiteCpc",
"offsite"
]
}
},
// ...
{
"id": "18159942378514859684",
"type": "RetailMediaRetailer",
"attributes": {
"name": "Retailer 789",
"campaignEligibilities": [
"auction",
"preferred",
"offsiteCpc",
"offsite"
]
}
}
],
"metadata": {
"totalItemsAcrossAllPages": 10,
"currentPageSize": 25,
"currentPageIndex": 0,
"totalPages": 1,
"nextPage": null,
"previousPage": null
}
}Responses
Response | Description |
|---|---|
🟢
| Call executed with success |
🔴
| API user does not have the authorization to make requests to the account ID. For an authorization request, follow the steps |
Updated about 1 month ago