Samples

Sample request stat cards

Changed on

The 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.

get/samples/metrics

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/samples/metrics
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

product_idsstring nullable

Comma-separated product IDs to filter by. Omit for all products.

sku_idsstring nullable

Comma-separated SKU IDs. AND-ed with product_ids, so passing both narrows to those SKUs rather than widening.

date_fromstring date nullable

Start of the window (inclusive). Requires date_to.

date_tostring date nullable

End of the window (inclusive). Requires date_from.

exclude_rejectedboolean

Exclude creators previously rejected/cancelled by this shop.

include_archivedboolean

Include sample requests archived in the portal.

Response

Successful Response

notScopableBySkustring[]

Changes