ES

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

Desarrollador
Precios
Desde 0,005 US$ / 30 registros
Última actualización
2026-09-18

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 productoID de productoPrecioNombre de la tiendaRecuento de ventasPosición de búsqueda
Micro Ingredients Whole Milk Powder, 4lbs, Made in USA172943535848682769341.54Micro Ingredients232840
Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons172940885864766336118.26Weee Asian Supermarket67141

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.

  1. 1Si no se devuelven registros coincidentes, pruebe una frase más corta o más amplia y vuelva a enviar.
  2. 2Conserve los registros completados tras un éxito parcial; vuelva a enviar la misma entrada tras una tarea fallida o caducada.
  3. 3Reintente más tarde tras un límite de velocidad, una indisponibilidad temporal o un tiempo de espera.
  4. 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úsquedakeywordObligatoriostring
    Marca, producto o categoría que buscar en TikTok Shop. Cada tarea acepta una palabra clave de 1 a 512 caracteres.
    Ejemplomilk
  • Recuento esperado de resultadoscrawl_countObligatoriointeger
    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.
    Rango1–300Ejemplo30

Salida

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

  • ID de negociobiz_idstring
    Identificador de agrupación de negocio devuelto con la ficha recopilada; vacío si no hay valor.
    Ejemplomilk
  • Nombre de marcabrand_namestring
    Nombre de marca mostrado en la ficha del producto; vacío si no hay valor.
    EjemploMicro Ingredients
  • Marca temporal de recopilacióncollect_timestring
    Hora de recopilación como cadena de marca temporal en milisegundos; vacía si no hay valor.
    Ejemplo1789121807761
  • Hora de recopilacióncrawl_timestring
    Hora 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.

output.example
{
  "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 config
{
  "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

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 registros; cualquier unidad parcial se redondea a 30 registros.

0,005 US$/ 30 registros
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
Desde 0,005 US$ / 30 registros