REreacherapp
Videos

Top videos with creative breakdown

Changed on

The shop's top videos ranked by GMV earned in the date range (defaults to the last 30 days, same ranking as /videos/performance), each enriched with the AI creative breakdown: hook, sell points, product niche, shot style, and videography. Use this to analyze WHY the top videos perform — not just how much they earned. Videos that haven't been analyzed yet keep their metrics and list the unavailable breakdown fields in creative.missing_fields; render those as 'not analyzed' rather than blank. Multi-shop requests (x-shop-id: all or comma-separated) mirror /videos/performance's semantics: one ranking across shops with a single top-level currency (USD fallback) — use a single shop when per-shop currency precision matters.

post/videos/creative

Request

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

Request body

limitinteger
sort_by'video_gmv' | 'views' | 'like_count' | 'order_count' | 'posted_date' nullable
sort_dir'asc' | 'desc'
start_datestring date nullable
end_datestring date nullable

Response

Successful Response

currencystring required
total_countinteger required

Total videos with performance data in the window (not just the top N)

messagestring nullable

Set when there are no videos in the window (explicit empty state)

shops_queriedstring[] nullable

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

Changes