Reading the conventions
Money
Converted to your requested
currency. Always period-scoped.Rates and shares
Ratios, never percentages.
0.25 is 25%.Null vs zero
null means not available or not computable. 0 means genuinely zero.Money and volume
number
Gross merchandise value of orders placed within the period, before returns, cancellations
and platform fees. This is a demand measure, not a settlement measure — it will not match a
seller’s payout statement, and it is not meant to.
integer
Item quantity across orders placed in the period. An order of three units counts as three.
number
revenue / units_sold for shops and categories. Shifts with mix, not only with pricing — a
shop that starts selling a cheaper line moves this number without changing any price.number
The product-level equivalent: revenue divided by units sold for one listing. Compare it against
price.current to detect discount-driven volume.number
Change in
revenue against the immediately preceding window of equal length, as a ratio.
null when the preceding window has no data — see Periods.object
Revenue split across selling surfaces as ratios summing to 1:
video, live, mall, search.
Where a channel cannot attribute a surface, its key is absent rather than zero.Content performance
integer
Lifetime views of a video, not views within the requested period. Video metrics accumulate; the
period on a video search filters by publish date instead.
number
(likes + comments + shares) / views, as a ratio. Computed over the same lifetime window as
views.number
Gross revenue per thousand views —
revenue / views × 1000 — in your requested currency.
The single most useful efficiency metric for comparing creators, because it is neutral to
audience size.number
Mean views across the creator’s videos published in the period. Heavily skewed by outliers;
read it alongside
gpm rather than alone.integer
Net followers gained over the period. Can be negative.
Livestream metrics
integer
Unique viewers across the session.
integer
The maximum watching simultaneously — the number that tells you whether a promotion landed.
number
Mean watch duration per viewer, in seconds.
Counts
integer
Distinct creators who drove attributed sales in the period. On a product, this is the affiliate
breadth behind it — a product with 200 creators is in a different competitive position than one
with 3, at the same revenue.
integer
Distinct products with at least one sale, which is usually far smaller than
products_count —
the size of the catalogue.integer
Content published in the period that carried at least one product.
Which metrics exist on which entity
A dash means the metric is not defined for that entity and will not appear. A metric that is
defined but unavailable for your channel and market comes back
null and is listed in
meta.missing_fields — see Coverage.Filtering and sorting
Any metric in the table above can be filtered with a range and used as asort key, subject to coverage. Check
GET /coverage for the filterable and sortable flags on a specific
channel and market before shipping a query that depends on one.