Visão Geral do Arquivo Independente
A Subreddit Data oferece acesso a um histórico estático do Reddit, diferente dos feeds ao vivo oficiais. Este serviço é um arquivo independente que preserva a estrutura dos dados para análise retrospectiva, sem garantia de atualização em tempo real. Os analistas de inteligência de comunidade podem confiar neste recurso para estudar padrões de discussão passados com precisão e consistência.
Os dados recuperados são registros planos, não árvores de discussão montadas pelo servidor. Quando parent_id e link_id estiverem presentes, você pode usá-los para agrupar os registros localmente se isso ajudar na análise. O agrupamento é opcional e não recupera os pais ou comentários ausentes. Ter uma referência não significa possuir o texto ao qual ela aponta, nem garante uma conversa completa.
O arquivo é histórico e não fornece uma transmissão contínua de eventos. O endpoint /v1/status retorna uma descrição estática do serviço e confirma apenas que o servidor HTTP responde. Ele não verifica o mecanismo de busca, a disponibilidade dos registros ou a cobertura do arquivo. Uma resposta desse endpoint não prova que determinada consulta encontrará material, nem garante acesso contínuo aos dados.
Rotas, Filtros e Ordenação
As rotas principais permitem buscar publicações e comentários, consultar um item específico e descobrir nomes de comunidades. min_score atua estritamente como um filtro de pontuação mínima, nunca como um controle de ordenação. Os registros seguem a ordem interna _doc do arquivo, que não é cronológica nem ordenada por relevância ou pontuação. Uma avaliação mais alta também não comprova a qualidade do texto para a pesquisa.
Os parâmetros de conteúdo incluem q, subreddit, author, kind, from, to, min_score, limit e page. kind aceita post ou comment. from e to usam YYYY-MM-DD em UTC para filtrar created_utc; to inclui o dia informado por inteiro. As rotas /v1/posts e /v1/comments não exigem id; esse parâmetro pertence à consulta individual /v1/item. Para descobrir nomes de comunidades, /v1/subreddits aceita prefix e limit.
A paginação permite até 100 registros por solicitação e 100 páginas por consulta. Os totais retornados indicam exatidão, limite inferior ou incerteza, nunca garantindo cobertura completa do arquivo. A iteração limitada de páginas não assegura a ingestão exaustiva de todos os registros correspondentes. Os analistas devem interpretar os totais como indicadores de escala, não como contagem definitiva absoluta.
Autenticação, Erros e Limites
A autenticação usa a chave do domínio da conta. HTTP 401 indica chave ausente ou inválida, 402 saldo insuficiente e 429 limite de frequência. Cada recuperação bem-sucedida, mesmo vazia, consome um crédito. Solicitações inválidas não descontam saldo; falhas do serviço de origem devolvem o crédito reservado. Isso é diferente de uma resposta perdida pelo cliente após sucesso no servidor: a cobrança pode permanecer, e uma repetição bem-sucedida custa outro crédito.
O endpoint de status é público e não consome créditos, mas confirma somente a resposta HTTP e o escopo estático do serviço. Os registros recuperados continuam planos; se houver referências a outros registros, o cliente pode agrupá-los localmente. A API não garante árvores completas nem oferece filtros diretos por parent_id. Registre o contexto que falta em vez de considerar que o agrupamento local completou o histórico da conversa.
Os pagamentos são feitos via USDT TRC20 ou USDC ERC20, com valores exatos fornecidos na fatura do servidor. A chave de API é mostrada uma vez após a criação da conta. O limite de taxa 429 é aplicado para prevenir abuso, e o mínimo de recarga é de cinquenta dólares. Essa estrutura permite que analistas integrem facilmente os dados históricos em suas ferramentas de inteligência com previsibilidade.
