Autenticação, Limites e Estrutura de Resposta
Envie requisições GET para api.subredditapi.com com Authorization: Bearer <chave> ou X-API-Key: <chave>. As duas opções são aceitas nas recuperações autenticadas. /v1/status é público e dispensa chave. A sessão do painel usa um cookie Secure HttpOnly, separado desses cabeçalhos. Mantenha a credencial no servidor e fora dos arquivos de pesquisa compartilhados.
Os registros retornados pela API são planos e não árvores de encadeamento montadas pelo servidor. Quando os campos parent_id e link_id estão presentes, o cliente pode agrupá-los localmente, mas não há garantia de ancestralidade completa ou conversa integrada. Não existem filtros de consulta expostos para esses IDs, e a ordenação segue a ordem interna do documento do arquivo.
limit e page admitem valores de 1 a 100: cada requisição recebe uma página com até 100 registros e cada consulta admite até 100 páginas. A ordem _doc não é cronológica, por relevância ou pontuação. eq indica total exato, gte limite inferior e unknown ausência de total confiável, possivelmente nulo. Nenhuma relação ou percurso de páginas comprova cobertura completa.
Filtros de Consulta e Semântica de Dados
Os filtros de busca são q, subreddit, author, kind, from, to, min_score, limit e page. kind aceita post ou comment. As datas seguem YYYY-MM-DD em UTC, com to inclusivo. min_score é um filtro de pontuação mínima, não um controle de ordenação nem uma medida objetiva da qualidade do texto. Documente qualquer limiar usado na comparação.
Use /v1/search para busca, /v1/posts para publicações e /v1/comments para comentários. Só /v1/item exige id. /v1/subreddits aceita prefix e limit para explorar nomes de comunidades; não aceita author ou kind. Suas agregações não garantem contagens globais exatas. Separe a descoberta de nomes das consultas de conteúdo que fornecerão os textos da pesquisa.
O serviço lê registros históricos e não oferece OAuth de Reddit, publicação, votos ou mensagens privadas. Também não realiza análise de sentimento ou comparação de comunidades no servidor. Você pode aplicar seus métodos aos textos recuperados localmente, explicando idioma, exclusões e limitações. Uma pesquisa de palavra não garante que todos os resultados tenham o sentido pretendido.
Limitações, Pagamento e Registros
Cada recuperação bem-sucedida custa um crédito, mesmo vazia: $1 por 1000 requisições. A recarga mínima de $50 compra 50000 créditos sem expiração dos créditos comprados ou assinatura. Para pagar, entre na conta, crie uma fatura, siga seu destinatário e valor exatos e solicite verificação com o hash. Não se garante um prazo de crédito nem endereço novo por fatura.
400 indica parâmetros inválidos, 401 uma chave ausente ou inválida, 402 créditos insuficientes e 429 limite de frequência. Requisições inválidas não debitam saldo e falhas do provedor de busca devolvem a reserva. Uma interrupção do cliente pode ocorrer depois de um sucesso cobrado; uma repetição bem-sucedida custa outro crédito. Limite tentativas e registre a causa sem incluir o segredo.
O endpoint /v1/status retorna uma divulgação estática independente, confirmando apenas a resposta do servidor HTTP. Não verifica a saúde da busca ou a completude dos dados. O registro de erro 402 indica crédito insuficiente, enquanto 429 sinaliza limite de taxa atingido. A precisão das informações depende da ingestão anterior, sem garantias de cobertura total do histórico global.
Duas consultas, critérios documentados
Comece por /v1/search?q=soil&subreddit=gardening&limit=3. Guarde a resposta e, para outro grupo, altere apenas subreddit se essa for a variável escolhida. Mantenha termo, tipo e datas iguais. Registre textos ausentes e decisões sobre traduções de soil, sem transformar uma falha de leitura em ausência de vocabulário. Documente quais registros entraram na contagem.
Consulte Preços para calcular cada página e Obter chave API para gerir credenciais. Conserve os arquivos originais e a versão do método local para rever frequências e exemplos textuais. Nem uma seleção pequena nem uma coleta paginada produz automaticamente uma amostra aleatória, comparável ou representativa. Descreva essas diferenças antes de inferir mudanças de linguagem entre comunidades.
