Danh sách sản phẩm theo tên cửa hàng

Giới thiệu

Lấy dữ liệu danh sách sản phẩm cho một cửa hàng xác định với các tính năng sau:

• Tìm theo tên cửa hàng
• Lọc theo khu vực
• Trả về thông tin sản phẩm chi tiết bao gồm sản lượng bán, điểm đánh giá và số video liên quan

API

    POST /product/v1/goodListByShopName

Tham số yêu cầu

Tham số yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
filter	object	Không	Tham số lọc
orderby	object	Không	Tham số sắp xếp
page	integer	Không	Mặc định:1
pagesize	integer	Không	Mặc định:10

Giá trị tùy chọn của bộ lọc

Trường	Kiểu	Bắt buộc	Mô tả
seller_name	string	Có	Tên cửa hàng
region	string	Có	Quốc gia/Khu vực, ví dụ US

Ví dụ yêu cầu

curl 'https://openapi.fastmoss.com/product/v1/goodListByShopName' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "seller_name": "xxxx",
        "region": "US",

    },
    "page": 1,
    "pagesize": 10
}'

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

data.total

• Kiểu: integer
• Mô tả: Tổng số kết quả

data.list

Trường	Kiểu	Mô tả
product_id	string	ID sản phẩm
title	string	Tiêu đề sản phẩm
region	string	Quốc gia/Khu vực
sold_count	integer	Tổng sản lượng bán
relate_author_count	integer	Số tác giả liên quan
relate_video_count	integer	Số video liên quan
category	object	Danh mục sản phẩm
yday_sold_count	integer	Sản lượng bán hôm qua
day7_sold_count	integer	Sản lượng bán 7 ngày
day28_sold_count	integer	Sản lượng bán 28 ngày
day90_sold_count	integer	Sản lượng bán 90 ngày
product_rating	float	Điểm đánh giá sản phẩm
source	string	Nguồn sản phẩm
tiktok_url	string	URL sản phẩm TikTok
fastmoss_url	string	URL sản phẩm Fastmoss
shop_info	object	Thông tin cửa hàng
sku_count	integer	Số lượng SKU

data.list.category

Trường	Kiểu	Mô tả
l1	object	Danh mục cấp 1
l2	object	Danh mục cấp 2
l3	object	Danh mục cấp 3

data.list.category.l1/l2/l3

Trường	Kiểu	Mô tả
id	integer	ID danh mục
name	string	Tên danh mục

data.list.shop_info

Trường	Kiểu	Mô tả
seller_id	string	ID cửa hàng
name	string	Tên cửa hàng

Ví dụ phản hồi

{
  "code": 0,
  "data": {
    "list": [
      {
        "product_id": "1729415053505106876",
        "title": "tarte best-sellers trending trio - lip plump gloss, mascara & eye pencil set",
        "region": "US",
        "sold_count": 305746,
        "relate_author_count": 11521,
        "relate_video_count": 8371,
        "category": {
          "l1": {
            "id": 14,
            "name": "Beauty & Personal Care"
          },
          "l2": {
            "id": 848648,
            "name": "Beauty"
          },
          "l3": {
            "id": 601529,
            "name": "Beauty Sets"
          }
        },
        "yday_sold_count": 7,
        "day7_sold_count": 102,
        "day28_sold_count": 419,
        "day90_sold_count": 1636,
        "product_rating": 4.7,
        "source": "TikTok Shop",
        "tiktok_url": "https://shop.tiktok.com/view/product/1729415053505106876?region=US&local=en",
        "fastmoss_url": "https://www.fastmoss.com/ZH_CN/e-commerce/detail/1729415053505106876",
        "shop_info": {
          "seller_id": "7495150597721263036",
          "name": "Tarte Cosmetics"
        },
        "sku_count": 6
      }
    ],
    "total": 17
  },
  "message": "",
  "timestamp": 1743577374,
  "request_id": "6d4024ec-bed1-3701-7999-94e88a762d10"
}