Skip to main content
GET
Get campaign seller scorecard

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

id
string
required

Unique identifier for the campaign

Minimum string length: 1
Example:

"cmp_987654321"

Query Parameters

startDate
string

First day to score (YYYY-MM-DD). Defaults to the campaign's first reported day.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-01"

endDate
string

Last day to score (YYYY-MM-DD). Defaults to today.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-09-30"

Response

Get campaign seller scorecard

Each seller in a campaign scored on delivery, price, performance and quality, from the buyer's own media buys. Four scores, never one: each dimension is ranked on its own.

campaignId
string
required
periodStart
string
required

First day scored.

periodEnd
string
required

Last day scored.

currency
string | null
required

The advertiser currency money is in. Null when nothing was reported.

priceUnit
enum<string>
required

The unit every seller's price is in: the primary goal's unit, or impressions.

Available options:
impressions,
clicks,
views,
completedViews,
conversions,
leads,
viewableImpressions
pricePerUnits
required

1000 for impressions (a price per thousand), 1 otherwise.

Available options:
1
sellers
object[]
required

One row per seller with a live media buy in the campaign, or a buy that delivered in the period; most spend first.

moneyCoverage
object
required

Whether the reporting store holds every day the period covers. When it is not complete, spend is understated, so every seller reads delivery and price as not reported.

unattributedMediaBuyIds
string[]
required

Media buys whose products span more than one Storefront, so they belong to no single seller and are not scored.