Como buscar publicações no X por palavra-chave e data

Passos para buscas delimitadas por data

1. Escreva a expressão desejada e o intervalo de datas antes de executar qualquer script. Mantenha maxItemsPerQuery baixo e searchMode definido como latest para uma verificação piloto.
2. Substitua a lista de consultas de exemplo por uma única consulta em formato de texto, um limite máximo de dois itens e os campos nativos startTime e endTime em formato de texto. Não duplique os termos since ou until dentro do texto da consulta.
3. Salve os textos de inputQuery e executedQuery. Por exemplo, uma solicitação com término em 9 de julho gera um limite superior exclusivo em 10 de julho, como until:2026-07-10.
4. Interprete os valores nativos de data e hora de createdAt e verifique se estão dentro de um intervalo declarado em UTC. Rótulos que mostram apenas datas nas telas não definem um fuso horário local, a menos que você faça a conversão.
5. Mantenha os valores ausentes de data e hora marcados como não resolvidos, em vez de estimá-los. Um campo createdAt vazio não pode ser ordenado com base em observedAt, que registra apenas o momento da coleta.
6. Verifique os IDs e nomes de usuário dos autores e os tipos de publicação, como respostas, citações ou republicações. Uma publicação de um autor ainda pode ser uma resposta, em vez de uma publicação original independente.
7. Inspecione os campos de nível superior de OUTPUT, como searchesQueued, searchesStarted, rowsSaved, outsideTimeRange, statusCounts e stopReason. Inspecione também o array queries, que contém inputQuery, executedQuery, status, rowsSaved, outsideTimeRange e stopReason. No nível superior, queries_exhausted significa que o processamento da fila terminou, e não que todas as publicações correspondentes na fonte foram esgotadas. Já max_items_per_query, por consulta, significa que a amostra atingiu o limite daquela consulta. Mantenha separados os resultados com falha, sem registros e que atingiram o limite. Preserve as lacunas nas posições da fonte, em vez de reclassificar os registros coletados.
8. Entregue seu registro com datas, os comprovantes dos parâmetros de entrada e as contagens de exclusões. Não suponha que uma amostra pequena represente a frequência total na plataforma ou a popularidade histórica.

Exemplo fictício original de verificação dos limites em UTC

A tabela a seguir é um pequeno caso de teste fictício original para verificar os limites de datas em UTC em um intervalo de 1 a 4 de outubro. UTC significa Tempo Universal Coordenado. Um intervalo semiaberto inclui seu horário inicial, mas exclui seu limite superior. Pela convenção verificada para entradas que contêm apenas datas, uma solicitação de 1 a 3 de outubro, incluindo ambas as datas, corresponde a um início em 1 de outubro às 00:00 UTC e a um limite superior exclusivo em 4 de outubro às 00:00 UTC. O endTime nativo solicitado para 3 de outubro e o until gerado para 4 de outubro permanecem separados. Este é um caso de teste para o leitor verificar, e não dados reais do teste de controle do Actor.

Este caso de teste mostra 2 registros dentro do intervalo, 1 fora e 1 com situação não resolvida, cuja data de criação é null. Uma amostra coletada pode não incluir publicações anteriores. Portanto, uma publicação ausente significa que ela não foi vista na amostra, e não que ela não existe no X.