Get Collections Metrics Summary Endpoint
Storewide totals over the whole catalog’s metrics — the collections
KPI row’s source. Route safety is by shape, not declaration order:
{collection_id} can’t match across / so it can’t swallow
metrics/summary, and /{collection_id}/metrics needs a literal
metrics second segment — don’t add a :path convertor to those.
503 (not an all-zero summary) when the listing metrics are unavailable,
so degraded infrastructure reads as “unavailable” client-side rather
than as a store with no traffic.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
Query Parameters
Response
Successful Response
Rate whose value can be unknown — used by avg_str, where no member
product having a known inventory level makes the rate incomputable
(None), distinct from a genuine 0.0. Kept separate from
CollectionRateMetric so generated clients see avg_ctr.value as
non-nullable — the companion frontend change relies on that split.
Derived "Auto Lift" score: how the click-through rate of auto-sorted (non-pinned) products compares to the merchant's manually pinned products.
score is normalised to 0-100 where 50 means auto and pinned perform
equally, 100 means auto CTR is >= 2x pinned CTR, and 0 means auto
products get no clicks. Computed as clamp(50 * auto_ctr / pinned_ctr, 0, 100). It is None when the collection has no pinned products or no
auto (non-pinned) products, so there is nothing to compare. pinned_ctr
and auto_ctr are percentages (0-100); delta_pts is
auto_ctr - pinned_ctr in percentage points.
The highest-revenue product in a collection, for the overview table's
"Top Product" column. image_url is the product's first image (or None).

