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

Recopilación de datos E-commerce & Retail TikTok Products

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 autor. 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.

Campo	Nombre de negocio	Tipo	Obligatorio	Predeterminado	Enum / Restricciones	Ejemplo	Descripción
keyword	Palabra clave de búsqueda	string	Sí	—	—	milk	Marca, producto o categoría que buscar en TikTok Shop. Cada tarea acepta una palabra clave de 1 a 512 caracteres.
crawl_count	Recuento esperado de resultados	integer	Sí	—	1–300	30	Nú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.

Salida

Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.

Campo	Nombre de negocio	Tipo	Ejemplo	Descripción
biz_id	ID de negocio	string	milk	Identificador de agrupación de negocio devuelto con la ficha recopilada; vacío si no hay valor.
brand_name	Nombre de marca	string	Micro Ingredients	Nombre de marca mostrado en la ficha del producto; vacío si no hay valor.
collect_time	Marca temporal de recopilación	string	1789121807761	Hora de recopilación como cadena de marca temporal en milisegundos; vacía si no hay valor.
crawl_time	Hora de recopilación	string	2026-09-11T18:16:47	Hora de recopilación de la ficha; la fuente no indica zona horaria.
created_at	Marca temporal de creación	string	1789121807761	Hora de creación del registro como cadena de marca temporal en milisegundos; vacía si no hay valor.
image_url	Imagen del producto	string	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	URL de la imagen principal del producto en la ficha; vacía si no hay valor.
keyword	Palabra clave coincidente	string	milk	Palabra clave de búsqueda asociada a esta ficha de producto.
page_num	Página de resultados	string	1	Número de página de resultados de búsqueda como cadena; vacío si no hay valor.
platform_code	Código de plataforma	string	tiktokShop	Código de la plataforma de origen devuelto con la ficha.
price	Precio	string	41.54	Precio de la ficha como cadena original, sin un campo de moneda separado; vacío si no hay valor.
product_id	ID de producto	string	1729435358486827693	Identificador único y estable del producto de TikTok Shop.
product_title	Título del producto	string	Micro Ingredients Whole Milk Powder, 4lbs, Made in USA	Título del producto mostrado en la ficha de TikTok Shop.
rank_index	Posición de búsqueda	integer	0	Posición del producto en la lista de búsqueda, desde 0; vacía si no hay valor.
rating_count	Recuento de valoraciones	string	3185	Número de valoraciones como cadena numérica; vacío si no hay valor.
sale_count	Recuento de ventas	string	23284	Recuento público de ventas como cadena numérica; vacío si no hay valor.
shop_id	ID de tienda	string	7494949083499694765	Identificador único de la tienda de TikTok Shop; vacío si no hay valor.
shop_name	Nombre de la tienda	string	Micro Ingredients	Nombre de la tienda asociada a la ficha del producto.
status_code	Código de estado	string	—	Código de estado del producto en bruto; vacío si no hay valor.
source_item	Elemento de origen	string	milk	Elemento de palabra clave de la recopilación que produjo este registro.
no_data	Marcador sin datos	boolean	false	Indica si este elemento de búsqueda no produjo productos coincidentes.

Schema del registro

