Visão geral do arquivo independente
Esta API fornece acesso a um arquivo histórico independente do Reddit, sem afiliação oficial e sem dados em tempo real. A integração com Python e JavaScript consiste em enviar requisições HTTP e interpretar os registros retornados. Não há garantia de cobertura completa, permanência dos registros ou resultados idênticos em consultas futuras.
Defina uma pergunta e teste uma consulta delimitada antes de agendar coletas. Preserve os filtros e a data de execução para explicar o que foi observado. Uma resposta vazia não prova que um assunto nunca apareceu no Reddit, e uma amostra recuperada não descreve necessariamente toda a atividade de uma comunidade.
Separe o cliente HTTP, a transformação dos registros e a apresentação dos resultados. Essa organização permite testar falhas sem depender de uma consulta externa a cada alteração da interface. Em Python, urllib.request e json são opções da biblioteca padrão; em Node.js, fetch e URLSearchParams podem construir a mesma requisição com parâmetros devidamente codificados.
Autenticação e Configuração Inicial
Cadastre a conta com e-mail e senha de 12 a 72 bytes. A chave aparece uma única vez, imediatamente após o cadastro, antes do pagamento. Guarde-a no servidor: ela é necessária para as recuperações autenticadas, mas não para /v1/status. Caso receba os 100 créditos de teste condicionados às regras contra abuso, use-os para examinar respostas reais.
A autenticação aceita Authorization com o valor Bearer seguido da chave, ou X-API-Key com a chave sem prefixo. Cada recuperação bem-sucedida consome um crédito, incluindo resultados vazios. Uma falha no provedor de busca devolve a reserva de crédito. Isso é diferente de uma interrupção no cliente após uma recuperação concluída pelo servidor: essa operação pode ter sido cobrada, e uma repetição bem-sucedida custa outro crédito. A consulta pública de status não consome créditos nem verifica a disponibilidade do arquivo.
Para acrescentar saldo, entre na conta e crie uma fatura. A recarga mínima de $50 compra 50000 créditos. Use USDT em TRON TRC20 ou USDC em Ethereum mainnet ERC20, enviando o valor exato ao destinatário da fatura. Depois informe o hash e solicite verificação, sem pressupor crédito imediato ou um endereço novo para cada pagamento.
Endpoints e Gerenciamento de Requisições
Use /v1/search para consultas gerais, /v1/posts para publicações e /v1/comments para comentários. Os filtros de busca são q, subreddit, author, kind, from, to, min_score, limit e page. kind aceita post ou comment; datas seguem YYYY-MM-DD em UTC, com to inclusivo. min_score é um limiar numérico, não um controle de ordenação.
Somente /v1/item exige id; /v1/subreddits admite prefix. A recuperação segue a ordem documental _doc, não cronológica ou por relevância. Há até 100 registros por requisição e 100 páginas por consulta. Nos totais, eq é exato, gte indica um limite inferior: há pelo menos essa quantidade de correspondências, podendo o total real ser igual ou maior. unknown indica ausência de total confiável. Nenhuma dessas relações comprova recuperação completa.
Confira o status HTTP antes de interpretar o corpo: 400 indica parâmetros inválidos, 401 problema na chave, 402 saldo insuficiente e 429 limite de frequência. fetch pode receber um erro HTTP sem rejeitar a promessa; urllib.request pode lançar HTTPError. Limite as repetições e distinga uma recuperação vazia bem-sucedida de um erro. /v1/status confirma apenas uma resposta HTTP e o escopo estático, não a saúde da busca.
