Fundamentos da Pesquisa em Arquivos Independentes
Subreddit API oferece acesso a um arquivo histórico independente, sem afiliação oficial com o Reddit e sem dados em tempo real. Isso não garante integridade absoluta, permanência ou imutabilidade. Defina uma pergunta que os textos disponíveis possam ajudar a explorar. Uma seleção de registros não representa automaticamente os membros atuais, os leitores silenciosos ou todas as discussões de uma comunidade.
Filtros de Palavras-chave e Cronologia
Comece com GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil busca o termo, subreddit=gardening escolhe a comunidade e limit=3 pede até três registros, talvez menos ou nenhum. Para outro grupo, faça uma consulta separada com os mesmos critérios. soil pode ter sentidos diferentes e não inclui automaticamente traduções ou sinônimos; examine o contexto antes de contar ocorrências.
Comparação de Engajamento e Comunidades
Mantenha iguais kind, from e to na comparação. kind aceita post ou comment; datas seguem YYYY-MM-DD em UTC, com to inclusivo. Se usar min_score, registre o limiar: ele seleciona pontuação, sem ordenar nem medir objetivamente qualidade. O corte pode favorecer determinados textos em cada grupo. Contagens de palavras ou classificações de tom são métodos locais, não um serviço de sentimento da API.
Estrutura de Resposta e Limitações Técnicas
As respostas da API retornam registros planos, o que significa que a árvore de encadeamento não é construída pelo servidor, exigindo agrupamento local quando campos como 'parent_id' estão presentes. Isso oferece flexibilidade, mas requer que o cliente interprete a estrutura das conversas. Além disso, a ordem dos documentos no arquivo segue a ordem interna do índice, não sendo cronológica nem baseada em relevância, o que deve ser considerado ao analisar a sequência de posts.
Descoberta de Subreddits e Filtros Adicionais
Explore nomes em /v1/subreddits?prefix=gar sem tratar seus agregados como contagens globais exatas. Depois use /v1/search para consultas de conteúdo com q, subreddit, author, kind e outros filtros permitidos. author e kind não são filtros de /v1/subreddits. Indique as relações ausentes ao agrupar parent_id ou link_id localmente, sem prometer uma conversa completa.
Status do Sistema e Limitações de Cobertura
Cada requisição admite até 100 registros e cada consulta até 100 páginas. eq indica total exato, gte limite inferior e unknown ausência de total confiável, possivelmente nulo. Nenhuma relação comprova cobertura completa ou representatividade. /v1/status é público e não cobrado, retornando apenas uma declaração estática e uma resposta HTTP; não verifica a busca ou a disponibilidade dos registros.
Preservar o procedimento e contabilizar as tentativas
Guarde respostas originais, parâmetros, data da execução e versão das regras. Mantenha separados textos excluídos e seus motivos. Repetir o método sobre arquivos conservados permite rever decisões, mas repetir uma consulta remota não garante os mesmos registros. Um checkpoint não congela as páginas e dividir intervalos não prova ausência de lacunas ou duplicatas.
Use Authorization: Bearer <chave> ou X-API-Key: <chave> do servidor. 400 indica parâmetros inválidos, 401 problema de chave, 402 saldo insuficiente e 429 limite de frequência. Requisições inválidas não debitam saldo; falhas do provedor devolvem a reserva. Uma falha no cliente pode seguir um sucesso cobrado e cada repetição bem-sucedida custa outro crédito. Consulte Documentação, Preços e Obter chave API antes de programar novas coletas.
