Creators

Creator performance (date-filtered)

Changed on

Top creators ranked by GMV earned within a specific date range. Unlike /creators/list (which shows lifetime GMV), this endpoint uses daily performance data and matches the dashboard's 'Top Creators' section exactly. Defaults to the last 30 days. Use this for period-specific rankings and reports.

post/creators/performance

Request

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

Request body

pageinteger
page_sizeinteger
sort_by'gmv' | 'units_sold' | 'order_count' | 'est_commission' | 'follower_count' nullable
sort_dir'asc' | 'desc'
start_datestring date nullable
end_datestring date nullable
creator_handlestring nullable
min_gmvnumber nullable

Response

Successful Response

currencystring required
paginationunknown required
shops_queriedstring[] nullable

Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

Changes

    • info

      api operation id creators_performance_creators_performance_post removed and replaced with creators_performance