# Detectar tendencias de TikTok con un panel fijo de temas

Use un panel fijo de temas para reunir candidatos y, después, revise las fechas de publicación, la relevancia y la cantidad de creadores distintos en observaciones repetidas.

## Definición de las entradas de búsqueda y de los límites del piloto

La versión pública actual de TikTok Search, build 1.1.5, acepta entradas nativas exactas: `queries` (arreglo de cadenas), `expandQueries` (booleano), `maxExpandedQueries` (entero), `maxResults` (entero), `resultsPerQuery` (entero), `maxPagesPerQuery` (entero) y `searchDistribution` ("balanced" o "sequential"). El campo `maxResults` fija un máximo global de videos únicos guardados entre todas las consultas. El campo `resultsPerQuery` fija el máximo de videos únicos guardados por término, aunque la distribución de búsqueda equilibrada puede reducir este límite efectivo por término sin garantizar una reasignación entre términos.

Para ejecutar una primera comprobación piloto, reemplace los valores de entrada guardados por defecto (el arreglo `queries` de tres consultas de muestra, `expandQueries` true, `maxExpandedQueries` 10, `maxResults` 150, `resultsPerQuery` 30, `maxPagesPerQuery` 2, `searchDistribution` "balanced") por una sola consulta prevista en el arreglo `queries`. Use ajustes de anulación acotados: `expandQueries` false, `maxExpandedQueries` 0, `maxResults` 2, `resultsPerQuery` 2, `maxPagesPerQuery` 1 y `searchDistribution` "balanced".

Las salidas de la búsqueda nativa incluyen `postId`, `postUrl`, `authorId`, `profileHandle`, `publishedAt`, `query`, `rootQuery`, `querySource`, `pageIndex`, `pageRank`, `status`, `statusReason` y `observedAt`. Los campos de salida como `queryPlans` muestran solo las consultas y las fuentes planificadas, no los resultados reales de ejecución por consulta. Quien lee debe conservar un registro independiente de intentos a partir de la evidencia de la ejecución. Una ejecución de control con "python tutorial" devolvió dos filas de metadatos y se detuvo con `max_results_reached`. Sus fechas de publicación fueron mayo y agosto, lo que prueba la procedencia básica de los campos de búsqueda, pero no aporta prueba de una campaña activa, de una puntuación de tendencia ni de un filtro automático de fechas.

El registro de salida aporta metadatos de la recolección, incluidos queriesSearched, queryPlans, maxResults, resultsPerQuery, effectiveResultsPerQuery, maxPagesPerQuery, searchDistribution, rowsSaved, fieldCoverage, candidateItemsSeen, rowsAddedBeforeGlobalDedupe, duplicatesSkipped, invalidCandidatesSkipped, stopReason, sourceStatusCounts, status y statusReason. El campo queryPlans describe los términos y las fuentes planificados, pero no registra si la ejecución de cada consulta tuvo éxito o falló. Quien lee debe mantener sus propios registros de intentos a partir de la salida recolectada.

## Respuesta directa y método completo para candidatos a tendencia

Use un panel fijo de temas para reunir candidatos y, después, revise las fechas de publicación, la relevancia y la cantidad de creadores distintos en observaciones repetidas. Trate un video recién encontrado como una observación nueva hasta comprobar su hora de publicación. El resultado es un tablero de revisión de temas, no un gráfico de tendencias de la plataforma ni un pronóstico viral.

1. Defina una decisión de tema y una ventana de publicación reciente antes de recolectar. Por ejemplo, revise si un formato merece una prueba original pequeña en el próximo ciclo de producción. Conserve las [familias de consultas y los presupuestos declarados con exactitud](/es/articles/protocolo-muestras-consultas-tiktok/). No cambie los términos a mitad de camino porque una muestra parezca atractiva. El feed de quien lee y una búsqueda pública sin sesión iniciada tienen reglas de selección distintas.
2. Reemplace los temas amplios no relacionados de la Task guardada por el panel previsto. Mantenga las expansiones desactivadas para una primera repetición exacta, o declare cada familia de consulta raíz si las búsquedas relacionadas se incluyen de forma intencional. La entrada de búsqueda nativa no tiene filtro de fechas. La inclusión de lo reciente es una revisión que hace quien lee de publishedAt y de la evidencia de la fuente después de la recolección, no una promesa de filtro de fechas del Actor.
3. Concilie las consultas intentadas, los resultados de las fuentes y los topes. Conserve los ID y las URL de las publicaciones, los ID de autor, la fecha de publicación, observedAt y el código manual de tema o formato. Una búsqueda que devuelve publicaciones más antiguas sigue aportando candidatos, pero puede no responder una pregunta sobre la ventana reciente. Las fechas del control actual que se comprobó tenían meses de antigüedad, así que no son evidencia de una tendencia actual.
4. Separe observedAt de publishedAt. La primera observación significa que quien lee encontró la publicación en este panel en ese momento. No significa que la publicación se haya publicado entonces ni que antes fuera desconocida en TikTok. Las fechas de publicación desconocidas siguen desconocidas y quedan fuera de un recuento estricto solo de lo reciente hasta que se comprueben. No convierta la fecha de recolección en fecha de publicación.
5. Aplique de forma manual las mismas reglas de relevancia del tema y de ventana de publicación. Revise el video público real para confirmar el formato, no solo un hashtag amplio. Conserve la codificación y el contexto originales. Cuente por separado los ID de publicación conocidos y distintos y los ID de creador conocidos y distintos. Cinco videos relacionados de una cuenta tienen un creador conocido; los ID de creador que faltan quedan sin resolver y separados, no como un solo creador compartido.
6. Repita el panel declarado en un momento posterior registrado cuando quien lee necesite evidencia de persistencia. Defina una instantánea como una ejecución del panel en un solo momento. Guarde cada instantánea y las detenciones de su fuente. Compare los ID recién observados, los ID repetidos y la cantidad de creadores distintos dentro de la muestra elegible. Los cambios de la búsqueda, los topes, las eliminaciones y la visibilidad pueden cambiar el conjunto. Ninguna búsqueda pública repetida demuestra un crecimiento en toda la plataforma ni un primer descubrimiento. Una instantánea fallida impide las comparaciones entre ejecuciones.
7. Construya estados del tema tales como insufficient_evidence, repeated_multi_creator_candidate y ready_for_small_original_test bajo una regla editorial declarada. Por ejemplo, exija videos recientes y relevantes de al menos tres creadores conocidos en dos instantáneas útiles antes de una revisión más cercana. Este es el umbral de quien lee, no una definición oficial de tendencia ni una predicción calibrada. Si una instantánea falló, no haga la comparación.
8. Elija un candidato para una revisión manual del creativo y una prueba original pequeña. Registre por qué encaja con la audiencia y qué evidencia sigue faltando. Las visualizaciones públicas pueden aportar contexto, pero la antigüedad, el tamaño del creador y la visibilidad difieren. No sume resultados parciales de búsqueda para estimar la popularidad en la plataforma ni prediga el alcance futuro.

