Product-Related Video List

Introduction

Retrieve a list of videos related to specified products with the following features:

• Search by product ID
• Returns detailed video information, including video description, play count, and engagement data
• Includes sales data associated with videos, such as sales volume and revenue

API Endpoint

    POST /product/v1/video

Request Parameters

Field	Type	Required	Description
product_id	string	Yes	Product ID
date_type	integer	Yes	Time range, e.g., 25 for last 25 days, max 28 days

Request Example

curl 'https://openapi.test.fastmoss.com/product/v1/video?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "filter": {
        "product_id": "1729421229342823356",
        "date_type": "7"
    },
    "page": 1,
    "pagesize": 10
}

Response Body

data.list

Field	Type	Description
product_id	string	Product ID
video_id	string	Video ID
uid	string	User ID
is_ad	string	Is Advertisement
seller_id	string	Seller ID
comment_count	string	Comment Count
digg_count	string	Like Count
play_count	string	Play Count
share_count	string	Share Count
create_date	string	Creation Date
sold_count	string	Sales Volume
sale_amount	string	Sales Revenue
region	string	Country/Region
video	object	Video Info Object

data.list.video

Field	Type	Description
video_desc	string	Video Description
cover	string	Cover Image URL
duration	string	Duration (seconds)
fastmoss_url	string	Fastmoss Link
tiktok_url	string	TikTok Link
uid	string	User ID

data.total

Field	Type	Description
total	string	Total Records

Response Example

{
  "code": 0,
  "data": {
    "list": [
      {
        "product_id": "1729421229342823356",
        "video_id": "7468186866076880170",
        "uid": "6790997286808093702",
        "is_ad": "0",
        "seller_id": "7495150597721263036",
        "comment_count": "0",
        "digg_count": "14",
        "play_count": "4592",
        "share_count": "0",
        "create_date": "2025-02-06",
        "sold_count": "28",
        "sale_amount": "700.0000",
        "video": {
          "video_desc": "@tarte cosmetics #tiktokshoploveatfirstfind #fypシ #tartecosmetics ",
          "cover": "https://s.500fd.com/tt_video/oIMPp5BmEi2ZEHYBiVzCkBKA0IlmpTGfwAhiOI",
          "duration": "12",
          "fastmoss_url": "https://www.fastmoss.com/zh/media-source/video/7468186866076880170",
          "tiktok_url": "https://www.tiktok.com/@brriiddgett/video/7468186866076880170",
          "uid": "6790997286808093702"
        },
        "region": "US"
      }
    ],
    "total": "3809"
  },
  "message": "success",
  "timestamp": 1743573480,
  "request_id": "efd631c4-92cf-5d27-4f41-de09f20dd714"
}