# Identificar tendências do TikTok com um painel fixo de tópicos

Use um painel fixo de tópicos para reunir candidatos e, em seguida, confira datas de publicação, relevância e amplitude de criadores em observações repetidas.

## Definir entradas de busca e limites do piloto

A versão pública atual do TikTok Search, build 1.1.5, aceita entradas nativas exatas: `queries` (array de strings), `expandQueries` (booleano), `maxExpandedQueries` (inteiro), `maxResults` (inteiro), `resultsPerQuery` (inteiro), `maxPagesPerQuery` (inteiro) e `searchDistribution` ("balanced" ou "sequential"). O campo `maxResults` define um máximo global de vídeos únicos salvos em todas as consultas. O campo `resultsPerQuery` define o máximo de vídeos únicos salvos por termo, embora a distribuição de busca balanced possa reduzir esse limite efetivo por termo sem garantir realocação entre os termos.

Para executar uma primeira verificação piloto, substitua os valores de entrada salvos por padrão (array `queries` com três consultas de exemplo, `expandQueries` true, `maxExpandedQueries` 10, `maxResults` 150, `resultsPerQuery` 30, `maxPagesPerQuery` 2, `searchDistribution` "balanced") por uma única consulta pretendida no array `queries`. Use configurações de substituição delimitadas: `expandQueries` false, `maxExpandedQueries` 0, `maxResults` 2, `resultsPerQuery` 2, `maxPagesPerQuery` 1 e `searchDistribution` "balanced".

As saídas nativas da busca incluem `postId`, `postUrl`, `authorId`, `profileHandle`, `publishedAt`, `query`, `rootQuery`, `querySource`, `pageIndex`, `pageRank`, `status`, `statusReason` e `observedAt`. Campos de saída como `queryPlans` mostram apenas as consultas e as fontes planejadas, não os resultados reais de execução por consulta. Os leitores devem manter um registro independente de tentativas a partir da evidência da execução. Uma execução de controle com "python tutorial" retornou duas linhas de metadados e parou com `max_results_reached`. As datas de publicação eram maio e agosto, o que comprova a procedência básica dos campos de busca, mas não fornece prova de campanha ao vivo, pontuação de tendência nem filtro automático de data.

O registro de saída fornece metadados da coleta, incluindo queriesSearched, queryPlans, maxResults, resultsPerQuery, effectiveResultsPerQuery, maxPagesPerQuery, searchDistribution, rowsSaved, fieldCoverage, candidateItemsSeen, rowsAddedBeforeGlobalDedupe, duplicatesSkipped, invalidCandidatesSkipped, stopReason, sourceStatusCounts, status e statusReason. O campo queryPlans descreve termos e fontes planejados, mas não registra resultados individuais de sucesso ou falha por consulta. Os leitores devem manter os próprios registros de tentativas a partir da saída coletada.

## Resposta direta e método completo de candidatos a tendência

Use um painel fixo de tópicos para reunir candidatos e, em seguida, confira datas de publicação, relevância e amplitude de criadores em observações repetidas. Trate um vídeo recém-encontrado como uma nova observação até que o horário de publicação seja conferido. O resultado é um quadro de revisão de tópicos, não um gráfico de tendência da plataforma nem uma previsão viral.

1. Defina uma decisão de tópico e uma janela de publicação recente antes de coletar. Por exemplo, avalie se um formato merece um teste original pequeno no próximo ciclo de produção. Mantenha as [famílias de consulta e os orçamentos declarados com exatidão](/pt-BR/articles/protocolo-de-amostras-de-consulta-tiktok/). Não mude os termos no meio do caminho porque uma amostra parece empolgante. O feed de um leitor e uma busca pública sem login têm regras de seleção diferentes.
2. Substitua os tópicos amplos não relacionados da Task salva pelo painel pretendido. Mantenha as expansões desligadas na primeira repetição exata ou declare cada família de consulta raiz se buscas relacionadas forem incluídas de propósito. A entrada nativa de busca não tem filtro de data. A inclusão recente é a revisão, pelo leitor, de publishedAt e da evidência da fonte depois da coleta, não uma promessa de filtro de data do Actor.
3. Reconcilie as consultas tentadas, os resultados das fontes e os tetos. Guarde IDs/URLs de posts, IDs de autores, data de publicação, observedAt e o código manual de tópico/formato. Uma busca que retorna posts mais antigos ainda fornece candidatos, mas pode não responder a uma pergunta sobre a janela recente. As datas do controle atual conferido tinham meses, portanto não são evidência de tendência atual.
4. Separe observedAt de publishedAt. A primeira observação significa que o leitor encontrou o item neste painel naquele momento. Isso não significa que o post foi publicado então nem que era desconhecido antes no TikTok. Datas de publicação desconhecidas permanecem desconhecidas e ficam fora de uma contagem estrita apenas de itens recentes até serem conferidas. Não converta a data de coleta em data de publicação.
5. Aplique manualmente as mesmas regras de relevância do tópico e de janela de publicação. Revise o vídeo público real para confirmar o formato, não apenas uma hashtag ampla. Mantenha a codificação e o contexto originais. Conte separadamente IDs de posts conhecidos distintos e IDs de criadores conhecidos distintos. Cinco vídeos relacionados de uma conta têm um criador conhecido; IDs de criador ausentes permanecem não resolvidos e separados, não como um criador compartilhado.
6. Repita o painel declarado em um momento posterior registrado quando o leitor precisar de evidência de persistência. Defina um instantâneo como uma única execução do painel em um ponto no tempo. Salve cada instantâneo e as paradas da fonte. Compare IDs recém-observados, IDs repetidos e a amplitude de criadores dentro da amostra elegível. Mudanças na busca, tetos, exclusões e visibilidade podem alterar o conjunto. Nenhuma busca pública repetida prova crescimento em toda a plataforma nem a primeira descoberta. Um instantâneo com falha impede comparações entre execuções.
7. Monte estados de tópico como insufficient_evidence, repeated_multi_creator_candidate e ready_for_small_original_test sob uma regra editorial declarada. Por exemplo, exija vídeos recentes relevantes de pelo menos três criadores conhecidos em dois instantâneos úteis antes de uma revisão mais detalhada. Esse é o limiar do leitor, não uma definição oficial de tendência nem uma previsão calibrada. Se um instantâneo falhou, suspenda a comparação.
8. Escolha um candidato para revisão manual do criativo e um teste original pequeno. Registre por que ele se encaixa no público e qual evidência ainda falta. Visualizações públicas podem fornecer contexto, mas idade, tamanho do criador e visibilidade diferem. Não some resultados parciais de busca em uma estimativa de popularidade da plataforma nem preveja o alcance futuro.

