---
title: "Category-trending TikTok videos for this shop's categories"
method: GET
path: "/seller-center/trending-videos"
tags: ["Seller Center"]
---

# Category-trending TikTok videos for this shop's categories

`GET /seller-center/trending-videos`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/seller-center/trending-videos`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

The most-viewed videos across the product categories this shop sells in, from `customers.sc_top_viewed_videos` — competitive intelligence, **not** the shop's own content (for that use GET /videos).

Each entry carries the video's rank and rank change, the creator's public handle, the view bucket TikTok reports (`views_min` / `views_max` — TikTok does not publish an exact count here) and the product the video links to, with its price range and rating.

No date window: the latest collected snapshot is returned, and its range is echoed as `start_date` / `end_date`. Collection is currently paused upstream, so the response reflects the last snapshot collected for the shop. Single-shop only — set `x-shop-id` to a specific shop ID. An empty result is a normal 200 response: Seller Center collection is per-shop and still rolling out.

## Query parameters

- `limit` integer: Max videos (max 200).

## Response `200`

Successful Response

- TrendingVideosResponse
  - `shop_id` integer, required
  - `start_date` string, nullable: Start of the ranked snapshot.
  - `end_date` string, nullable: End of the ranked snapshot.
  - `data` TrendingVideo[], required
    - `video_id` string, required
    - `video_title` string, nullable
    - `thumbnail_url` string, nullable
    - `posted_at_epoch` integer, nullable: Unix timestamp TikTok reports for the video's creation.
    - `creator_name` string, nullable: Public TikTok handle.
    - `creator_id` string, nullable
    - `rank` integer, nullable
    - `rank_change` integer, nullable: Positions gained (+) or lost (-) since the previous ranking.
    - `views_min` number, nullable: TikTok reports views as a bucket, not an exact count.
    - `views_max` number, nullable
    - `similar_videos_on_site` integer, nullable
    - `linked_product` TrendingVideoProduct, required
      - `product_id` string, nullable
      - `product_name` string, nullable
      - `price_min` number, nullable
      - `price_max` number, nullable
      - `rating` number, nullable
      - `review_count` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)