Cómo encontrar vídeos de TikTok con preguntas sobre tu producto y recopilarlos en un informe

Si los clientes hablan de tu producto en TikTok, buscar el nombre de la marca puede proporcionar al equipo material para elaborar una lista de preguntas frecuentes. El resultado práctico es un CSV con la descripción del vídeo, el autor, el enlace y las métricas de interacción disponibles. Puedes compartir el archivo con el equipo de soporte o utilizarlo como entrada para una clasificación temática.

Para el ejemplo, usaremos la consulta «cómo usar la cafetera Acme». El siguiente script realiza una consulta a la búsqueda de TikTok, extrae con cuidado los vídeos de dos variantes documentadas de la estructura de respuesta y guarda los resultados encontrados. Después, el equipo revisa manualmente las descripciones, agrupa las formulaciones similares y las convierte en temas de preguntas frecuentes o en indicaciones para la ficha del producto.

Por qué conviene convertir la búsqueda en una tabla

Revisar manualmente los resultados de búsqueda dificulta repetir la comprobación: hay que volver a encontrar los resultados y las notas suelen quedarse en el navegador o en una conversación. Una tabla guardada ofrece una lista de trabajo unificada: cada registro incluye el ID del vídeo, el enlace, la descripción, el autor y las métricas disponibles. Puedes programar ejecuciones periódicas y consultar el archivo JSON para comprobar exactamente qué devolvió la API en una ejecución concreta.

Es importante tener presente el alcance del método: la búsqueda devuelve resultados encontrados para una consulta, no un catálogo completo garantizado de todas las menciones. Por eso, la tabla sirve para descubrir ejemplos y observar preguntas recurrentes; para sacar conclusiones sobre su frecuencia, es mejor apoyarse en ejecuciones repetidas y una revisión manual.

Qué devuelve la búsqueda

En la documentación de TikTok Scraper API, la ruta /searchVideo requiere el parámetro keyword. Entre los parámetros admitidos también figuran count, cursor, date_posted, sort_by y region. Para este caso basta con la consulta clave y el número de resultados.

La respuesta contiene un estado externo y un objeto tiktok. En el esquema revisado, los vídeos pueden estar en aweme_list o en los elementos de search_item_list, dentro del campo aweme_info. El código contempla ambas estructuras y extrae solo los campos que realmente están presentes. Según el resultado, pueden estar disponibles el ID del vídeo, la descripción, el enlace, el nombre y el ID del autor, la fecha de publicación y las métricas de visualizaciones, «Me gusta», comentarios y compartidos.

Un recolector básico en Python

Instala la biblioteca de solicitudes y define la clave en la variable de entorno JSONSCRAPER_TIKTOK_LICENSE_KEY. El código es compatible con Python 3.8 o posterior. Guarda la respuesta original en JSON y los registros normalizados en CSV. La clave se envía en la solicitud, pero no se muestra en pantalla.

import csv
import json
import os
from datetime import datetime, timezone
from pathlib import Path

import requests

API_KEY = os.environ["JSONSCRAPER_TIKTOK_LICENSE_KEY"]
KEYWORD = "Acme кофемашина"

response = requests.get(
    "https://tiktok.evelode.com/searchVideo",
    params={
        "license_key": API_KEY,
        "keyword": KEYWORD,
        "count": 30,
        "region": "US",
    },
    timeout=60,
)
response.raise_for_status()
payload = response.json()

if payload.get("status") != "ok":
    raise RuntimeError("TikTok API devolvió un estado externo inesperado")

tiktok = payload.get("tiktok") or {}
items = list(tiktok.get("aweme_list") or [])
for result in tiktok.get("search_item_list") or []:
    video = result.get("aweme_info")
    if video:
        items.append(video)

# Elimina duplicados y conserva el orden de la primera aparición.
unique = {}
for item in items:
    video_id = item.get("aweme_id")
    if video_id:
        unique.setdefault(video_id, item)

stamp = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%SZ")
Path("data").mkdir(exist_ok=True)
Path(f"data/raw-{stamp}.json").write_text(
    json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8"
)

