Classificações de transmissões ao vivo - Produtos em tendência

Introdução

Obtém os dados de classificação dos produtos em tendência nas transmissões ao vivo do TikTok

• Oferece suporte a parâmetros de filtro
• Oferece suporte à ordenação personalizada dos resultados

Endpoint da API

    POST /live/v1/rank/topProduct

Corpo da solicitação

Campo	Tipo	Obrigatório	Descrição
filter	object	Não	Parâmetros de filtro
orderby	object	Não	Parâmetros de ordenação
page	integer	Não	Padrão: 1
pagesize	integer	Não	Padrão: 10

page * pagesize <= 500

Intervalo de pagesize [1, 100]

Valores opcionais de filter

Campo	Tipo	Obrigatório	Descrição
region	string	Não	País/região
category_id	integer	Não	Categoria do produto (Nível 1)
date_info	object	Sim	Informações de data: diária, semanal, mensal

Intervalo de region: ['US','GB','MX','ES','DE','IT','FR','PT','NL','BE','AT','PL','ID','VN','MY','TH','PH','BR','JP','SG']

Valores opcionais de orderby

Campo	Obrigatório	Descrição
units_sold	Não	Volume de vendas (decrescente)
gmv	Não	Receita (decrescente)
live_count	Não	Número de sessões ao vivo (decrescente)

Exemplo de solicitação

curl 'https://openapi.fastmoss.com/live/v1/rank/topProduct' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "category_id": 14,
        # "date_info": {
        #     "type": "day",
        #     "value": "2026-04-01"
        # },
        "date_info": {
            "type": "week",
            "value": "2026-13"
        }
        # ,
        # "date_info": {
        #     "type": "month",
        #     "value": "2026-04"
        # }
    },
     "orderby": [
      {
        "field": "units_sold",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

Corpo da resposta

data.total

Número total de resultados

data.list

Campo	Tipo	Descrição
product	object	Informações do produto
shop	object	Informações da loja
top_live	array[object]	Principais transmissões ao vivo por vendas
units_sold	integer	Volume de vendas na transmissão ao vivo
gmv	integer	Receita da transmissão ao vivo
usd_gmv	integer	Receita da transmissão ao vivo (USD)
currency	string	Moeda
live_count	integer	Número de sessões ao vivo

data.list:product

Campo	Tipo	Descrição
product_id	string	ID do produto
title	string	Título do produto
cover	string	URL da capa do produto
real_price	string	Preço do produto
currency	string	Moeda
region	string	País/região
category	object	Categoria do produto

data.list:product:category

Campo	Tipo	Descrição
l1	object	Categoria nível 1
l2	object	Categoria nível 2
l3	object	Categoria nível 3

data.list:shop

Campo	Tipo	Descrição
seller_id	string	ID da loja
name	string	Nome da loja
region	string	País/região
avatar	string	URL do logotipo da loja

data.list:top_live

Campo	Tipo	Descrição
room_id	string	ID da sala de transmissão ao vivo
title	string	Título da transmissão ao vivo
cover	string	URL da capa da transmissão ao vivo
gmv	integer	Receita da transmissão ao vivo
units_sold	integer	Volume de vendas na transmissão ao vivo
currency	string	Moeda
region	string	País/região

Exemplo de resposta

{
  "code": 0,
  "data": {
    "list": [
      {
        "product": {
          "product_id": "1729707172352594230",
          "title": "BASED Leave-in Conditioner | Instant Hydration & Anti-Frizz | Simple, Effective, BASED.",
          "cover": "https://s.500fd.com/tt_product/413c08135c3f48e480af5dd9aa5f60c2~tplv-fhlh96nyum-resize-jpeg:800:800.jpeg",
          "region": "US",
          "currency": "USD",
          "real_price": "$17.00",
          "category": {
            "l1": {
              "id": 14,
              "name": "Beauty & Personal Care"
            },
            "l2": {
              "id": 848904,
              "name": "Haircare & Styling"
            },
            "l3": {
              "id": 601469,
              "name": "Shampoo & Conditioner"
            }
          }
        },
        "shop": {
          "seller_id": "7495079418085345590",
          "name": "BASED",
          "avatar": "https://s.500fd.com/tt_shop/c4e48f5ff0b242968e1d6212f3ab93f0~tplv-omjb5zjo8w-resize-png:300:300.png",
          "region": "US"
        },
        "rank_category": {
          "category_id": "14",
          "name": "Beauty & Personal Care"
        },
        "top_live": [
          {
            "room_id": "7619504259826060063",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
            "gmv": 14075,
            "units_sold": 563,
            "currency": "USD"
          },
          {
            "room_id": "7619504259826060063",
            "title": "Spring Glow Up LIVE",
            "region": "US",
            "cover": "https://s.500fd.com/tt_live/55014e26dbf474c4a27a302cea499131~tplv-tiktokx-cropcenter:720:720.jpeg",
            "gmv": 13850,
            "units_sold": 554,
            "currency": "USD"
          }
        ],
        "live_units_sold": 2985,
        "live_gmv": 74625,
        "live_usd_gmv": 74625,
        "live_count": 17
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-13"
  },
  "message": "",
  "timestamp": 1777355755,
  "request_id": "7582c9e8-dc04-101a-5d39-cdd032716713"
}