Autenticação e Controle de Acesso
Envie requisições GET para api.redditpostsapi.com com Authorization: Bearer <chave> ou X-API-Key: <chave> nas recuperações autenticadas. /v1/status é público e não exige chave. A sessão do painel usa um cookie Secure HttpOnly, separado desses cabeçalhos. Guarde o segredo na configuração do servidor, fora de arquivos de análise e diagnósticos compartilhados.
Conta, chave e saldo pertencem a redditpostsapi.com e não se compartilham entre marcas. Os controles contra abusos do teste se aplicam à rede, sem criar um saldo global. A chave aparece uma vez no cadastro antes de pagar. A regeneração exige login e confirmação da senha, invalidando imediatamente a anterior. Não há redefinição de senha nem envio automático de chaves por e-mail.
Cada recuperação bem-sucedida custa um crédito, mesmo vazia. Requisições inválidas não debitam saldo e falhas do provedor de busca devolvem a reserva. Uma interrupção no cliente pode seguir um sucesso cobrado no servidor; uma repetição bem-sucedida custa outro crédito. Limite as tentativas e diferencie erros HTTP recebidos de falhas de conexão antes de interpretar o corpo como dados.
Limites de Recuperação e Estrutura de Dados
As respostas da API são compostas por registros planos, o que significa que não há árvores de encadeamento pré-construídas enviadas pelo servidor. Você pode agrupar localmente os campos parent_id e link_id se estiverem presentes, mas não há garantia de completude da conversação. A ordenação segue a ordem interna do documento, não sendo cronológica ou baseada em relevância.
Cada solicitação pode retornar no máximo cem registros, e você pode iterar até cem páginas. No entanto, isso não garante cobertura total do arquivo. Os totais de paginação podem ser exatos, um limite inferior ou desconhecidos. Não infira a cobertura completa apenas iterando as páginas, pois o arquivo pode não estar totalmente ingerido.
A busca admite q, subreddit, author, kind, from, to, min_score, limit e page. kind aceita post ou comment; from e to são YYYY-MM-DD em UTC, com to inclusivo para todo o dia. Não há precisão intradiária nesses parâmetros. Só /v1/item exige id; /v1/posts e /v1/comments não o exigem. /v1/subreddits aceita prefix e limit, sem contagens globais exatas garantidas.
Erros de Protocolo e Considerações Finais
400 indica requisição inválida, 401 chave ausente ou inválida, 402 saldo insuficiente e 429 limite de frequência. Confira o status antes de tratar uma resposta como registros. /v1/status é uma rota pública não cobrada, não um código HTTP: devolve uma declaração estática do escopo histórico e indica que a aplicação HTTP responde, sem verificar busca ou disponibilidade de dados.
limit e page admitem valores de 1 a 100. Uma requisição recebe uma página de até 100 registros, e cada consulta admite até 100 páginas. min_score filtra pontuação sem ordenar ou garantir relevância. A saída segue _doc, a ordem documental interna. eq é total exato, gte limite inferior e unknown ausência de total confiável, possivelmente nulo; nada disso comprova extração completa.
O preço é de $1 por 1000 recuperações bem-sucedidas e a recarga mínima de $50 compra 50000 créditos. Os créditos comprados não expiram e não há assinatura. Para pagar, entre na conta e crie uma fatura, siga destinatário e valor exatos e solicite verificação com o hash. Somente uma transferência genuína confirmada acrescenta saldo, sem prazo garantido de crédito.
Conferir uma seleção por datas
Comece com /v1/posts?subreddit=photography&min_score=10&limit=3 e examine quais textos tratam de equipamento. Ao adicionar from e to, registre as datas UTC e o final inclusivo. Para trechos consecutivos sem sobrepor o dia-limite, comece o próximo no dia seguinte. Isso organiza as consultas, mas não prova ausência de registros repetidos ou faltantes. Guarde respostas e regras locais sem supor futuras respostas idênticas.
