Selecione registros
Consulte /v1/search com q=search e subreddit=SideProject; comece com limit=3.
Dados históricos do Reddit · API JSON
Adicione busca em discussões Reddit à sua aplicação
Use registros arquivados do Reddit para adicionar busca em discussões a uma aplicação web ou móvel. O exemplo solicita uma página com até três registros.
GETJSONHTTPS
Anatomia da requisição
/v1/searchSideProject01Cada requisição bem-sucedida custa um crédito, mesmo com resultado vazio.
100Páginas e limites
$1 / 1,000Cobrança por requisição
01 / Reddit App API
Reddit App API — Da consulta a dados úteis
Comece com uma seleção pequena. Preserve campos e parâmetros necessários à próxima etapa e processe o resultado na sua aplicação.
Prepare a resposta
Mantenha a chave API no backend; envie ao navegador ou app móvel apenas os dados selecionados.
Use no seu projeto
Guarde o permalink disponível com suas notas como referência; a página vinculada pode ficar indisponível.
Uma requisição que você pode adaptar
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
--data-urlencode 'q=search' \
--data-urlencode 'subreddit=SideProject' \
--data-urlencode 'limit=3' \
--data-urlencode 'page=1'O exemplo solicita uma página com até três registros.
URL base da API
https://api.redditapp.com/v1Controle o escopo de cada requisição
Texto e comunidade
Combine q com subreddit ou author para restringir a seleção.
Datas em UTC
Use from e to com datas YYYY-MM-DD. A data final inclui todo o dia UTC.
Páginas e limites
Defina limit e page e salve os metadados de paginação com os resultados.
Pague por requisição bem-sucedida
Cada requisição bem-sucedida custa um crédito, mesmo com resultado vazio.
$1 por 1.000 requisições bem-sucedidas
Recarga mínima: $50 · 50.000 créditos
FAQ / 08
Antes da integração
O que é Reddit App API?
Reddit App API é uma API JSON independente para registros históricos do Reddit. Oferece rotas de leitura para busca, posts, comentários, registros individuais e descoberta de subreddits. O serviço não é operado pelo Reddit nem tem afiliação com ele. Use registros arquivados do Reddit para adicionar busca em discussões a uma aplicação web ou móvel. O exemplo solicita uma página com até três registros.
Como obtenho uma chave API?
Crie uma conta com email e senha neste site. A chave aparece após o cadastro, antes de qualquer pagamento obrigatório; guarde-a com segurança porque é exibida uma só vez. Envie-a pelo servidor usando X-API-Key ou Authorization: Bearer. Regenerar a chave invalida a anterior.
Quanto custa Reddit App API?
O preço é $1 por 1.000 requisições bem-sucedidas. A recarga mínima é $50 por 50.000 créditos. Cada requisição bem-sucedida consome um crédito, mesmo sem correspondências. Requisições inválidas não são cobradas; falhas na origem acionam reembolso que pode exigir conciliação. Um timeout sozinho não define a cobrança final.
Quais filtros posso usar para buscar registros do Reddit?
Use q para busca de texto analisado com subreddit, author, kind, from, to ou min_score. As palavras são combinadas com AND; não é busca semântica nem DSL arbitrário. As datas usam YYYY-MM-DD em UTC, e to inclui o dia final inteiro. Comece com os parâmetros documentados.
O Reddit App API oferece acesso ao Reddit em tempo real?
Não. O serviço consulta um arquivo histórico, não o feed ao vivo do Reddit. Não publica, vota, envia mensagens privadas nem executa ações do Reddit OAuth. A rota pública /v1/status descreve o escopo do serviço; não comprova a saúde do arquivo, a cobertura completa ou a disponibilidade atual de uma página original.
Posso exportar todos os registros correspondentes?
Não necessariamente. Cada requisição retorna até 100 registros, e page aceita valores de 1 a 100. Leia total com pagination.relation: exato, limite inferior ou desconhecido. A ordem é a do arquivo, sem garantia cronológica ou de relevância. Chegar à última página acessível não comprova que a amostra seja exaustiva.
Posso reutilizar a mesma chave em outro domínio?
Não. Contas, chaves API e saldos são separados por site. Use a chave emitida para este domínio com seu próprio host API HTTPS. Mantenha-a na configuração do servidor, nunca em JavaScript do navegador, repositórios públicos ou logs compartilhados. A chave de outro site não substitui uma conta local.
Qual requisição devo testar primeiro?
Comece com /v1/search, q=search, subreddit=SideProject, limit=3 e page=1. Essa consulta pequena permite examinar os campos antes de desenvolver uma importação ou interface. Se for bem-sucedida, custa um crédito mesmo com resultado vazio. Ajuste tema e comunidade à tarefa: o exemplo não promete uma quantidade fixa de registros.
API / Reddit App API
Obter chave API Monte a primeira requisição
Crie uma conta, guarde a chave e adapte o exemplo à sua tarefa.
Continue com um guia
Inclua uma pausa para leitura no planejamento da viagemNão deixe uma lista vazia explicar todos os resultadosQuem caminha precisa de uma busca, não da sua chaveMostrar mais deve significar uma próxima página deliberadaOrce o que o aplicativo solicita, não o que o leitor vêUma data deve explicar a evidência, não enfeitar o cartãoFaça cada cartão explicar o registro recebidoSalve uma referência sem prometer que ela ficará disponívelCrie a funcionalidadeGuias
