Skip to main content

Get Ads Performance

GET 

/ads/performance

Page through each brand on each channel with its ad spend, attributed sales and blended ROAS over the window, with totals for the whole scope. Requires ads.read. pagination.total is counted on every page, cursor pages included. The ranking is computed per request, so a cursor resumes after the last row it held by that row's sort values; a row whose figures change while you walk can move across the cursor.

Request and response fields at a glance
  • Query parameters: brandIds (array), saleChannelIds (array), startDate (string), endDate (string), sort (string), dir (string), page (integer), limit (integer).
  • 200 response (application/json): pairs (array, required), totals (object, required), pagination (object, required).

Request​