Engagements

Retrieve Advertiser Spend

🔐 This endpoint requires HTTP Bearer authentication. For authenticating with Bearer token, required scopes are: retail_media.ad_spend_tracking(r).

Beta: This endpoint is in beta and may change. Returns the spend for every advertiser (engagement) that has accrued spend within the given index, broken down by day for the last 30 days.

get/v1/advertiser_spend

Request

Base URL
https://retail.media-cnstrc.com
URL
https://retail.media-cnstrc.com/v1/advertiser_spend
Auth
HTTP bearer

Query parameters

keystring required

The key of the index to use.

next_page_cursorstring nullable

Opaque cursor returned by a previous response. When omitted, the first page is returned.

num_results_per_pageinteger

Maximum number of advertisers to return in a single page. Defaults to 100, with a maximum of 1000. Values above the maximum are clamped.

Response

Successful Response.

total_countinteger required

Total number of advertisers with accrued spend for the index in the window, across all pages.

next_page_cursorstring nullable required

Opaque cursor for the next page, or null when the current page is the last one.

Example response

{
  "advertiser_spend": [
    {
      "daily_spend": {
        "2026-06-18": "40.0",
        "2026-06-19": "12.5"
      }
    }
  ],
  "total_count": 5
}

Changes

No recorded changes to this operation across all 1 revision of this API.