tiktok-shop/
product-reviews

Recopile reseñas públicas de TikTok Shop a partir de la URL PDP de un producto, con texto de la reseña, calificaciones, datos del autor, imágenes, SKU y contexto de compra como registros normalizados.

TikTok Shop Product Reviews API

URL PDP de un solo producto
Texto y calificaciones de reseñas públicas
SKU y contexto de compra
Recopilación según la región
0.3 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 Product Reviews

Las reseñas de productos de TikTok Shop son registros públicos de opiniones de clientes con texto, calificaciones, nombres de los autores, imágenes, fechas, datos del SKU, países e indicadores explícitos del estado de compra. Estos campos sirven para analizar la opinión sobre los productos, comparar variantes y regiones, y armar flujos de reseñas que tengan en cuenta la evidencia.

Funcionalidades de la TikTok Shop Product Reviews API

  • Un producto con alcance regionalEnvíe una URL PDP pública admitida con una región de mercado y recopile las reseñas únicas que se exponen para ese producto, hasta el límite solicitado.
  • Contenido de la reseña, calificación, autor y contenido multimediaCada registro normalizado conserva el texto de la reseña expuesto, la calificación numérica, la identidad del autor, las imágenes, la hora de publicación, la URL del producto y la hora de recopilación.
  • Contexto de producto, SKU, país y compraLos registros de reseñas conservan los identificadores de producto y de SKU, las especificaciones de la variante, el país de la reseña y los indicadores explícitos de compra verificada o de reseña con incentivo cuando se proporcionan.

Parámetros de la TikTok Shop Product Reviews API

ParámetrosObligatorioDescripción
urlObligatorioURL pública obligatoria de TikTok Shop que coincida con /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}; una tarea acepta un producto.
results_limitOpcionalMáximo de reseñas únicas que se guardan entre las páginas de origen; el valor predeterminado es 100 y acepta enteros de 20 a 2,000.
regionOpcionalRegión de mercado de TikTok Shop; el valor predeterminado es US, y la disponibilidad pública de productos o reseñas en otras regiones aceptadas puede variar.

Cómo usar la TikTok Shop Product Reviews API

Envíe una URL de producto admitida, siga la tarea asíncrona y lea los registros normalizados de reseñas con paginación por cursor.

  1. Prepare una url PDP de TikTok Shop admitida, un results_limit de 20 a 2,000 y la región de mercado del producto.
  2. Envíe la solicitud por POST a /v1/tiktok-shop/product-reviews y guarde el task_id devuelto.
  3. Consulte GET /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
  4. Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","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 Product Reviews API

  • Análisis de la opinión sobre productos: Use el texto de las reseñas, las calificaciones numéricas, las fechas y la identidad del producto para examinar la opinión pública devuelta para un producto conocido.
  • Comparación de opiniones por SKU y región: Agrupe los registros por especificación de SKU o por país de la reseña y compare su texto y sus calificaciones, sin inferir valores para los campos ausentes.
  • Inspección del contexto de compra y de las imágenes de reseñas: Revise las imágenes proporcionadas por los clientes y segmente los registros por los indicadores explícitos de compra verificada o de reseña con incentivo cuando esos valores están presentes.

Consejos de expertos para la TikTok Shop Product Reviews API

  • Valide antes del envío que la entrada sea una URL PDP completa de tiktok.com con un ID de producto numérico, porque se rechazan las URL de perfiles, videos, tiendas y otras URL de TikTok.
  • Elija la región que corresponda al mercado del producto; una URL válida aún puede no devolver reseñas públicas cuando el mercado seleccionado no expone el producto ni su feed de reseñas.
  • Defina results_limit entre 20 y 2,000 según la cobertura de recopilación y luego siga next_cursor hasta que has_more sea false para leer todas las páginas de resultados almacenadas.
  • Trate como desconocidos el texto de reseña, la identidad del autor, los datos del SKU y los indicadores de estado de compra que estén ausentes; un booleano ausente no es false, y un registro con solo calificación sigue siendo válido.

Además de la TikTok Shop Product Reviews 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 User Showcase API — Recolecta los productos públicos de la vitrina de un nombre de usuario de TikTok, con precio, vendedor, contenido multimedia, calificación, reseñas, cantidad vendida y contexto regional.
  • 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 Product Reviews API — FAQ

TikTok Shop Product Reviews API obtiene las reseñas públicas de clientes de una URL PDP de TikTok Shop admitida. Devuelve el texto de la reseña, las calificaciones, los datos del autor, las imágenes, las fechas, el contexto de producto y SKU, los países y los indicadores explícitos del estado de compra, todo normalizado.

Use una URL de tiktok.com o de un subdominio de TikTok cuya ruta coincida con /shop/pdp/{numeric_id} o /shop/pdp/{slug}/{numeric_id}. region tiene como valor predeterminado US y acepta US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP e IE.

Los campos informan únicamente los valores explícitos que se proporcionan con la reseña pública. Cuando uno de los dos está ausente, trate su valor como desconocido y no como false, y no infiera la verificación de la compra ni el estado de incentivo.

results_limit es un máximo, no una cantidad garantizada. La recopilación se detiene en el feed de reseñas disponible, en un límite has_more del origen o en el límite definido, y un producto eliminado, no disponible, restringido por región o inaccesible públicamente puede no producir registros.

Cada reseña guardada cuesta 0.3 créditos de SocQ, incluida cada reseña única almacenada entre las páginas de origen. Una tarea sin reseñas guardadas no tiene cargo por resultados.