Defina o que será contado antes da coleta
Escreva uma decisão verificável: entre os registros recebidos de r/science com replication, quais discutem a repetição de um estudo? Use o registro como unidade e decida se incluirá posts, comentários ou ambos. A consulta seleciona candidatos; a leitura local atribui categorias. A ocorrência de uma palavra não demonstra que um resultado científico foi replicado.
A API é um arquivo histórico independente, não oficial nem afiliado ao Reddit e sem atualizações em tempo real. O fato de os registros serem históricos não os torna imutáveis. Não há garantia de cobertura completa ou de que uma nova consulta retorne os mesmos dados. Defina o experimento em termos do material recebido, sem atribuir a esse conjunto propriedades de toda a comunidade ou de uma população maior.
Fixe regras locais para campos ausentes, duplicatas recebidas e referências que não conseguir resolver. Separe essas decisões dos parâmetros da API. Registre mudanças como versões do protocolo, em vez de alterar os critérios silenciosamente depois de ver o resultado. A documentação deve permitir examinar as escolhas feitas, sem afirmar que a coleção é completa ou que o experimento está livre de viés.
Registre a consulta efetivamente executada
Comece por GET https://api.redditapilabs.com/v1/search?q=replication&subreddit=science&limit=3, o exemplo da página inicial. Salve a rota e os parâmetros efetivos, incluindo valores padrão usados. Autentique no servidor com X-API-Key: <chave> ou Authorization: Bearer <chave>, mas retire segredos dos arquivos compartilhados. A página Obter chave API explica a emissão antes do pagamento e a gestão do acesso.
Ao experimentar replication crisis, registre uma alteração da consulta. q busca em title e text com operador and dentro do campo correspondente; não apenas combina uma palavra do título com outra do corpo. Mantenha separadas as respostas das duas formulações. Nenhuma delas cobre todo o vocabulário da replicação científica.
Guarde cada resposta recebida antes de limpar ou agregar campos. Anote separadamente a hora de execução do cliente, o status HTTP e as fronteiras de paginação encontradas. from e to filtram created_utc com YYYY-MM-DD UTC e incluem todo o último dia; não indicam a entrada no arquivo. Os registros são planos e podem variar: parent_id ou link_id presentes permitem relações locais, sem conversa completa garantida e sem filtros por esses identificadores.
Classifique sem substituir o texto original
Monte uma tabela local com o identificador disponível, a categoria e a justificativa. Para começar, separe repetição de estudos, replicação biológica e contexto insuficiente. São rótulos seus, não campos da API. Reserve os casos ambíguos para revisão e preserve o texto original junto da versão preparada para análise.
Você pode calcular um hash do arquivo salvo e anotar seu nome junto com a versão do código e das dependências. Esse hash identifica os bytes da sua cópia; não comprova autenticidade do conteúdo, representatividade ou integridade do arquivo remoto. Mantenha um arquivo original e outro derivado, documentando a transformação entre eles. Essa organização é trabalho da sua equipe, não um recurso de armazenamento ou versionamento fornecido pela API.
Compare uma mudança por vez
Para revisar a análise, use primeiro os arquivos salvos e a versão documentada do código. Se seu próprio método usar aleatoriedade, anote a configuração e as condições do ambiente. Confira se as diferenças vêm dos dados, das regras ou das ferramentas. Isso permite investigar divergências; guardar um arquivo não garante resultados idênticos em qualquer ambiente nem certifica a validade de uma conclusão científica.
Primeiro mantenha a cópia salva e altere apenas a regra de classificação. Explique quais decisões mudaram e por quê. Uma nova recuperação remota precisa de seu próprio registro. Se dados e regras mudam ao mesmo tempo, a diferença nas contagens não pode ser atribuída exclusivamente a uma dessas mudanças.
Uma nova recuperação é outra observação do arquivo. limit e page vão de 1 a 100, com uma página por solicitação; _doc não é cronologia, relevância ou pontuação. Leia total com relation: eq é exato para a consulta, gte é limite inferior e unknown indica total não confiável, possivelmente null. Percorrer páginas, dividir datas ou remover duplicatas não prova exaustividade ou imutabilidade. /v1/subreddits aceita apenas prefix e limit para nomes, sem page.
Encerre com limites e casos pendentes
Finalize com parâmetros, páginas recebidas, registros mantidos, exclusões e casos não resolvidos. Anote por que parou e qual versão da regra produziu as contagens. Restrinja as conclusões ao material: total desconhecido, contexto ausente ou uma lacuna do arquivo não demonstram silêncio da comunidade.
Preveja um crédito por recuperação bem-sucedida, inclusive vazia ou repetida: $1 por 1000 solicitações e recarga mínima de $50. Os 100 créditos de teste são condicionais. Pedidos inválidos não debitam; falhas na origem devolvem a reserva. Perder a resposta pode ocultar um sucesso cobrado, e falhas locais não o reembolsam. Consulte preços e documentação: corrija 400, confira chave com 401, saldo com 402 e limite repetições com espera em 429. /v1/status não testa o mecanismo de busca nem reproduz resultados.