columns = [
    "video_id", "description", "share_url", "author", "author_id",
    "created_at", "views", "likes", "comments", "collected_at"
]
with open("data/videos.csv", "w", newline="", encoding="utf-8") as file:
    writer = csv.DictWriter(file, fieldnames=columns)
    writer.writeheader()
    for item in unique.values():
        author = item.get("author") or {}
        stats = item.get("statistics") or {}
        created = item.get("create_time")
        writer.writerow({
            "video_id": item.get("aweme_id"),
            "description": item.get("desc"),
            "share_url": item.get("share_url"),
            "author": author.get("nickname"),
            "author_id": author.get("uid"),
            "created_at": created,
            "views": stats.get("play_count"),
            "likes": stats.get("digg_count"),
            "comments": stats.get("comment_count"),
            "collected_at": stamp,
        })

print(f"Filas guardadas: {len(unique)}")

Puedes instalar la dependencia con el comando python -m pip install requests. Si un campo no está presente en un registro concreto, el código deja vacía la celda correspondiente. Esto es importante para las métricas: un valor vacío indica que el campo no se recibió y no se sustituye por un cero.

Cómo convertir el CSV en una lista útil de preguntas

El primer paso es filtrar por el contenido de la descripción. Puedes buscar palabras como «cómo», «por qué», «no funciona», el nombre del modelo y nombres habituales de componentes. Este filtro crea una cola para la revisión editorial, pero por sí solo no determina la intención del autor: una mención de la marca puede ser una reseña, una broma o una pregunta sobre compatibilidad.

Para agrupar los temas, pasa al clasificador solo los campos de texto necesarios: la descripción y, si es adecuado para la tarea, un identificador de registro anonimizado. Pídele que devuelva categorías fijas, por ejemplo: «primer uso», «limpieza», «compatibilidad», «avería» y «compra». Conserva la descripción original junto a la categoría para que un empleado pueda comprobar la clasificación y corregir posibles errores.

El informe de trabajo puede incluir el tema, el número de ejemplos encontrados, enlaces a varios vídeos ilustrativos y una columna aparte con la indicación «revisado por una persona». El número de ejemplos del conjunto recopilado describe los resultados de esta consulta y este periodo de recopilación; no equivale a la proporción de todos los compradores que tienen el problema.

Paginación y ejecuciones periódicas

Si necesitas la siguiente página de resultados, la documentación indica que cursor es el parámetro de paginación: pasa el valor del cursor de la respuesta anterior a la siguiente solicitud. Trátalo como un token opaco y detén el recorrido cuando la respuesta ya no incluya resultados o la API indique que no hay otra página. Para una prueba limitada, es razonable empezar con una sola consulta, revisar los resultados y añadir la paginación solo después.

Para recopilar datos de forma periódica, ejecuta el script según un horario mediante el programador del sistema operativo o una herramienta de CI. Guarda un archivo JSON original distinto para cada ejecución y añade la hora de recopilación a la tabla. Al acumular el historial, deduplica los registros por ID del vídeo, pero conserva las capturas repetidas por separado si la tarea incluye seguir la evolución de las métricas. Comparar métricas solo tiene sentido cuando hay varias capturas del mismo registro.

Guarda la clave en el gestor de secretos de CI o en una variable de entorno, limita el acceso al archivo y establece un plazo interno de conservación. Antes de transferir los datos a un sistema de clasificación, comprueba qué campos necesita realmente. Así se reduce la copia innecesaria de datos de usuarios y se facilita el control de acceso.

Qué obtiene el equipo

Tras la ejecución, tendrás un archivo de la respuesta original y un CSV con los vídeos encontrados y los campos disponibles. El equipo de soporte podrá comprobar los enlaces y recopilar preguntas recurrentes; el de marketing, observar cómo describe la audiencia sus necesidades; y el analista, repetir la recopilación y comparar observaciones de distintas fechas.

Para empezar, plantea una consulta específica con el nombre del producto y un problema concreto, revisa manualmente entre 20 y 30 registros encontrados y ajusta el vocabulario de categorías. Después puedes añadir varias consultas temáticas, programar ejecuciones y exportar los datos a una hoja de cálculo o una base de datos. Las capacidades de la ruta y sus parámetros se describen en la descripción de TikTok Scraper API; comprueba la consulta elegida antes de crear un sistema de seguimiento más amplio.