Skip to content

Produtos promovidos por criadores

Introdução

Obtém os produtos promovidos por um criador usando o uid dele.

Endpoint da API

bash
POST /creator/v1/productList

Corpo da solicitação

CampoTipoObrigatórioDescrição
filterobjectSimParâmetros de filtro
pageintegerNãoNúmero da página, padrão: 1
pagesizeintegerNãoItens por página, padrão: 10

Opções de filter

CampoTipoObrigatórioDescrição
uidstringSimUID do criador
daysstringNãoIntervalo de tempo, por exemplo [0, 7, 14, 28, 90]

Exemplo de solicitação

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
}'

Corpo da resposta

data.total

Número total de resultados

data.list

CampoTipoDescrição
product_idstringID do produto
uidstringUID do criador
seller_idstringID do vendedor
commission_rateintegerTaxa de comissão
product_ratingstringAvaliação do produto
shop_titlestringNome da loja
shop_avatarstringURL do avatar da loja
shop_units_countintegerVendas da loja
shop_gmvfloatGMV da loja
titlestringTítulo do produto
coverstringURL da capa do produto
categoryarray[object]Categoria do produto
real_pricestringPreço do produto
regionstringRegião do produto
gmvfloatGMV do produto
units_soldintegerVendas do produto
l1_category_idintegerID da categoria nível 1
l2_category_idintegerID da categoria nível 2
l3_category_idintegerID da categoria nível 3

Exemplo de resposta

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
      }
     ]
 }
}