Productos promocionados por el creador
Introducción
Obtén los productos promocionados por un creador usando su uid.
Punto de acceso de la API
bash
POST /creator/v1/productListCuerpo de la solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
filter | object | Sí | Parámetros de filtro |
page | integer | No | Número de página, predeterminado: 1 |
pagesize | integer | No | Elementos por página, predeterminado: 10 |
Valores de filter
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
uid | string | Sí | UID del creador |
days | string | No | Intervalo de tiempo, e.g., [0, 7, 14, 28, 90] |
Solicitud Ejemplo
bash
curl 'https://openapi.fastmoss.com/creator/v1/productList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
"filter": {
"uid": "6893103660525831169",
"days": 7
},
"page": 1,
"pagesize": 10
}'Cuerpo de la respuesta
data.total
Número total de resultados
data.list
| Campo | Tipo | Descripción |
|---|---|---|
product_id | string | ID de producto |
uid | string | UID del creador |
seller_id | string | ID del vendedor |
commission_rate | integer | Tasa de comisión |
product_rating | string | Valoración del producto |
shop_title | string | Nombre de la tienda |
shop_avatar | string | URL del avatar de la tienda |
shop_units_count | integer | Ventas de la tienda |
shop_gmv | float | GMV de la tienda |
title | string | Título del producto |
cover | string | URL de la portada del producto |
category | array[object] | Categoría de productos |
real_price | string | Precio del producto |
region | string | Región del producto |
gmv | float | GMV del producto |
units_sold | integer | Ventas del producto |
l1_category_id | integer | ID de categoría de nivel 1 |
l2_category_id | integer | ID de categoría de nivel 2 |
l3_category_id | integer | ID de categoría de nivel 3 |
Respuesta Ejemplo
json
{
"code": 0,
"msg": "success",
"data": {
"total": 8,
"list": [
{
"product_id": "1729539239170312086",
"uid": "6893103660525831169",
"seller_id": "7494962456968727446",
"commission_rate": 0,
"product_rating": "0.0",
"shop_title": "Twobakeboys",
"shop_avatar": "https://s.500fd.com/tt_shop/6413a6ce066e4108a30e50d1033dac88~tplv-aphluv4xwc-resize-png:300:300.png",
"shop_units_count": 23867,
"shop_gmv": 607576.80,
"title": "Pineapple tart 230g per bottle",
"cover": "https://s.500fd.com/default/product_default.png",
"category": [
"Food & Beverages"
],
"real_price": "S$15.00",
"region": "SG",//product's region
"gmv": 0,
"units_sold": 0,
"l1_category_id":24,//product's l1 category_id
"l2_category_id":915336,//product's l2 category_id
"l3_category_id":700553//product's l3 category_id
}
]
}
}