Retailers
Introduction
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
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
API reference
You can find this endpoint in the API reference as well.
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/{version}/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/{version}/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/{version}/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 |
---|---|
🟢 200 | Call executed with success |
🔴 403 | API user does not have the authorization to make requests to the account ID. For an authorization request, follow the authorization request steps |
Updated 4 days ago