---
title: "GMV Max spend by delivery surface"
method: GET
path: "/gmv-max/campaigns/{campaign_id}/spend-by-surface"
tags: ["GMV Max"]
---

# GMV Max spend by delivery surface

`GET /gmv-max/campaigns/{campaign_id}/spend-by-surface`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/campaigns/{campaign_id}/spend-by-surface`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Ad spend and distinct-creative counts for one campaign grouped by delivery surface (`product_card`, `affiliate`, `brand`, `unknown`) over a date range. NULL / unrecognised `surface_bucket` values bucket as `unknown`. Date range may not exceed 90 days (inclusive); defaults to the last 30 days. Sorted by spend descending. Empty `data` is a normal 200. Single shop only.

## Path parameters

- `campaign_id` string, required

## Query parameters

- `start_date` string, date, nullable
- `end_date` string, date, nullable

## Response `200`

Successful Response

- GmvMaxSpendBySurfaceResponse: GET /gmv-max/campaigns/{id}/spend-by-surface — sorted by spend descending.
  - `campaign_id` string, required
  - `shop_id` integer, required
  - `data` GmvMaxSurfaceSpendItem[], required
    - `surface` 'product_card' | 'affiliate' | 'brand' | 'unknown', required: Delivery surface, from `surface_bucket`. NULL / unrecognised → `unknown`.
    - `spend` number, required: Total ad spend on this surface over the window.
    - `creative_count` integer, required: Distinct creatives delivering on this surface over the window.
  - `start_date` string, required
  - `end_date` string, required
  - `currency` string, required: ISO currency code for the shop's region.

## Other responses

- `422`: Validation Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-02** `d4fe3e380424`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/campaigns/:campaign_id/spend-by-surface/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)