Clasificación de agencias - Clasificación de ventas

Introducción

Obtén datos de clasificación de ventas de agencias asociadas de TikTok, con las siguientes funciones:

• Establece parámetros de filtrado
• Ordenación personalizada de resultados

Punto de acceso de la API

    POST /agency/v1/rank/salesRank

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
filter	object	No	Parámetros de filtro
orderby	object	No	Parámetros de ordenación
page	integer	No	Número de página, valor predeterminado: 1
pagesize	integer	No	Registros por página, predeterminado: 10

Valores de filter

Campo	Tipo	Obligatorio	Descripción
region	string	No	Región
date_info	object	No	Información de fecha

Rango 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	Obligatorio	Descripción
usd_gmv	No	GMV (desc)

Solicitud Ejemplo

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

Cuerpo de la respuesta

data.total

Resultados totales

data.list

Campo	Tipo	Descripción
id	string	ID de la agencia
secid	string	Secid de la agencia
region	integer	Región
currency	integer	Moneda
gmv	integer	GMV
usd_gmv	integer	GMV (USD)
gmv_inc_rate	string	Tasa de crecimiento del GMV
commission_rate	integer	Tasa de comisión
hot_category	array<object>	Categorías populares
total_affiliate_count	integer	Total de creadores afiliados
inc_affiliate_count	integer	Nuevos creadores afiliados
sale_affiliate_count	integer	Creadores con ventas activas
product_count	integer	Total de productos
inc_product_count	integer	Nuevos productos
sale_product_count	integer	Productos con ventas activas
agency	object	Información de la agencia

data.list.agency

Campo	Tipo	Descripción
id	string	ID de la agencia
secid	string	Secid de la agencia
name	string	Nombre de la agencia
region	string	Región de la agencia
introduction	string	Introducción de la agencia
logo_cover	string	Logo de la agencia

Ejemplo de respuesta

{
  "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"
}