GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In
Guides

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)