Para estudiar conversaciones sobre un problema en TikTok, primero busca videos relevantes y luego solicita los comentarios de cada video seleccionado. Para un equipo de producto, el resultado puede ser un conjunto de respuestas JSON originales vinculadas a la consulta y a la URL del video. Antes de crear una cola de temas, comprueba la estructura real de los comentarios: la documentación confirma la ruta y sus parámetros, pero no describe los campos de los registros de la respuesta.
Este es un paso importante en un flujo de análisis. Los resultados de búsqueda ayudan a reunir contexto sobre el producto, y los comentarios pueden incluir informes de errores, preguntas o soluciones alternativas. Para que la clasificación se base en datos reales, guarda primero la respuesta de la API sin transformarla y después coteja los campos con el esquema que hayas recibido.
Por qué no basta con buscar videos
El nombre de una aplicación o un dispositivo ayuda a encontrar videos, pero la descripción muestra principalmente cómo lo presenta quien lo publicó. En los comentarios, los espectadores pueden hablar de fallos concretos y de maneras de usar el producto. Por eso, recopilar comentarios añade un segundo nivel de datos a la selección de búsqueda, vinculado al video original.
Materiales anteriores abordaron la supervisión de búsquedas en TikTok, la extracción de preguntas de las descripciones y el procesamiento de respuestas de búsqueda. Aquí el objetivo es más acotado: recopilar respuestas de la ruta de comentarios y comprobar su estructura antes de diseñar una clasificación. Esto puede ser útil para desarrolladores de integraciones analíticas, investigadores de experiencia de usuario y equipos de soporte.
De una frase de búsqueda a un conjunto de datos verificable
Define varias consultas concretas, por ejemplo, el nombre de un producto junto con el de una función o un modelo. Guarda la respuesta de búsqueda y las URL de los videos seleccionados. Después, solicita los comentarios usando las URL y guarda cada respuesta original por separado. Cuando hayas comprobado el esquema, podrás normalizar los campos necesarios, eliminar duplicados y agrupar los textos por temas.

- Búsqueda: solicita videos mediante una frase clave y comprueba las dos estructuras de resultados admitidas.
- Selección: elige videos relevantes y guarda sus identificadores y URL.
- Recopilación de comentarios: pasa la URL a la ruta de comentarios; para continuar la paginación, usa el cursor devuelto.
- Verificación: guarda el JSON sin procesar y determina los nombres reales de los campos a partir de la respuesta.
- Análisis: una vez verificado el esquema, agrupa los textos y pide a una persona que revise los ejemplos.
Qué rutas usar
La documentación de TikTok Scraper API describe GET /searchVideo, que requiere el parámetro keyword. Entre los parámetros opcionales están count, cursor, date_posted, sort_by y region. Para los comentarios, está disponible GET /getCommentsByUrl, que requiere video_url; entre sus parámetros opcionales se indican cursor, count y region. La clave se pasa mediante el parámetro license_key.
En la respuesta de búsqueda, los videos pueden aparecer en tiktok.aweme_list o en tiktok.search_item_list[].aweme_info. El ejemplo procesa ambas formas, comprueba el estado externo y guarda los objetos encontrados. Para la respuesta de comentarios, no presupone el nombre de un array ni el de sus campos: guarda y muestra el JSON recibido para poder inspeccionarlo.
Un recopilador mínimo en Python
El código es compatible con Python 3.8 o posterior. Instala requests y define la clave en la variable de entorno JSONSCRAPER_TIKTOK_LICENSE_KEY. El script escribe las respuestas de búsqueda y comentarios en archivos JSON separados y vincula cada respuesta de comentarios con la consulta y la URL del video. No extrae campos de los comentarios hasta que hayas verificado la estructura real de la respuesta.

