tiktok-shop/
user-showcase

Recopile los productos que muestra la vitrina de Shop de un usuario público de TikTok por nombre de usuario y región, con campos de vendedor, precio, contenido multimedia, calificación, reseñas y unidades vendidas.

TikTok Shop User Showcase API

Entrada de nombre de usuario
Productos de la vitrina
Catálogos regionales
0.7 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 Shop User Showcase

Las vitrinas de usuario de TikTok Shop son exhibiciones de productos asociadas con perfiles públicos de usuarios de TikTok, con identidad del producto y del vendedor, precios, contenido multimedia, calificaciones, cantidad de reseñas y unidades vendidas cuando están expuestos. Estas señales comerciales sirven para revisar surtidos, tomar instantáneas regionales, comparar productos y enriquecer conjuntos de datos de investigación.

Funcionalidades de la TikTok Shop User Showcase API

  • Recopilación de la vitrina de un solo usuarioRecopile los productos públicos que se muestran para un nombre de usuario de TikTok, y acepte el identificador con o sin una @ inicial.
  • Selección de región de mercadoElija uno de los 16 valores de region admitidos para que la recopilación de la vitrina apunte al mercado público de TikTok Shop previsto.
  • Resultados de productos únicos y acotadosSolicite de 20 a 2,000 productos de la vitrina mientras las páginas de la recopilación se deduplican por identidad pública del producto.
  • Contexto normalizado de producto y vendedorDevuelve los ID de producto, los títulos, las descripciones, los enlaces canónicos, las imágenes, los campos del vendedor, los precios, las categorías y las estructuras de SKU cuando están expuestos.
  • Señales comerciales visibles y límites de lo públicoConserva las calificaciones, la cantidad de reseñas, las unidades vendidas, el estado, la región y la hora de recopilación disponibles, y deja vacíos los campos públicos no disponibles.

Parámetros de la TikTok Shop User Showcase API

ParámetrosObligatorioDescripción
usernameObligatorioNombre de usuario público de TikTok obligatorio. Una tarea acepta un valor, con o sin una @ inicial.
results_limitOpcionalTope solicitado de productos únicos de la vitrina, de 20 a 2,000. El valor predeterminado es 100.
regionOpcionalRegión de mercado: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP o IE. El valor predeterminado es US.

Cómo usar la TikTok Shop User Showcase API

Envíe un nombre de usuario público y un mercado como tarea asíncrona y luego lea los productos de la vitrina guardados con paginación por cursor.

  1. Prepare un nombre de usuario público de TikTok, elija una region admitida y establezca results_limit de 20 a 2,000.
  2. Envíe la solicitud por POST a /v1/tiktok-shop/user-showcase y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea llegue a succeeded o failed.
  4. Lea data.results.items. Cuando has_more sea true, continúe con next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/user-showcase" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"mrtiktokreviews","results_limit":100,"region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la TikTok Shop User Showcase API

  • Revisar el surtido de la vitrina de un usuario: Use los ID de producto, los títulos, los enlaces, el contexto del vendedor, las imágenes y las categorías para inspeccionar los productos públicos que se muestran para un nombre de usuario.
  • Comparar precios y señales de demanda visibles: Compare los precios, las monedas, los descuentos, las calificaciones, la cantidad de reseñas y las unidades vendidas disponibles entre los productos de la vitrina devueltos.
  • Crear instantáneas regionales de vitrinas: Almacene input_username, region, la identidad del producto, los campos comerciales públicos y collected_at para una revisión repetible en un momento dado.
  • Enriquecer un conjunto de datos de investigación de productos: Agregue las URL canónicas de los productos, la identidad del vendedor, el contenido multimedia, las categorías, el contexto de SKU y las métricas visibles a un conjunto de investigación existente organizado por nombre de usuario.

Consejos de expertos para la TikTok Shop User Showcase API

  • Use una misma escritura estable del nombre de usuario en todas las ejecuciones; el endpoint acepta @handle o handle y registra con cada producto el nombre de usuario de entrada normalizado.
  • Elija el mercado que corresponda al catálogo previsto, porque region tiene como valor predeterminado US y la disponibilidad pública fuera de US puede variar.
  • Defina results_limit entre 20 y 2,000 según la cobertura requerida, en lugar de suponer que cada vitrina contiene los 100 productos predeterminados.
  • Tras el éxito, siga next_cursor mientras has_more sea true para que la paginación del resultado de la tarea no deje productos guardados sin leer.
  • Deduplique las instantáneas por id de producto y trate las tareas vacías o los campos ausentes de vendedor, precio, contenido multimedia, categoría, SKU y métricas como resultados válidos de una fuente pública.

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

  • TikTok Shop Search API — Busca productos públicos de TikTok Shop por palabra clave y región de mercado, con campos de vendedor, precio, contenido multimedia, calificación, reseñas y cantidad vendida.
  • TikTok Shop Products API — Recolecta productos públicos de la URL de una tienda de TikTok Shop, con campos de vendedor, precio, contenido multimedia, categoría, SKU, calificación, reseñas y cantidad vendida.
  • TikTok Shop Product API — Obtiene un producto público de TikTok Shop desde la URL de su página de producto, con campos de vendedor, precio, contenido multimedia, categoría, SKU, calificación, reseñas y cantidad vendida.
  • TikTok Shop Product Reviews API — Recolecta reseñas públicas de la URL de la página de un producto de TikTok Shop, con campos de texto, calificación, autor, imagen, SKU, país y contexto de compra.
  • TikTok Shop Hot Products API — Recolecta los productos más vendidos de un mercado de TikTok Shop por código de región, en el orden de la clasificación, con precio, moneda, unidades vendidas, calificación y tienda.
  • TikTok Shop Categories API — Obtiene el árbol completo de categorías de un mercado de TikTok Shop con IDs, nombres, slugs en inglés, niveles, categorías padre y rutas.

Explorar otras plataformas

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

TikTok Shop User Showcase API — FAQ

TikTok Shop User Showcase API recopila los productos de Shop que se muestran públicamente para un nombre de usuario de TikTok y un mercado seleccionado. Devuelve los campos normalizados de producto, vendedor, precio, contenido multimedia, categoría, SKU, calificación, cantidad de reseñas y unidades vendidas, cuando están expuestos.

Envíe una cadena de nombre de usuario no vacía. Se aceptan tanto mrtiktokreviews como @mrtiktokreviews, y la @ inicial se elimina antes de la recopilación.

results_limit acepta enteros de 20 a 2,000 y tiene un valor predeterminado de 100. region tiene como valor predeterminado US y también acepta GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE.

Los resultados pueden incluir la identidad del producto y del vendedor, la URL canónica, el título, la descripción, las imágenes, los datos de precio, las categorías, los SKU, el estado, la calificación, la cantidad de reseñas, las unidades vendidas, el nombre de usuario de entrada, la región y la hora de recopilación.

Un perfil público puede no tener productos de vitrina disponibles en el mercado seleccionado, y el origen puede omitir los valores de vendedor, precio, contenido multimedia, categoría, SKU o métricas. Por eso una tarea exitosa puede no contener elementos o contener registros con campos opcionales vacíos.

Consulte /v1/tasks/{task_id}, lea data.results.items tras el éxito y solicite la siguiente página de resultados de la tarea con next_cursor mientras has_more sea true.

Cada producto de vitrina normalizado devuelto cuesta 0.7 créditos de SocQ. Los resultados vacíos no tienen cargo por resultados.