## Painel repetido ficcional original

O quadro de candidatos a seguir contém dados ficcionais originais para fins de ensino. A janela estrita de publicação recente vai de 6 de outubro de 2026, inclusive, às 00:00 UTC, até 13 de outubro de 2026, exclusivo, às 00:00 UTC.

| Instantâneo | ID do post | ID do criador | publishedAt | first_observed_at | Formato | Elegibilidade estrita e motivo |
| --- | --- | --- | --- | --- | --- | --- |
| S1 | V1 | A | 8 de outubro | 12 de outubro | Formato F | Elegível (Na janela) |
| S1 | V2 | A | 9 de outubro | 12 de outubro | Formato F | Elegível (Na janela) |
| S1 | V3 | B | 10 de outubro | 12 de outubro | Formato F | Elegível (Na janela) |
| S1 | V4 | C | 2 de setembro | 12 de outubro | Formato F | Excluído (Mais antigo que a janela) |
| S1 | V5 | D | Desconhecido | 12 de outubro | Formato F | Excluído (Data de publicação nula) |
| S2 | V2 | A | 9 de outubro | 12 de outubro | Formato F | Elegível (Na janela) |
| S2 | V3 | B | 10 de outubro | 12 de outubro | Formato F | Elegível (Na janela) |
| S2 | V6 | C | 11 de outubro | 13 de outubro | Formato F | Elegível (Na janela) |
| S2 | V7 | E | Desconhecido | 13 de outubro | Formato F | Excluído (Data de publicação nula) |

A interseção contém IDs de posts candidatos que aparecem no conjunto elegível dos dois instantâneos. A união contém IDs de posts candidatos que aparecem no conjunto elegível de qualquer um dos instantâneos. Para estas observações, o conjunto de interseção é {V2, V3}, o que dá dois IDs de post repetidos. O conjunto de união é {V1, V2, V3, V6}, o que dá quatro vídeos elegíveis únicos de três criadores conhecidos (A, B e C). V6 foi observado pela primeira vez durante o instantâneo S2 em 13 de outubro, mas a data real de publicação é 11 de outubro. Não rotule V6 como publicado em 13 de outubro.

### Registro de decisões de revisão

| Métrica / Regra | Instantâneo S1 | Instantâneo S2 | Painel combinado |
| --- | --- | --- | --- |
| Itens salvos | 5 itens | 4 itens | 7 itens únicos no total |
| Motivo da parada | max_results_reached | max_results_reached | Ambos com teto atingido |
| Vídeos que atendem à regra estrita de publicação recente | 3 (V1, V2, V3) | 3 (V2, V3, V6) | 4 vídeos na união |
| Criadores conhecidos | 2 (criadores A, B) | 3 (criadores A, B, C) | 3 criadores na união |
| Excluídos / Lacunas | V4 (Antigo), V5 (Desconhecido) | V7 (Desconhecido) | 1 antigo, 2 datas desconhecidas |
| Regra: 3 criadores por instantâneo | Falhou (2 criadores) | Aprovado (3 criadores) | insufficient_evidence |
| Regra: 3 criadores na união no total | N/A | N/A | ready_for_small_original_test |

Sob uma regra estrita que exige três criadores conhecidos distintos em *cada* instantâneo individual, o estado do tópico é marcado como insufficient_evidence porque S1 teve apenas dois criadores. Se for usado um limiar mais fraco que exige três criadores únicos na união de vários instantâneos, o estado é ready_for_small_original_test. Nenhum dos limiares garante alcance viral nem estado automatizado de tendência.

## Próxima ação

Confira o horário de publicação e a amplitude de criadores de um candidato antes de planejar um teste original com o [TikTok Search Scraper Actor](https://apify.com/chronometrica/tiktok-search-scraper) e a [TikTok Trend Video Research Task](https://apify.com/chronometrica/tiktok-search-scraper/examples/tiktok-trend-video-research).

## Fontes e leituras adicionais

- [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)
- [Discussão no Reddit de criadores de conteúdo](https://www.reddit.com/r/ContentCreators/comments/1qdhj7j/how_do_you_guys_find_new_tiktok_trends_early/)