import json
import os
from pathlib import Path
import requests
BASE = "https://tiktok.evelode.com"
KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
OUT = Path("tiktok_raw")
OUT.mkdir(exist_ok=True)
def get_json(path, params):
response = requests.get(
BASE + path,
params={**params, "license_key": KEY},
timeout=30,
)
response.raise_for_status()
data = response.json()
if data.get("status") != "ok":
raise RuntimeError("API returned non-ok status")
return data
def videos_from_search(data):
tiktok = data.get("tiktok") or {}
found = list(tiktok.get("aweme_list") or [])
for item in tiktok.get("search_item_list") or []:
aweme = (item or {}).get("aweme_info") or {}
if aweme:
found.append(aweme)
unique = {}
for video in found:
video_id = video.get("aweme_id")
video_url = video.get("share_url")
if video_id and video_url:
unique[video_id] = video
return list(unique.values())
for index, keyword in enumerate(("APP_NAME ошибка", "APP_NAME не работает")):
search = get_json("/searchVideo", {"keyword": keyword, "count": 10})
(OUT / f"search_{index}.json").write_text(
json.dumps(search, ensure_ascii=False, indent=2), encoding="utf-8"
)
for video in videos_from_search(search):
video_id = video["aweme_id"]
video_url = video["share_url"]
comments = get_json(
"/getCommentsByUrl",
{"video_url": video_url, "count": 30},
)
filename = f"comments_{video_id}.json"
record = {
"keyword": keyword,
"video_id": video_id,
"video_url": video_url,
"response": comments,
}
(OUT / filename).write_text(
json.dumps(record, ensure_ascii=False, indent=2), encoding="utf-8"
)
print(json.dumps(record, ensure_ascii=False, indent=2))
El script comprueba el estado externo de la respuesta y después escribe el objeto JSON completo. Así puedes inspeccionar las claves reales, los tipos de valores y la estructura anidada antes de crear una tabla de comentarios. Si la API devuelve un error, el código se detiene y lo señala en lugar de guardar silenciosamente un resultado incorrecto.
Cómo pasar del JSON sin procesar a una cola de temas
Después de comprobar una o varias respuestas, crea un normalizador basado en el esquema que hayas encontrado. Guarda el JSON original junto a las filas normalizadas para poder verificar la transformación y volver a procesar los datos si cambia el código. Conviene conservar en cada registro el enlace al video, el comentario original, la hora de recopilación y la versión de la regla de clasificación aplicada.
Para clasificar por temas, puedes empezar con etiquetas como «error», «pregunta sobre el uso», «solicitud de función», «comentario» y «no relacionado con el producto». Las reglas basadas en palabras clave o un clasificador pueden ayudar a ordenar la selección; almacena la etiqueta asignada por separado del texto original. Antes de crear una tarea, un especialista debe comprobar el contexto del comentario y el video original.
Para deduplicar, utiliza el campo del identificador solo después de confirmar que aparece en la respuesta. Si los datos no incluyen un identificador, una clave temporal puede combinar la URL del video con el texto normalizado; este método agrupa formulaciones coincidentes dentro de un mismo video, pero no permite determinar si los registros pertenecen al mismo autor.
Automatización y procedencia de los datos
Programa la recopilación con cron, GitHub Actions o n8n. Guarda la clave en los secretos del entorno de ejecución y no la incluyas en el repositorio, los archivos de resultados ni los registros. Conserva las respuestas JSON originales para poder verificarlas; define un plazo de retención y permisos de acceso conforme a los requisitos de tu equipo y a las normas aplicables de la plataforma.
Para supervisar el funcionamiento del flujo, registra el número de consultas de búsqueda correctas, videos únicos encontrados, respuestas de comentarios guardadas y errores de la API. Estas métricas técnicas muestran en qué etapa cambió el resultado. Una respuesta vacía, un error de solicitud y la ausencia de coincidencias después de la clasificación temática son estados distintos, así que guárdalos por separado.
Para la base de datos, conviene separar las entidades de recopilación, videos, respuestas originales de comentarios y decisiones de clasificación temática. Vincularlas con la consulta y el video permite abrir la fuente para una revisión manual. Una vez confirmado el esquema, puedes añadir paginación con cursor: la ruta acepta cursor, y la siguiente solicitud debe pasar el valor devuelto por la API sin intentar interpretarlo.
Qué aporta este enfoque
El equipo obtiene un proceso de recopilación repetible y un conjunto de fuentes verificable a partir del cual puede crear una cola de temas. Un analista puede rastrear qué consulta de búsqueda condujo a un video y qué respuesta de comentarios se guardó. Tras comprobar la estructura, el desarrollador puede añadir la normalización y la agrupación temática sin sustituir un esquema desconocido por suposiciones.
En el informe, indica las frases de búsqueda, la fecha de ejecución, los criterios de selección y el número de respuestas procesadas. Las conclusiones corresponden a consultas concretas y a los datos devueltos; ayudan a investigar las conversaciones encontradas y a planificar su revisión, preservando su procedencia y contexto.
Empieza con un producto y unas cuantas consultas de diagnóstico: guarda las respuestas, comprueba la estructura de los comentarios y añade después al normalizador solo los campos confirmados. Los parámetros de las rutas se describen en la documentación de la API, y la información del producto aparece en la página de TikTok Scraper API.