REreacherapp
Videos

List videos with retention / hook-quality metrics

Changed on

Your shop's videos with per-video completion rate (watch_finish_rate), exposure (impressions), views, CTR and engagement — the organic hook-quality signal.

TikTok exposes a 2-second view rate only for GMV Max ad creatives (video_view_rate_2s on /campaigns/{id}/creative-metrics); for organic videos the retention metric is completion, so use watch_finish_rate as the quality bar (min_watch_finish_rate filters to it). Ordered strongest-hook first.

Scope: videos in the shop's own Seller Center analytics (posted for the shop).

get/videos/retention

Request

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

Query parameters

creator_handlestring nullable

Restrict to a creator by (partial) TikTok handle.

min_watch_finish_ratenumber nullable

Only videos whose completion rate is at least this (percent).

min_viewsinteger nullable

Only videos with at least this many views. Pair with min_watch_finish_rate to use completion rate as a quality bar — without a floor a 1-view video reads as 100% completion and tops the ranking.

pageinteger

Page number (1-indexed).

page_sizeinteger

Rows per page (max 100).

Response

Successful Response

Changes

  • 291230805105Revision changes
    • breaking

      the /// response's property format changed from date-time to no format for status

    • info

      added the optional property ///// to the response with the status

    • info

      response property data/items/products/anyOf[subschema #1]/items/id deprecated

  • 7dad11366a32Revision changes
    • info

      endpoint added