## Panel repetido ficticio original

El siguiente tablero de candidatos contiene datos ficticios originales con fines didácticos. La ventana estricta de publicación reciente va del 6 de octubre de 2026 inclusive a las 00:00 UTC hasta el 13 de octubre de 2026 exclusive a las 00:00 UTC.

| Instantánea | ID de publicación | ID de creador | publishedAt | first_observed_at | Formato | Elegibilidad estricta y motivo |
| --- | --- | --- | --- | --- | --- | --- |
| S1 | V1 | A | 8 de octubre | 12 de octubre | Formato F | Elegible (En la ventana) |
| S1 | V2 | A | 9 de octubre | 12 de octubre | Formato F | Elegible (En la ventana) |
| S1 | V3 | B | 10 de octubre | 12 de octubre | Formato F | Elegible (En la ventana) |
| S1 | V4 | C | 2 de septiembre | 12 de octubre | Formato F | Excluido (Anterior a la ventana) |
| S1 | V5 | D | Desconocido | 12 de octubre | Formato F | Excluido (Fecha de publicación nula) |
| S2 | V2 | A | 9 de octubre | 12 de octubre | Formato F | Elegible (En la ventana) |
| S2 | V3 | B | 10 de octubre | 12 de octubre | Formato F | Elegible (En la ventana) |
| S2 | V6 | C | 11 de octubre | 13 de octubre | Formato F | Elegible (En la ventana) |
| S2 | V7 | E | Desconocido | 13 de octubre | Formato F | Excluido (Fecha de publicación nula) |

La intersección contiene los ID de publicaciones candidatas que aparecen en el conjunto elegible de ambas instantáneas. La unión contiene los ID de publicaciones candidatas que aparecen en el conjunto elegible de una u otra instantánea. Para estas observaciones, el conjunto de intersección es {V2, V3}, lo que da dos ID de publicaciones repetidos. El conjunto de unión es {V1, V2, V3, V6}, lo que da cuatro videos elegibles distintos de tres creadores conocidos (A, B y C). V6 se observó por primera vez durante la instantánea S2 el 13 de octubre, pero su fecha real de publicación es el 11 de octubre. No etiquete V6 como publicado el 13 de octubre.

### Registro de decisiones de revisión

| Métrica / Regla | Instantánea S1 | Instantánea S2 | Panel combinado |
| --- | --- | --- | --- |
| Elementos guardados | 5 elementos | 4 elementos | 7 elementos únicos en total |
| Motivo de detención | max_results_reached | max_results_reached | Ambos con tope |
| Videos que cumplen la regla estricta de publicación reciente | 3 (V1, V2, V3) | 3 (V2, V3, V6) | 4 videos de la unión |
| Creadores conocidos | 2 (creadores A, B) | 3 (creadores A, B, C) | 3 creadores de la unión |
| Excluidos / Vacíos | V4 (Antiguo), V5 (Desconocido) | V7 (Desconocido) | 1 antigua, 2 fechas desconocidas |
| Regla: 3 creadores por instantánea | No cumplida (2 creadores) | Cumplida (3 creadores) | insufficient_evidence |
| Regla: 3 creadores de la unión en total | N/A | N/A | ready_for_small_original_test |

Bajo una regla estricta que exige tres creadores conocidos y distintos en *cada* instantánea individual, el estado del tema se marca insufficient_evidence porque S1 tuvo solo dos creadores. Si se usa un umbral más débil que exige tres creadores distintos en la unión de varias instantáneas, el estado es ready_for_small_original_test. Ninguno de los dos umbrales garantiza alcance viral ni un estado de tendencia automatizado.

## Siguiente acción

Revise la hora de publicación y la cantidad de creadores distintos de un candidato antes de planificar una prueba original con el [TikTok Search Scraper Actor](https://apify.com/chronometrica/tiktok-search-scraper) y la [TikTok Trend Video Research Task](https://apify.com/chronometrica/tiktok-search-scraper/examples/tiktok-trend-video-research).

## Fuentes y lecturas adicionales

- [TikTok Search Scraper Actor](https://apify.com/chronometrica/tiktok-search-scraper)
- [TikTok Trend Video Research Task](https://apify.com/chronometrica/tiktok-search-scraper/examples/tiktok-trend-video-research)
- [Discusión de Reddit sobre creadores de contenido](https://www.reddit.com/r/ContentCreators/comments/1qdhj7j/how_do_you_guys_find_new_tiktok_trends_early/)