Bulk Calls

This page describes how to perform bulk calls towards Criteo Retail Media API

General

Our Reporting endpoints allow for bulk operations. Specifically, through the 2 following endpoints

POST/reports/campaigns
POST/reports/line-items

Bulk reports can be requested for several CampaignIds or LineItemIds, with a maximum of 50 IDs per call. To do so, please use the attribute ids with an array of CampaignIds or LineItemIds instead of id for a single ID report request.

When requesting one Id:

id : CampaignId1

OR

When requesting more than one Id:

ids : ["CampaignId1", "CampaignId2",..."CampaignIdn",...]

❗️

IMPORTANT

  • Do not use id and ids in the same call, this will lead to an invalid request response.
  • There is a 100,000-row limit for report output to keep in mind when making a bulk report request.

Error Codes

When sending more than 50 ids, you will get the following 400 Bad request HTTP Response

{"errors":
[
  {"code":"exceeded-ids-cap",
   "title":"Requests are capped for 50 unique ids, 51 were provided",
   "type":"validation",
   "traceId":"aa47dd83-8ca9-4a79-a179-ad5be6932ff1",
   "instance":"/api/v1/reports/line-item",
   "detail":"ids Requests are capped for 50 unique ids, 51 were provided (Value: \"1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51\")",
   "source":{"ids":"data/attributes/ids"}}
   ]}

This Contains:

Error Codeexceeded-ids-cap
Error TitleRequests are capped for 50 unique ids, {count of ids requested} were provided
Error Typevalidation

A traceId

Instance The report requested
DetailTitle with a list of requested ids
SourceThe parameter that caused the error (ids in this case)