Lista de transmisiones en directo relacionadas con tiendas

Introducción

Obtén los datos de la lista de transmisiones en directo relacionadas con una tienda específica.

Punto de acceso de la API

    POST /shop/v1/liveList

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
filter	object	No	Parámetros de filtro
orderby	array	No	Parámetros de ordenación
page	integer	No	Predeterminado: 1
pagesize	integer	No	Predeterminado: 10

filter Valores opcionales

Campo	Tipo	Obligatorio	Descripción
seller_id	string	No	ID de tienda
creator_uid	string	No	UID del creador asociado a la tienda
creator_unique_id	string	No	ID único del creador asociado a la tienda: @xxxxxxx
seller_name	string	No	Nombre de la tienda
region	string	No	País/Región de la tienda

seller_name y region deben pasarse al mismo tiempo

orderby Valores opcionales

Campo	Obligatorio	Descripción
start_time	No	Hora de inicio
product_count	No	Número de productos en la sala de directo
total_user_count	No	Número total de espectadores
units_sold	No	Volumen de ventas
gmv	No	Monto de ventas (GMV)

Solicitud Ejemplo

curl 'https://openapi.fastmoss.com/shop/v1/liveList' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer xxxxxxxxxx' \
--data '{
    "filter": {
        "seller_id": "7495500842223700917",
        # "creator_uid": "6913013214088004614",
        # "creator_unique_id": "caffeinecandleschaos",

        # "seller_name": "Caffeine, Candles & Chaos",
        # "region": "US",
    },
    "orderby": [{
        "field": "start_time",
        "order": "desc"
    }],
    # "orderby": [{
    #     "field": "product_count",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "total_user_count",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "units_sold",
    #     "order": "desc"
    # }],
    # "orderby": [{
    #     "field": "gmv",
    #     "order": "desc"
    # }],
    "page": 1,
    "pagesize": 10
}'

Cuerpo de la respuesta

data.list

Campo	Tipo	Descripción
title	string	Título de la sala de directo
room_id	string	ID de la sala de directo
seller_id	string	ID de tienda
uid	string	UID del creador asociado a la tienda
cover	string	URL de la imagen de portada
main_category_name	string	Nombre de la categoría principal promocionada
main_category_id	int	ID de la categoría principal promocionada
start_time	int	Hora de inicio
units_sold	int	Volumen de ventas
gmv	float	Monto de ventas (GMV)
product_count	int	Número de productos en la sala de directo
total_user	int	Número total de espectadores
duration	int	Duración del directo (segundos)
max_user_count	int	Número máximo de espectadores concurrentes
inc_follower_count	int	Crecimiento de seguidores
share_count	int	Número de compartidos
is_live	int	Indica si está en directo actualmente
live_type	int	Tipo de directo 1: Directo de tienda 2: Directo individual
creator	object	Información del creador asociado

data.list.creator

Campo	Tipo	Descripción
uid	string	ID de usuario
nickname	string	Apodo del usuario
unique_id	string	ID único del usuario
avatar	string	URL del avatar del usuario
region	string	País/Región del usuario
follower_count	int	Número de seguidores del usuario
category_id	int	ID de categoría del usuario
category_name	string	Nombre de categoría del usuario

data.total

Campo	Tipo	Descripción
total	string	Número total de registros

Respuesta Ejemplo

{
  "code": 0,
  "data": {
    "total": 11943,
    "list": [
      {
        "title": "Food and snacks",
        "room_id": "7539139975317703438",
        "cover": "https://s.500fd.com/tt_live/7411364270883588910~tplv-obj.image",
        "main_category_id": 24,
        "main_category_name": "Food & Beverages",
        "creator": {
          "uid": "73083231876554752",
          "avatar": "https://s.500fd.com/tt_author/5aa17bc74b4fd2b91ae364d2a2c6e4d6~tplv-tiktokx-cropcenter:1080:1080.jpeg",
          "region": "US",
          "nickname": "Courtney Luper 🗝️✨",
          "unique_id": "courtneyluper",
          "follower_count": 17183,
          "category_id": 5,
          "category_name": "Food & Beverage"
        },
        "start_time": 1755343248,
        "units_sold": 1939,
        "gmv": 4253.69,
        "product_count": 99,
        "total_user": 84333,
        "duration": 37159,
        "max_user_count": 430,
        "inc_follower_count": 243,
        "share_count": 188,
        "is_live": 0,
        "live_type": 2
      }
    ]
  },
  "message": "success",
  "timestamp": 1773751121,
  "request_id": "76d984e2-e0f8-d04c-dc2d-c1fc9a18ffda"
}