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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | URL 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_limit | Opcional | Má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. |
region | Opcional | Regió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.
- Prepare una url PDP de TikTok Shop admitida, un results_limit de 20 a 2,000 y la región de mercado del producto.
- Envíe la solicitud por POST a /v1/tiktok-shop/product-reviews y guarde el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} hasta que la tarea tenga éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.