---
title: "Retrieve Advertiser Spend"
method: GET
path: "/v1/advertiser_spend"
tags: ["Engagements"]
---

# Retrieve Advertiser Spend

`GET /v1/advertiser_spend`

**🔐 This endpoint requires [HTTP Bearer authentication](https://docs.constructor.com/reference/main-authentication#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.

## Query parameters

- `key` string, required — The key of the index to use.
- `next_page_cursor` string, nullable — Opaque cursor returned by a previous response. When omitted, the first page is returned.
- `num_results_per_page` integer — 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 `200`

Successful Response.

- AdvertiserSpendResponse
  - `advertiser_spend` AdvertiserSpendRecord[], required — Array of advertiser (engagement) spend records for the given index. Contains at most `num_results_per_page` entries.
    - `engagement_id` string, required — The advertiser (engagement) ID for the record.
    - `daily_spend` object, required — Map of date (YYYY-MM-DD) to spend for that advertiser. Includes the last 30 days.
  - `total_count` integer, required — Total number of advertisers with accrued spend for the index in the window, across all pages.
  - `next_page_cursor` string, nullable, required — Opaque cursor for the next page, or null when the current page is the last one.

## Other responses

- `400` — Bad Request.
- `401` — Unauthorized.
- `403` — Forbidden.

---

[API](https://skmtc.dev/constructor/apis/autocomplete.md) · [All operations](https://skmtc.dev/constructor/apis/autocomplete/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/constructor/autocomplete/revisions/2d33330633b6/schema)