Fundamentos da Busca por Intervalo de Tempo
Reddit Posts API consulta um arquivo histórico independente, sem afiliação oficial com o Reddit e sem dados em tempo real. Não há garantia de cobertura completa, imutabilidade ou disponibilidade permanente. Para analisar publicações sobre equipamento fotográfico, examine uma amostra antes de definir a coleta. A presença de um registro não prova a disponibilidade de toda uma época ou o estado atual da publicação original.
Comece com GET https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3. subreddit escolhe a comunidade, min_score define a pontuação mínima e limit pede até três registros. Não é uma classificação por popularidade nem uma seleção automática de câmeras ou lentes. Registre quais textos você aceita como relevantes e conserve aqueles cuja interpretação é ambígua. Uma resposta vazia bem-sucedida também custa um crédito.
Use from e to como YYYY-MM-DD em UTC. to inclui todo o dia final; os parâmetros não aceitam horários dentro do dia. Se a pergunta começa em datas locais, documente como você as relaciona aos dias UTC, sem apresentar isso como uma função nativa de horário local do autor. Um filtro de data limita a consulta, mas não atesta cobertura completa.
Estrutura dos Dados e Limites de Paginação
Para trechos consecutivos, o próximo from pode ser o dia seguinte ao to anterior. Repetir a mesma data nas duas pontas cria uma sobreposição por causa do final inclusivo. Essa regra organiza limites, sem provar ausência de duplicatas ou lacunas entre os registros obtidos. Registre filtros e data da execução antes de interpretar volumes históricos.
Há até 100 registros por requisição e 100 páginas por consulta. A ordem _doc é documental interna, não cronológica, por relevância ou pontuação. Filtrar datas não muda essa ordenação. Se precisar de uma linha temporal, ordene localmente pelos campos disponíveis e indique os registros sem dados suficientes, sem afirmar que reconstruiu a sequência completa de publicações.
eq significa total exato para a consulta, gte limite inferior e unknown ausência de total confiável, possivelmente nulo. Nem um total exato nem a última página permitida demonstra que todos os registros foram recebidos. Salve as respostas originais antes de avançar o checkpoint; um número de página não congela o arquivo ou garante futuras respostas idênticas.
Filtros Avançados e Status do Serviço
As respostas são planas. Se parent_id ou link_id aparecem, agrupe os elementos localmente quando necessário, sem pressupor todos os ancestrais ou uma conversa completa. Esses campos não são filtros expostos. min_score não mede qualidade ou relevância e pode mudar a composição da seleção. Separe o texto recebido das suas etiquetas e registre motivos de exclusão.
Use Authorization: Bearer <chave> ou X-API-Key: <chave> no 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 de busca devolvem a reserva. Uma conexão interrompida no cliente pode seguir um sucesso cobrado e cada repetição bem-sucedida custa outro crédito.
Consulte Documentação para os filtros, Preços para contar cada página e Obter chave API para gerir o acesso. /v1/status é público e não cobrado, mas apenas retorna uma declaração estática e indica que a aplicação HTTP responde, sem verificar busca ou disponibilidade de registros. Reprocessar arquivos conservados testa sua análise local, não a imutabilidade ou a cobertura do arquivo remoto.
