Sample request stat cards
Changed onThe four stat cards above the sample-request table: pendingReview (how many requests await a decision, plus how many of those are expiring soon), approvedInAutoProcess (samples auto-approved by an automation), completionRate (share of approved samples that produced content), and approvalTarget (usage against the shop's approval quota). The change metrics compare against the immediately preceding period of equal length.
dataFreshness reports how current the underlying sample data is — TikTok's sample feed lags, so surface it rather than presenting the counts as real-time.
Under a sku_ids filter, notScopableBySku names the cards that could not be narrowed — approvedInAutoProcess and approvalTarget, whose counters are product-grain — so treat those as unscoped rather than filtered.
date_from/date_to must be given together and bound request creation date. Single-shop only.
Request
- Base URLhttps://api.reacherapp.com/public/v1
- URLhttps://api.reacherapp.com/public/v1/samples/metrics
- AuthAPI key in header x-api-key and API key in header x-shop-id
Query parameters
Comma-separated product IDs to filter by. Omit for all products.
Comma-separated SKU IDs. AND-ed with product_ids, so passing both narrows to those SKUs rather than widening.
Start of the window (inclusive). Requires date_to.
End of the window (inclusive). Requires date_from.
Exclude creators previously rejected/cancelled by this shop.
Include sample requests archived in the portal.
Response
Successful Response
Changes
- info
api operation id
samples_metrics_samples_metrics_getremoved and replaced withsamples_metrics
- info
- info
added the new optional
queryrequest parametersku_ids
- info