Primeira amostra: soil em gardening
Faça GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil busca o termo, subreddit=gardening seleciona a comunidade e limit=3 pede no máximo três registros, podendo retornar menos ou nenhum. <chave> é apenas um marcador nos exemplos públicos. Para comparar outro grupo, faça uma consulta separada mantendo os demais critérios; o servidor não calcula a comparação.
Exemplo sintético do contêiner JSON, sem resultado real: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. O saldo é fictício. Conte vocabulário nos textos recebidos com suas próprias regras. A API não fornece análise de sentimento. eq é um total exato, gte um limite inferior e unknown ausência de total confiável, possivelmente nulo; nenhum deles comprova representatividade.
Arquivo Consistente para Pesquisadores
Subreddit API permite consultar um arquivo histórico independente do Reddit, sem afiliação oficial e sem dados em tempo real. Pesquisadores podem examinar os registros disponíveis para uma pergunta delimitada. A origem histórica não garante cobertura completa, imutabilidade ou disponibilidade permanente. Trate os resultados como uma seleção arquivada, sem atribuí-los automaticamente a todos os participantes da comunidade.
A consistência deve estar no procedimento de comparação: use o mesmo termo, tipo de conteúdo e intervalo temporal nas comunidades escolhidas. Registre por que selecionou cada grupo e quais textos excluiu. Filtros iguais não tornam duas amostras equivalentes ou representativas. Uma resposta vazia também não prova que o assunto nunca apareceu entre os membros de uma comunidade.
Guarde as respostas originais, os parâmetros, a data da execução e a versão das regras locais. Você pode repetir a análise sobre os arquivos conservados para rever uma classificação ou contagem. Repetir a consulta remota não garante os mesmos registros. Preservar a seleção observada permite documentar seu trabalho, sem afirmar que o arquivo fornece um conjunto de dados imutável.
Fluxo de Trabalho e Filtragem Avançada
Cadastre-se com e-mail e senha de 12–72 bytes; a chave aparece uma única vez antes de pagar. Envie as consultas autenticadas com Authorization: Bearer <chave> ou X-API-Key: <chave> do seu servidor. O cookie Secure HttpOnly do painel tem outra função. /v1/status é público e não exige chave. Conta, chave e saldo pertencem a subredditapi.com.
A busca aceita q, subreddit, author, kind, from, to, min_score, limit e page. kind usa post ou comment; as datas seguem YYYY-MM-DD em UTC, com to inclusivo. min_score aplica uma pontuação mínima, sem ordenar ou garantir qualidade. A ordem _doc é documental interna, não cronológica, por relevância ou pontuação. Um eventual ordenamento local só abrange os registros recebidos.
Cada requisição admite até 100 registros e cada consulta até 100 páginas. Percorrer as páginas não demonstra coleta exaustiva nem ausência de duplicatas. Os resultados são planos, sem árvore de conversa montada pelo servidor. Você pode agrupar parent_id ou link_id quando aparecem, mas esses campos não são filtros expostos e não garantem uma discussão completa.
Transparência de Preços e Limitações Técnicas
Cada recuperação bem-sucedida custa um crédito, inclusive vazia: $1 por 1000 requisições. A recarga mínima de $50 compra 50000 créditos. Não há assinatura e os créditos comprados não expiram. Podem ser concedidos 100 créditos de teste, sujeitos aos controles contra abusos da rede, sem atribuição garantida. O mínimo de recarga não é requisito para obter a chave.
Requisições inválidas não debitam saldo e falhas do provedor de busca devolvem a reserva. Uma conexão interrompida no cliente pode seguir um sucesso cobrado no servidor; uma repetição bem-sucedida custa outro crédito. /v1/status retorna uma declaração estática e indica que a aplicação HTTP responde, sem testar a busca ou disponibilidade dos registros. Não há garantia de velocidade ou continuidade.
Para acrescentar saldo, entre na conta e crie uma fatura antes de transferir. Use o destinatário e o valor exatos com USDT em TRON TRC20 ou USDC em Ethereum mainnet ERC20. Depois informe o hash e solicite verificação. Somente uma transferência genuína confirmada acrescenta créditos, sem prazo garantido. Uma fatura única não implica um novo endereço receptor.
