Danh sách video liên quan đến sản phẩm

Giới thiệu

Lấy danh sách video liên quan đến các sản phẩm xác định với các tính năng sau:

• Tìm theo ID sản phẩm
• Trả về thông tin video chi tiết, bao gồm mô tả video, số lượt phát và dữ liệu tương tác
• Bao gồm dữ liệu bán hàng liên quan đến video, chẳng hạn như sản lượng bán và doanh thu

Endpoint API

    POST /product/v1/videoList

Tham số yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
product_id	string	Có	ID sản phẩm
days	int	Không	N ngày gần đây (thời gian đăng)
create_time_range	int	Không	Khoảng thời gian đăng video ( unix timestamp )
is_ad	int	Không	Có phải quảng cáo (0: Không, 1: Có)

Lưu ý: days và create_time_range không thể được truyền cùng nhau

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/videoList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "product_id": "1729421229342823356",
        # "days": 3,
        "create_time_range": {
          "min": 1767196800,
          "max": 1777278619
        }
    },
    "orderby": {
        "field": "play_count",
        "order": "desc"
    },
    # "orderby": {
    #     "field": "digg_count",
    #     "order": "desc"
    # },
    # "orderby": {
    #     "field": "comment_count",
    #     "order": "desc"
    # },
    # "orderby": {
    #     "field": "share_count",
    #     "order": "desc"
    # },
    # "orderby": {
    #     "field": "units_sold",
    #     "order": "desc"
    # },
    # "orderby": {
    #     "field": "gmv",
    #     "order": "desc"
    # },
    "page": 1,
    "pagesize": 10
}'

Phần thân phản hồi

data.list

Trường	Kiểu	Mô tả
product_id	string	ID sản phẩm
video_id	string	ID video
uid	string	ID người dùng
seller_id	string	ID người bán
is_ad	int	Có phải quảng cáo
comment_count	int	Số bình luận
digg_count	int	Số lượt thích
play_count	int	Số lượt phát
share_count	int	Số lượt chia sẻ
create_date	string	Ngày tạo
units_sold	int	Sản lượng bán
gmv	float	Doanh thu bán hàng
region	string	Quốc gia/Khu vực
video	object	Đối tượng thông tin video

data.list.video

Trường	Kiểu	Mô tả
video_desc	string	Mô tả video
cover	string	URL ảnh bìa
duration	int	Thời lượng (giây)
fastmoss_url	string	Liên kết Fastmoss
tiktok_url	string	Liên kết TikTok
uid	string	ID người dùng
create_time	timestamp	Thời gian tạo

data.total

Trường	Kiểu	Mô tả
total	string	Tổng số bản ghi

Ví dụ phản hồi

{
  "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_time": 1765024218000,
        "units_sold": 28,
        "gmv": 700.0,
        "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"
}