Top videos with creative breakdown

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

No recorded changes to this endpoint across all 1 revision of this API.