Skip to main content

List Product Videos

GET 

/api/products/:product/videos

List a product's videos (archived ones excluded), in sort order.

Required scope: products:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Each video carries its upload/probe status, the probed metadata (duration, size, frame rate, codecs, sha256), a TikTok-fit pre-check (tiktok_fit: ready = vertical 9:16-ish H.264/H.265/VP8/VP9, 23–60 fps, each side 360–4096 px, at most 10 minutes; letterboxed = accepted but not vertical; unsupported = TikTok would reject it or its length couldn't be read, see tiktok_fit_reason), download_url (null until the video is ready) and in_use_by_post_ids: open TikTok posts that block deleting it.

Poll every few seconds while any video is processing.

Authentication: Requires Bearer token (scope products:read). Available to users who can view products or create TikTok posts.

Request​

Responses​

OK

Response Headers
    Content-Type