Entregue una lista de ID de producto o SPU de TikTok Shop y obtenga título, precio, vendedor, envío, SKU y estado de recolección
Búsqueda por palabra clave de TikTok Shop
Indique una palabra clave de TikTok Shop y un recuento esperado de productos para obtener fichas de EE. UU. coincidentes con tienda, precio y señales de ventas.
Traducido · es-ESVer texto original
Descripción general
Los compradores descubren de verdad los productos con la búsqueda por palabra clave de TikTok Shop, pero la ficha pública es difícil de conservar como un conjunto comparable: títulos, precios, tiendas y posición se mueven juntos, y las capturas no sobreviven al análisis. Esta aplicación convierte una palabra clave de búsqueda en una lista estructurada de productos coincidentes de TikTok Shop en Estados Unidos para que los equipos de merchandising, marca e investigación vean qué aparece ahora para ese término.
A diferencia de abrir una ficha de producto que ya conoce, la búsqueda por palabra clave muestra qué fichas ocupan el lineal para una marca, categoría o frase de campaña. Mantener la identidad del producto, las señales comerciales de la ficha y el contexto de la tienda en la misma fila permite comparar términos, vigilar la presencia de una marca o armar un conjunto de candidatos sin copiar resultados a mano.
Notas sobre los datos
Cada registro es una ficha de producto pública asociada a la palabra clave enviada en TikTok Shop de Estados Unidos. Los ID de producto se deduplican en el conjunto devuelto. Palabra clave coincidente, ID de negocio y Elemento de origen conservan el contexto de búsqueda y pueden repetirse en muchos productos de la misma tarea. Las fichas se devuelven en un orden estable ascendente según la hora de recopilación.
El precio es el importe de la ficha como cadena original, sin un campo de moneda separado. Marca temporal de recopilación y Marca temporal de creación son cadenas en milisegundos; Hora de recopilación no tiene zona horaria, así que no debe tratarse como un reloj absoluto entre regiones. La posición de búsqueda empieza en 0. El Marcador sin datos distingue un elemento de búsqueda sin productos coincidentes de las filas de ficha habituales.
La recopilación cubre solo fichas de búsqueda públicas de Estados Unidos. No incluye catálogos de otros países, especificaciones de ficha de detalle, comentarios ni datos de pedidos.
Ejemplo de resultado
Cada fila es una ficha de producto de TikTok Shop asociada a la palabra clave de búsqueda, o un marcador sin datos para esa búsqueda.
| Título del producto | ID de producto | Precio | Nombre de la tienda | Recuento de ventas | Posición de búsqueda |
|---|---|---|---|---|---|
| Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | 1729435358486827693 | 41.54 | Micro Ingredients | 23284 | 0 |
| Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons | 1729408858647663361 | 18.26 | Weee Asian Supermarket | 6714 | 1 |
Nombre de marca, Imagen del producto, Recuento de valoraciones, ID de tienda, Hora de recopilación y Marcador sin datos también están disponibles cuando se suministran con el registro.
Casos de uso
- Para merchandising por palabra clave, agrupe filas por Palabra clave coincidente y compare Título del producto, Precio y Nombre de la tienda para ver qué fichas ocupan el lineal de búsqueda.
- Para seguimiento competitivo, ordene por Posición de búsqueda y use Recuento de ventas con Recuento de valoraciones para separar fichas muy visibles de productos de cola larga.
- Para monitorización de marca, compare Nombre de marca con Nombre de la tienda e ID de producto para ver si los productos de marca los vende la tienda de la marca u otros comerciantes.
- Para seguimiento de sourcing, conserve juntos ID de producto, ID de tienda e Imagen del producto para reabrir la misma ficha más tarde sin repetir la búsqueda a mano.
Alcance y límites
Una palabra clave de búsqueda de TikTok Shop por tarea, con un recuento esperado de 1 a 300; los resultados se devuelven en lotes completos de 30 y pueden redondearse al alza; la cobertura se limita a fichas públicas de búsqueda de TikTok Shop en EE. UU.
- Adecuada para
- Cuando necesite productos de TikTok Shop de EE. UU. que aparecen para una palabra clave de marca, producto o categoría.
- Cuando necesite una lista estructurada que relacione cada ficha coincidente con su tienda, precio, posición y señales públicas de ventas o valoraciones.
- No usar para
- Cuando necesite especificaciones completas, comentarios o datos de pedidos de una ficha de detalle.
- Cuando necesite una consulta inmediata de un solo registro en lugar de una recopilación por palabra clave en segundo plano.
- Cuando necesite fichas de TikTok Shop de regiones distintas de Estados Unidos.
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1Si no se devuelven registros coincidentes, pruebe una frase más corta o más amplia y vuelva a enviar.
- 2Conserve los registros completados tras un éxito parcial; vuelva a enviar la misma entrada tras una tarea fallida o caducada.
- 3Reintente más tarde tras un límite de velocidad, una indisponibilidad temporal o un tiempo de espera.
- 4Si falla la autenticación, verifique la clave API configurada en el entorno de ejecución.
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- Palabra clave de búsqueda
keywordObligatoriostringMarca, producto o categoría que buscar en TikTok Shop. Cada tarea acepta una palabra clave de 1 a 512 caracteres.Ejemplomilk - Recuento esperado de resultados
crawl_countObligatoriointegerNúmero esperado de fichas de producto, de 1 a 300. Los resultados se devuelven en lotes completos de 30, así que el recuento real puede redondearse al alza. Los lotes incompletos se facturan igualmente como 30 registros.Rango1–300Ejemplo30
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- ID de negocio
biz_idstringIdentificador de agrupación de negocio devuelto con la ficha recopilada; vacío si no hay valor.Ejemplomilk - Nombre de marca
brand_namestringNombre de marca mostrado en la ficha del producto; vacío si no hay valor.EjemploMicro Ingredients - Marca temporal de recopilación
collect_timestringHora de recopilación como cadena de marca temporal en milisegundos; vacía si no hay valor.Ejemplo1789121807761 - Hora de recopilación
crawl_timestringHora de recopilación de la ficha; la fuente no indica zona horaria.Ejemplo2026-09-11T18:16:47
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"biz_id": "milk",
"brand_name": "Micro Ingredients",
"collect_time": "1789121807761",
"crawl_time": "2026-09-11T18:16:47",
"created_at": "1789121807761",
"image_url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839",
"keyword": "milk",
"page_num": "1",
"platform_code": "tiktokShop",
"price": "41.54",
"product_id": "1729435358486827693",
"product_title": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA",
"rank_index": 0,
"rating_count": "3185",
"sale_count": "23284",
"shop_id": "7494949083499694765",
"shop_name": "Micro Ingredients",
"status_code": "<status_code>",
"source_item": "milk",
"no_data": false
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino. Esta App se ejecuta de forma asíncrona y se puede cancelar a mitad de camino: Tras la cancelación, la ejecución se detiene. Los registros ya entregados se conservan y se facturan.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (De forma predeterminada te guía para iniciar sesión y nunca te pide que envíes tu API Key en el chat.)
detail.access.mcp.composeHint
Precios
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 30 registros; cualquier unidad parcial se redondea a 30 registros.
Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.