La salida se devuelve registro a registro. detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "ID de negocio",
      "description": "Identificador de agrupación de negocio devuelto con la ficha recopilada; vacío si no hay valor.",
      "prefill": "milk"
    },
    "brand_name": {
      "type": "string",
      "title": "Nombre de marca",
      "description": "Nombre de marca mostrado en la ficha del producto; vacío si no hay valor.",
      "prefill": "Micro Ingredients"
    },
    "collect_time": {
      "type": "string",
      "title": "Marca temporal de recopilación",
      "description": "Hora de recopilación como cadena de marca temporal en milisegundos; vacía si no hay valor.",
      "prefill": "1789121807761"
    },
    "crawl_time": {
      "type": "string",
      "title": "Hora de recopilación",
      "description": "Hora de recopilación de la ficha; la fuente no indica zona horaria.",
      "prefill": "2026-09-11T18:16:47"
    },
    "created_at": {
      "type": "string",
      "title": "Marca temporal de creación",
      "description": "Hora de creación del registro como cadena de marca temporal en milisegundos; vacía si no hay valor.",
      "prefill": "1789121807761"
    },
    "image_url": {
      "type": "string",
      "title": "Imagen del producto",
      "description": "URL de la imagen principal del producto en la ficha; vacía si no hay valor.",
      "prefill": "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": {
      "type": "string",
      "title": "Palabra clave coincidente",
      "description": "Palabra clave de búsqueda asociada a esta ficha de producto.",
      "prefill": "milk"
    },
    "page_num": {
      "type": "string",
      "title": "Página de resultados",
      "description": "Número de página de resultados de búsqueda como cadena; vacío si no hay valor.",
      "prefill": "1"
    },
    "platform_code": {
      "type": "string",
      "title": "Código de plataforma",
      "description": "Código de la plataforma de origen devuelto con la ficha.",
      "prefill": "tiktokShop"
    },
    "price": {
      "type": "string",
      "title": "Precio",
      "description": "Precio de la ficha como cadena original, sin un campo de moneda separado; vacío si no hay valor.",
      "prefill": "41.54"
    },
    "product_id": {
      "type": "string",
      "title": "ID de producto",
      "description": "Identificador único y estable del producto de TikTok Shop.",
      "prefill": "1729435358486827693"
    },
    "product_title": {
      "type": "string",
      "title": "Título del producto",
      "description": "Título del producto mostrado en la ficha de TikTok Shop.",
      "prefill": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA"
    },
    "rank_index": {
      "type": "integer",
      "title": "Posición de búsqueda",
      "description": "Posición del producto en la lista de búsqueda, desde 0; vacía si no hay valor.",
      "prefill": 0
    },
    "rating_count": {
      "type": "string",
      "title": "Recuento de valoraciones",
      "description": "Número de valoraciones como cadena numérica; vacío si no hay valor.",
      "prefill": "3185"
    },
    "sale_count": {
      "type": "string",
      "title": "Recuento de ventas",
      "description": "Recuento público de ventas como cadena numérica; vacío si no hay valor.",
      "prefill": "23284"
    },
    "shop_id": {
      "type": "string",
      "title": "ID de tienda",
      "description": "Identificador único de la tienda de TikTok Shop; vacío si no hay valor.",
      "prefill": "7494949083499694765"
    },
    "shop_name": {
      "type": "string",
      "title": "Nombre de la tienda",
      "description": "Nombre de la tienda asociada a la ficha del producto.",
      "prefill": "Micro Ingredients"
    },
    "status_code": {
      "type": "string",
      "title": "Código de estado",
      "description": "Código de estado del producto en bruto; vacío si no hay valor."
    },
    "source_item": {
      "type": "string",
      "title": "Elemento de origen",
      "description": "Elemento de palabra clave de la recopilación que produjo este registro.",
      "prefill": "milk"
    },
    "no_data": {
      "type": "boolean",
      "title": "Marcador sin datos",
      "description": "Indica si este elemento de búsqueda no produjo productos coincidentes.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": 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.

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 config

{
  "mcpServers": {
    "super_ig__tiktok-shop-keyword-list": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Ver mis API Keys →

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. (El prompt le pide a la IA que te solicite tu API Key, de modo que las credenciales nunca queden en el historial de chat ni en configuraciones compartidas.)

detail.access.mcp.composeHint

Precios

30 registros devueltos

Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 30 registro; cualquier unidad parcial se redondea a 30 registro.

0,005 US$/ 30 registro

Per task submitted

Se cobra una vez por cada ejecución enviada, independientemente del número de registros devueltos.

0,0001 US$/ ejecución

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éditos

Pruébalo ahora

Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.

Ejemplo

Los parámetros se validan contra input.schema antes del envío

Palabra clave de búsquedakeyword*Marca, producto o categoría que buscar en TikTok Shop. Cada tarea acepta una palabra clave de 1 a 512 caracteres.

Recuento esperado de resultadoscrawl_count*Nú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.

Rellena primero los parámetros obligatorios

Desde 0,005 US$ / 30 registro