Búsqueda de TikTok por palabra clave
Indica una palabra clave de búsqueda de TikTok y un recuento esperado para obtener identificadores, enlaces y metadatos de recopilación de vídeos públicos coincidentes.
Traducido · es-ESVer texto original
Descripción general
Investigar cómo aparece un tema en la búsqueda de TikTok suele empezar por reunir un conjunto fiable de identificadores de vídeo y enlaces públicos coincidentes. Esta app convierte una palabra clave de búsqueda en una colección estructurada de elementos coincidentes y conserva la palabra clave y el contexto de recopilación junto a cada identificador para que el conjunto de datos siga siendo comprensible tras exportarlo o cruzarlo con otro material.
El resultado sirve como índice de descubrimiento: muestra qué vídeos públicos se asociaron a una marca, producto, tema o campaña en el momento de la recopilación. Encaja especialmente para construir conjuntos de monitorización repetibles, comparar las poblaciones de contenido halladas para distintos términos y preparar identificadores y enlaces para un análisis posterior sin copiar elementos a mano desde las páginas de búsqueda.
Notas sobre los datos
Cada registro representa un elemento de TikTok asociado a la palabra clave enviada. Los ID de contenido se deduplican dentro del conjunto devuelto. Palabra clave coincidente, elemento de origen e ID de negocio conservan el contexto de recopilación y pueden repetirse en muchos registros de la misma búsqueda. La hora de recopilación se devuelve sin zona horaria, así que no debe tratarse como una marca de tiempo absoluta entre regiones sin contexto adicional. El tipo de palabra clave describe la clase de elemento de búsqueda asociado al registro.
La colección contiene identificadores, enlaces públicos de vídeo y metadatos de recopilación, no subtítulos, transcripciones, totales de interacción, comentarios ni un perfil completo del creador. El indicador sin datos distingue los metadatos de búsqueda que no encuentran contenido de los registros coincidentes ordinarios. El contenido de TikTok privado, eliminado o no buscable no está cubierto.
Ejemplo de resultado
Cada fila es un vídeo de TikTok coincidente o un indicador sin datos asociado a la palabra clave de búsqueda.
| ID de contenido | Palabra clave coincidente | URL de contenido | Hora de recopilación | Indicador sin datos |
|---|---|---|---|---|
| 7678592532162284813 | bluetooth earbuds | https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 | 2026-08-27T15:13:22 | No |
| 7678160781283822879 | bluetooth earbuds | https://www.tiktok.com/@stitch.series6/video/7678160781283822879 | 2026-08-27T15:13:22 | No |
El tipo de palabra clave, el ID de registro de recopilación, el ID de negocio y el elemento de origen también están disponibles cuando se suministran con el registro.
Casos de uso
- Para el descubrimiento de temas, agrupa filas por Palabra clave coincidente y cuenta valores distintos de ID de contenido para comparar la población de vídeos buscables asociada a cada término.
- Para la monitorización, repite una recopilación por palabra clave, compara conjuntos de ID de contenido y usa la Hora de recopilación como contexto de origen para elementos recién observados.
- Para comprobar la procedencia, compara Palabra clave coincidente, Elemento de origen e ID de negocio antes de combinar conjuntos de datos.
- Para la revisión posterior, abre los valores de URL de contenido y filtra por Indicador sin datos para separar metadatos de búsqueda vacía de registros coincidentes utilizables.
Alcance y límites
Una palabra clave de búsqueda de TikTok por tarea, con un recuento esperado de 1 a 200; los resultados se devuelven en lotes completos de 10 y pueden redondearse al alza; la cobertura se limita a listados públicos de búsqueda por palabra clave de TikTok.
- Adecuada para
- Cuando necesitas identificadores de contenido y enlaces públicos de vídeo de una búsqueda de TikTok por palabra clave para una marca, producto, tema o campaña.
- Cuando necesitas una lista estructurada que conecte cada vídeo coincidente con su palabra clave de búsqueda y metadatos de recopilación.
- No usar para
- Cuando necesitas subtítulos, transcripciones, métricas de interacción, comentarios o perfiles completos de creadores.
- Cuando necesitas una consulta inmediata de un solo registro en lugar de una recopilación de palabra clave en segundo plano.
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, verifica la palabra clave o prueba una frase más corta y amplia.
- 2Conserva los registros completados tras un éxito parcial; vuelve a enviar la misma entrada tras una tarea fallida o caducada.
- 3Reintenta más tarde tras limitación de ritmo, indisponibilidad temporal o agotamiento del tiempo de espera.
- 4Si falla la autenticación, comprueba la clave de API configurada para 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í | — | — | Shokz | Marca, producto, tema o frase para buscar en TikTok. Cada tarea acepta una palabra clave de 1 a 512 caracteres. |
| crawl_count | Número esperado de resultados | integer | Sí | — | 1–200 | 1 | Número esperado de resultados de búsqueda, de 1 a 200. Los resultados se devuelven en lotes completos de 10, así que el recuento real puede redondearse al alza. |
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 |
|---|---|---|---|---|
| content_id | ID de contenido | string | 7678592532162284813 | Identificador único del vídeo de TikTok coincidente. |
| content_url | URL de contenido | string | https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 | URL pública del vídeo de TikTok del elemento coincidente. |
| keyword | Palabra clave coincidente | string | bluetooth earbuds | Palabra clave de búsqueda asociada al elemento de contenido recopilado. |
| keyword_type | Tipo de palabra clave | string | keyword | Clasificación del elemento de búsqueda asociado al registro. |
| crawl_time | Hora de recopilación | string | 2026-08-27T15:13:22 | Marca de tiempo asociada al registro recopilado; la fuente no especifica zona horaria. |
| cur_id | ID de registro de recopilación | string | 6a8fe396b799f44efa7f2ff0 | Identificador único de esta fila recopilada; puede diferir del ID de contenido del vídeo de TikTok. |
| biz_id | ID de negocio | string | bluetooth earbuds | Identificador de agrupación de negocio devuelto con el registro recopilado. |
| source_item | Elemento de origen | string | bluetooth earbuds | Elemento de palabra clave asociado a la recopilación que produjo este registro. |
| no_data | Indicador sin datos | boolean | false | Indica si este elemento de búsqueda no produjo registros coincidentes. |
Schema del registro
La salida se devuelve registro a registro. detail.output.idFieldHint
{
"type": "object",
"properties": {
"content_id": {
"type": "string",
"title": "ID de contenido",
"description": "Identificador único del vídeo de TikTok coincidente.",
"prefill": "7678592532162284813"
},
"content_url": {
"type": "string",
"title": "URL de contenido",
"description": "URL pública del vídeo de TikTok del elemento coincidente.",
"prefill": "https://www.tiktok.com/@rebeccashao0/video/7678592532162284813"
},
"keyword": {
"type": "string",
"title": "Palabra clave coincidente",
"description": "Palabra clave de búsqueda asociada al elemento de contenido recopilado.",
"prefill": "bluetooth earbuds"
},
"keyword_type": {
"type": "string",
"title": "Tipo de palabra clave",
"description": "Clasificación del elemento de búsqueda asociado al registro.",
"prefill": "keyword"
},
"crawl_time": {
"type": "string",
"title": "Hora de recopilación",
"description": "Marca de tiempo asociada al registro recopilado; la fuente no especifica zona horaria.",
"prefill": "2026-08-27T15:13:22"
},
"cur_id": {
"type": "string",
"title": "ID de registro de recopilación",
"description": "Identificador único de esta fila recopilada; puede diferir del ID de contenido del vídeo de TikTok.",
"prefill": "6a8fe396b799f44efa7f2ff0"
},
"biz_id": {
"type": "string",
"title": "ID de negocio",
"description": "Identificador de agrupación de negocio devuelto con el registro recopilado.",
"prefill": "bluetooth earbuds"
},
"source_item": {
"type": "string",
"title": "Elemento de origen",
"description": "Elemento de palabra clave asociado a la recopilación que produjo este registro.",
"prefill": "bluetooth earbuds"
},
"no_data": {
"type": "boolean",
"title": "Indicador sin datos",
"description": "Indica si este elemento de búsqueda no produjo registros 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": {
"hello_moto__tiktok-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-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. (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
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 10 registro; cualquier unidad parcial se redondea a 10 registro.
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.