商品列表-按店铺名称
简介
获取指定店铺的商品列表数据,支持以下功能:
- 支持按店铺名称查询
- 支持按地区筛选
- 返回商品详细信息,包括销量、评分、相关视频数等
接口
bash
POST /product/v1/goodListByShopNamefilter 可选值
| 字段 | 类型 | 必选 | 描述 |
|---|---|---|---|
seller_name | string | 是 | 店铺名称 |
region | string | 是 | 国家/地区,例如:US |
request example
bash
curl 'https://openapi.test.fastmoss.com/product/v1/goodListByShopName?client_id=XXX×tamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
"filter": {
"seller_name": "xxxx",
"region": "US",
},
"page": 1,
"pagesize": 10
}response body
data.total
- 类型:integer
- 描述:结果总条数
data.list
| 字段 | 类型 | 描述 |
|---|---|---|
product_id | string | 商品 ID |
title | string | 商品标题 |
region | string | 国家/地区 |
sold_count | integer | 总销量 |
relate_author_count | integer | 相关作者数量 |
relate_video_count | integer | 相关视频数量 |
category | object | 商品分类 |
yday_sold_count | integer | 昨日销量 |
day7_sold_count | integer | 7 天销量 |
day28_sold_count | integer | 28 天销量 |
day90_sold_count | integer | 90 天销量 |
product_rating | float | 商品评分 |
source | string | 商品来源 |
tiktok_url | string | TikTok 商品链接 |
fastmoss_url | string | Fastmoss 商品链接 |
shop_info | object | 店铺信息 |
sku_count | integer | SKU 数量 |
data.list.category
| 字段 | 类型 | 描述 |
|---|---|---|
l1 | object | 一级分类 |
l2 | object | 二级分类 |
l3 | object | 三级分类 |
data.list.category.l1/l2/l3
| 字段 | 类型 | 描述 |
|---|---|---|
id | integer | 分类 ID |
name | string | 分类名称 |
data.list.shop_info
| 字段 | 类型 | 描述 |
|---|---|---|
seller_id | string | 店铺 ID |
name | string | 店铺名称 |
response example
json
{
"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": "美妆个护"
},
"l2": {
"id": 848648,
"name": "美妆"
},
"l3": {
"id": 601529,
"name": "美妆套装"
}
},
"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"
}