La investigación de productos en TikTok Shop empieza con tres preguntas: qué se vende en un mercado, qué hay dentro de una categoría y qué escriben los compradores cuando buscan. SocQ ya devolvía búsqueda de productos, catálogos de tiendas, páginas de producto, reseñas y escaparates de creadores; las 7 mejores APIs y scrapers de TikTok Shop los compara. El 2026-11-17 se añadieron cuatro endpoints a la página de la plataforma TikTok Shop para responder directamente a esas tres preguntas.
Esta guía explica qué devuelve cada endpoint, la solicitud, el precio y cómo encadenarlos para recorrer una categoría.
Respuesta rápida: envíe un cuerpo JSON a
POST https://api.socq.ai/v1/tiktok-shop/<endpoint>. Guarde eltask_iddevuelto, consulteGET /v1/tasks/{task_id}hasta questatusseasucceededy leadata.results.items.
Los nuevos endpoints de TikTok Shop
1 crédito de SocQ = $0.005.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| TikTok Shop Hot Products API | Productos más vendidos de un mercado, en el orden de TikTok Shop, con precio, unidades vendidas, valoración y tienda | 0.5 créditos ($0.0025) por producto |
| TikTok Shop Categories API | El árbol completo de categorías de un mercado, una fila por categoría con ID, nivel y categoría padre | 0.5 créditos ($0.0025) por llamada |
| TikTok Shop Category Products API | Productos de una categoría con precio, unidades vendidas, valoración, reseñas y tienda | 0.5 créditos ($0.0025) por producto |
| TikTok Shop Search Suggestions API | Hasta 20 sugerencias para completar el inicio de una búsqueda, ordenadas | 0.5 créditos ($0.0025) por llamada |
Mercados compatibles
| Endpoint | Valores de region | Por defecto |
|---|---|---|
| Hot Products | ID, JP, MX, MY, PH, SG, TH, VN | ninguno, obligatorio |
| Categories, Category Products, Search Suggestions | US, SG, MY, PH, TH, VN, ID, JP, MX | US |
Hot Products no incluye US. Para investigar productos en Estados Unidos, use Categories y Category Products.
Autenticación y flujo de tareas asíncronas
Todas las solicitudes se autentican con una clave de API. Se usa el mismo encabezado para el envío, el estado de la tarea y la lectura de resultados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada recopilación se ejecuta como una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La llamada de envío responde de inmediato con data.task_id y data.status. Consulte la tarea con ese ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Cuando status es succeeded, la respuesta incluye result_count, credits_amount y la primera página de registros normalizados en data.results.items. limit es 50 por defecto y admite hasta 500. Si results.has_more es true, pase results.next_cursor como cursor para leer la página siguiente. Una tarea fallida incluye error_message.
Cada endpoint acepta además un callback_url opcional. SocQ envía un único POST con un resumen de la tarea cuando esta termina; lea los registros desde el endpoint de tareas. Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo ID de tarea en lugar de volver a enviarla. Un 402 significa que la cuenta se quedó sin créditos, y un 429 que la clave alcanzó un límite de frecuencia o de créditos.
Hot Products: qué se vende en un mercado
La Hot Products API devuelve los productos más vendidos de un mercado en el orden en que TikTok Shop los clasifica. Cada producto incluye su título, price (importe, moneda y texto con formato), sold_count, rating, reviews_count, seller e imágenes, además de la url de la página del producto. region es obligatorio. results_limit es 50 por defecto y acepta de 1 a 200. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "MY", "results_limit": 50}'
Cuándo usarla: una instantánea semanal por mercado para detectar productos en auge, comparar precios o elegir productos que abastecer y promocionar. Los precios llegan en la moneda local, como MYR para Malasia, así que conviértalos antes de comparar mercados.
Categories: el árbol completo de categorías
La Categories API devuelve todas las categorías de un mercado en una sola llamada. Cada fila tiene el id de la categoría, name, el slug en inglés, level, parent_id, is_leaf, path (los nombres de las categorías superiores), cover_url y region. Las categorías de primer nivel tienen parent_id: null y level: 1, así que puede reconstruir la jerarquía como un árbol o mantenerla como una tabla de consulta plana. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "US"}'
Cuándo usarla: una vez por mercado, guardando después el resultado en caché. Necesita los IDs para Category Products, y el árbol sirve para mapear las categorías de TikTok Shop a su propio catálogo.
Category Products: explorar una categoría como un comprador
La Category Products API recibe un category_id numérico de la Categories API y devuelve los productos de esa categoría con título, precio, unidades vendidas, valoración, reseñas, tienda e imágenes. region es US por defecto. results_limit es 30 por defecto y acepta de 1 a 500. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "601450", "region": "US", "results_limit": 30}'
Cuándo usarla: para comparar franjas de precio entre subcategorías o seguir cómo cambian con el tiempo los más vendidos de una categoría.
Search Suggestions: lo que escriben los compradores
La Search Suggestions API recibe el inicio de una búsqueda de compra en query y devuelve hasta 20 sugerencias, ordenadas desde el 1, en el orden en que TikTok Shop las propone. Cada fila tiene la keyword, la query que envió, su rank y la region. region es US por defecto. (documentación)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "phone case", "region": "US"}'
Cuándo usarla: investigación de palabras clave para fichas de producto, anuncios y contenido. Para phone case, la primera sugerencia del ejemplo de la documentación es phone cases 17 pro max, lo que muestra para qué modelos de teléfono compran los usuarios. Pase las sugerencias a TikTok Shop Search para ver qué productos se posicionan en cada una.
Recorrer una categoría en tres llamadas
Una investigación típica para un mercado:
- Llame a Categories una vez para el mercado y guarde el árbol (0.5 créditos).
- Elija las categorías finales que le interesen (
is_leaf: true) y llame a Category Products para cada una. - Llame a Search Suggestions con las palabras de producto principales de cada categoría para ver cómo formulan sus búsquedas los compradores.
Diez categorías con 30 productos cada una son 300 productos, es decir, 150 créditos. Si añade el árbol (0.5) y diez llamadas de sugerencias (5), la investigación cuesta 155.5 créditos, unos $0.78. En un mercado compatible con Hot Products, una instantánea de 50 productos añade 25 créditos ($0.125).
Lea los campos con atención
Las filas de producto usan la misma estructura normalizada en los tres endpoints de productos. Como en otros campos de SocQ, un valor que la fuente no proporciona es null, no 0. En los ejemplos de la documentación, rating, reviews_count y sold_count son null para los productos mostrados, así que trate las ventas o valoraciones ausentes como desconocidas, no como cero, antes de ordenar productos por ellas.
Para profundizar en un producto concreto, pase su url a la TikTok Shop Product API, que por ahora solo atiende la región de Estados Unidos, y a la Product Reviews API. Para otras formas de obtener datos de TikTok Shop, consulte alternativas a la API de TikTok Shop. Los productos vendidos durante transmisiones LIVE están cubiertos por la TikTok Live Shopping API en la guía de los nuevos endpoints de TikTok.
Preguntas frecuentes
¿Hace falta una cuenta de vendedor o de partner de TikTok Shop?
No. Los endpoints leen datos públicos de TikTok Shop y usted se autentica con una clave de API de SocQ.
¿Por qué Hot Products rechaza US?
US no es uno de sus valores de region. Hot Products cubre ID, JP, MX, MY, PH, SG, TH y VN. Los otros tres endpoints admiten US y lo usan por defecto.
¿De dónde salen los IDs de categoría?
De la Categories API. El id de cada fila es el category_id que acepta Category Products, para la misma region.
¿Cómo se factura cada endpoint?
Categories y Search Suggestions cuestan 0.5 créditos por llamada, independientemente de cuántas filas devuelvan. Hot Products y Category Products cuestan 0.5 créditos por producto devuelto.
¿Cuántas sugerencias devuelve una búsqueda?
Hasta 20, ordenadas desde el 1 en el orden de TikTok Shop.
TIKTOK SHOP API
Probar el flujo de trabajo con una URL pública de TikTok Shop
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de TikTok Shop