tiktok/
live-products

Liste los productos de la bolsa de compras de una transmisión de TikTok LIVE a partir de su ID de sala y del ID del anfitrión: título, precio actual, unidades vendidas, ID del vendedor, enlace del producto e imagen.

TikTok Live Shopping API

IDs de sala y anfitrión
Productos de la bolsa de compras
Hasta 500 productos
0.1 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

TikTok Live Shopping

La bolsa de compras de una transmisión de TikTok LIVE es el conjunto de productos que un anfitrión vende durante la emisión, y cada producto tiene un título, un precio en una moneda indicada, un conteo de unidades vendidas, un vendedor y una imagen. Leer una bolsa muestra qué está impulsando una transmisión, a qué precios se ofrecen esos artículos mientras el anfitrión está al aire y cuáles ya se venden en volumen.

Funcionalidades de la TikTok Live Shopping API

  • Cada producto de la bolsaroom_id junto con el user_id del anfitrión devuelve cada producto de la bolsa de compras de la sala como un registro propio, hasta los 500 que permite results_limit.
  • Precio como monto, moneda y texto para mostrarprice.amount, price.currency y price.formatted entregan el número, el código de moneda y el texto que ven los espectadores, por ejemplo 41.6, USD y $41.60.
  • Unidades vendidas como enterosold_count es un número entero como 101600, así que las bolsas se pueden ordenar y comparar directamente.
  • Enlace del producto, ID del vendedor e imagenCada registro trae la página del producto en url, el ID del vendedor en seller.id y la imagen del producto con su ancho y alto en media.

Parámetros de la TikTok Live Shopping API

ParámetrosObligatorioDescripción
room_idObligatorioID numérico de la sala LIVE, tomado del id de un resultado de TikTok Live Search.
user_idObligatorioID numérico de usuario de TikTok del anfitrión, tomado del author.id del mismo resultado de Live Search.
results_limitOpcionalCuántos productos se devuelven, de 1 a 500. El valor predeterminado es 100.

Cómo usar la TikTok Live Shopping API

Encuentre una transmisión de ventas en vivo y liste su bolsa mientras está al aire.

  1. Ejecute TikTok Live Search con una palabra clave de compras y tome el id y el author.id de un resultado.
  2. Envíe {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} por POST a /v1/tiktok/live-products.
  3. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded, luego lea los productos en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'

# Each item is one product with title, price and sold_count.

Casos de uso de la TikTok Live Shopping API

  • Leer la bolsa en vivo de un competidor: Tome el room_id y el user_id de un anfitrión rival desde Live Search y liste toda la bolsa para ver qué productos y niveles de precio está manejando.
  • Ver cómo se mueven los precios durante una transmisión: Lea la misma sala cada pocos minutos y compare price.amount por cada id de producto para detectar las rebajas que el anfitrión anuncia al aire.
  • Encontrar los más vendidos de una bolsa: Ordene una bolsa por sold_count para ver qué artículos ya movieron más unidades y contrástelos con su precio.

Consejos de expertos para la TikTok Live Shopping API

  • Revise price.currency antes de comparar precios entre salas, ya que el monto solo tiene sentido junto con su moneda.
  • Relacione un mismo producto entre lecturas por su id; price.amount y sold_count son los campos que cambian.

Además de la TikTok Live Shopping API, use estas APIs cuando necesite otro tipo de datos públicos de TikTok.

  • TikTok Profiles API — Obtiene por nombre de usuario la identidad del perfil público, biografías, indicadores de cuenta y conteos de audiencia.
  • TikTok Hashtags API — Recolecta videos públicos, creadores, contenido multimedia, sonido e interacción de los hashtags indicados.
  • TikTok Comments API — Recolecta comentarios públicos de primer nivel, autores, interacción, menciones e indicadores de interacción del creador.
  • TikTok Videos API — Obtiene el creador, la descripción, el contenido multimedia, la música, las etiquetas, las menciones y la interacción desde URLs de videos.
  • TikTok Live Room Info API — Consulta una transmisión en vivo conocida mediante el par de IDs de la sala y del propietario, y devuelve su estado, el contexto del propietario, la portada y los conteos de audiencia.
  • TikTok Live Search API — Encuentra por palabra clave transmisiones en vivo que están al aire, con anfitriones, títulos y espectadores actuales.

Explorar otras plataformas

Combine los datos de TikTok con datos públicos de otras plataformas sociales compatibles.

TikTok Live Shopping API — FAQ

TikTok Live Shopping API es una interfaz programática para listar los productos de la bolsa de compras de una transmisión de TikTok LIVE, a partir del room_id de la transmisión y del user_id del anfitrión. Devuelve el título, el precio, las unidades vendidas, el ID del vendedor, el enlace y la imagen de cada producto.

Ejecute TikTok Live Search y tome el id de un resultado como room_id y su author.id como user_id. El par debe provenir del mismo resultado.

results_limit acepta de 1 a 500 y vale 100 por defecto, y se detiene antes si la bolsa es más pequeña. Cada producto devuelto se factura a 0.1 créditos, así que una bolsa completa de 500 productos cuesta 50 créditos.

El anfitrión no tiene una bolsa de compras en esa sala, o la sala ya no está al aire. Un resultado vacío no se factura.

No, la sala debe estar al aire cuando solicita la bolsa. Léala mientras la transmisión sigue y guárdela si necesita la lista de productos más adelante.

sold_count es la cifra de unidades vendidas que TikTok informa para el producto, y es null cuando no informa ninguna. Para ver qué se mueve durante una transmisión, lea la bolsa dos veces y reste.