Classificação de agências - Classificação de vendas

Introdução

Obtém os dados de classificação de vendas das agências parceiras do TikTok, com os seguintes recursos:

• Definir parâmetros de filtro
• Personalizar a ordenação dos resultados

Endpoint da API

    POST /agency/v1/rank/salesRank

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	Número da página, valor padrão: 1
pagesize	integer	Não	Registros por página, padrão: 10

Valores de filter

Campo	Tipo	Obrigatório	Descrição
region	string	Não	Região
date_info	object	Não	Informações de data

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

Valores de orderby

Campo	Obrigatório	Descrição
usd_gmv	Não	GMV (decrescente)

Exemplo de solicitação

curl 'https://openapi.fastmoss.com/agency/v1/rank/salesRank' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "region": "US",
        "date_info": {
            "type": "week",
            "value": "2026-05"
        }
    },
    "orderby": [
      {
        "field": "usd_gmv",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}'

Corpo da resposta

data.total

Total de resultados

data.list

Campo	Tipo	Descrição
id	string	ID da agência
secid	string	secid da agência
region	integer	Região
currency	integer	Moeda
gmv	integer	GMV
usd_gmv	integer	GMV em USD
gmv_inc_rate	string	Taxa de crescimento do GMV
commission_rate	integer	Taxa de comissão
hot_category	array<object>	Categorias populares
total_affiliate_count	integer	Total de criadores afiliados
inc_affiliate_count	integer	Novos criadores afiliados
sale_affiliate_count	integer	Criadores com vendas ativas
product_count	integer	Total de produtos
inc_product_count	integer	Novos produtos
sale_product_count	integer	Produtos com vendas ativas
agency	object	Informações da agência

data.list.agency

Campo	Tipo	Descrição
id	string	ID da agência
secid	string	secid da agência
name	string	Nome da agência
region	string	Região da agência
introduction	string	Introdução da agência
logo_cover	string	Logotipo da agência

Exemplo de resposta

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": "8649512756612795142",
        "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
        "region": "GB",
        "currency": "GBP",
        "gmv": 209066.76,
        "usd_gmv": 259242.78,
        "gmv_inc_rate": "-24.91%",
        "commission_rate": 990,
        "hot_category": [
          { "category_id": 14, "name": "Beauty & Personal Care" },
          { "category_id": 2, "name": "Womenswear & Underwear" },
          { "category_id": 3, "name": "Menswear & Underwear" }
        ],
        "total_affiliate_count": 301,
        "inc_affiliate_count": 67,
        "sale_affiliate_count": 138,
        "product_count": 63610,
        "inc_product_count": 656,
        "sale_product_count": 22035,
        "agency": {
          "id": "8649512756612795142",
          "secid": "7c3d85e96c36244a5f5184a5cfbb98f6",
          "name": "VibraVerse",
          "region": "GB",
          "introduction": "",
          "logo_cover": "https://s.500fd.com/tt_partner/wsos65b11f86df324b05"
        }
      }
    ],
    "total": 500,
    "date_type": "week",
    "date_value": "2026-03"
  },
  "msg": "success"
}