Sign in
Creators

Weekly outreach funnel by creator tier

Changed on

The outreach funnel — messages sent, sample requests, samples approved, videos posted — rolled up per creator GMV tier, one block per week.

Weeks run Sunday to Saturday and are labelled by the Saturday they end on (week_ending), matching how weekly client reports are cut. A week with no activity is still returned, as zeros.

All eight tiers L0-L7 are always present. A creator's tier comes from their ALL-TIME platform-wide GMV — the same basis as the Top Creators level badges — not from the GMV attributed inside the window. The gmv field on each row IS the windowed figure.

touches is outreach messages: three DMs to one creator counts three. reached is distinct creators. Single shop only — set x-shop-id to one shop ID.

post/creators/tier-performance

Request

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

Request body

start_datestring date nullable

Inclusive window start (YYYY-MM-DD). Defaults to 8 weeks back.

end_datestring date nullable

Inclusive window end (YYYY-MM-DD). Defaults to yesterday.

Response

Successful Response

shop_idinteger required

Changes

Of the 34 revisions, 1 has no diff computed.