Limites de taxa da API do Reddit: 100 consultas por minuto, com média de dez

O que é o limite de taxa da API do Reddit?

A Data API do Reddit aplica limites de taxa da API do Reddit de 100 consultas por minuto por client id do OAuth, com média sobre uma janela móvel de dez minutos, segundo o Reddit Data API Wiki. A média é o que molda o seu projeto: o Reddit mede a média ao longo de dez minutos em vez de cada minuto isolado, então o seu orçamento real é de 1.000 consultas por janela e 6.000 por hora, e você pode passar de 100 em um minuto solto desde que a média da janela se mantenha. Dimensione o seu loop de polling pela janela, não pelo número de destaque de 100 por minuto.

Limite	Valor	Onde o Reddit informa
Consultas autenticadas	100 consultas por minuto (QPM) por client id do OAuth	Reddit Data API Wiki
Janela de média	Atualmente 10 minutos, para permitir picos	Reddit Data API Wiki
Orçamento efetivo por janela	1.000 consultas a cada 10 minutos móveis	Derivado das duas linhas acima
Tráfego não autenticado	Bloqueado por completo; o limite de taxa padrão não se aplica	Reddit Data API Wiki
Mensagens de chat	2.000 por dia por destinatário, 3.000 por dia no total	Reddit Data API Wiki
Salas de chat, contas de bot	Até 300 entradas por dia	Reddit Data API Wiki
Número publicado antigo	60 requisições por minuto para clientes OAuth2	wiki reddit-archive no GitHub

Última verificação: 8 de setembro de 2026

Qual número vale hoje, 60 ou 100?

O número atual é 100 QPM, e o 60 vem de uma documentação que o próprio Reddit marca como legada. O wiki arquivado da API no GitHub do Reddit ainda diz "Clients connecting via OAuth2 may make up to 60 requests per minute" (clientes que se conectam via OAuth2 podem fazer até 60 requisições por minuto) e não traz carimbo de versão, por isso ele volta a aparecer sem parar em respostas do Stack Overflow. O Data API Wiki hospedado no suporte, que abre com o aviso do Reddit de que a documentação legada da API "may be out of date" (pode estar desatualizada), é a página que declara 100 QPM e a média de dez minutos. Construa contra 100 QPM e date como anterior a 2023 qualquer fonte que cite 60.

As regras de acesso mudaram no mesmo período. Os Data API Terms do Reddit trazem data de vigência 19 de junho de 2023 e última revisão 20 de julho de 2026, então qualquer coisa anterior a meados de 2023 descreve outro produto. Leia quanto custa o acesso à Data API quando a elegibilidade gratuita acaba junto com estes limites.

Como ler os cabeçalhos de resposta X-Ratelimit?

O Reddit informa o seu orçamento restante em cada resposta da Data API por meio de três cabeçalhos. O Data API Wiki os define exatamente assim.

Cabeçalho	O que o Reddit diz que ele informa
X-Ratelimit-Used	Approximate number of requests used in this period (número aproximado de requisições usadas neste período)
X-Ratelimit-Remaining	Approximate number of requests left to use (número aproximado de requisições ainda disponíveis)
X-Ratelimit-Reset	Approximate number of seconds to end of period (número aproximado de segundos até o fim do período)

Dois detalhes mordem. O Reddit chama os três valores de aproximados, então um cliente que gasta até X-Ratelimit-Remaining: 0 acumula erros em vez de parar de forma limpa. O HTTP/2 também deixa os nomes de cabeçalho em minúsculas no tráfego, então o seu cliente vê x-ratelimit-remaining enquanto a documentação escreve com iniciais maiúsculas; compare sem diferenciar maiúsculas. Registre os três e dispare alerta quando a contagem restante cair abaixo de um piso escolhido por você. O PRAW respeita esses cabeçalhos automaticamente e espaça as requisições de acordo.

O que acontece quando o Reddit retorna 429?

O Reddit responde HTTP 429 Too Many Requests assim que você ultrapassa a média da janela, e a resposta pode trazer um cabeçalho retry-after indicando a espera. A implementação de referência é o prawcore, a camada HTTP sob o PRAW: o sessions.py dele mapeia too_many_requests para uma exceção TooManyRequests que lê retry-after da resposta. Vale notar: 429 não está no conjunto RETRY_STATUSES do prawcore, que guarda 500, 502, 503, 504, 408, 520 e 522, então o PRAW lança erro em 429 em vez de repetir a chamada em silêncio.

Copie essa escolha. Um erro de servidor merece nova tentativa porque a requisição era válida, mas um 429 Too Many Requests significa que o seu agendador está errado, e enterrá-lo em um loop de retentativa esconde o defeito enquanto queima cota. Deixe o 429 aparecer e conserte o agendamento.

Quantas keywords um client id do OAuth consegue monitorar por hora?

Divida o orçamento por hora pelo custo de cada keyword e um monitor restrito a subreddits para na casa das dezenas. A aritmética cabe em uma linha:

Queries per hour = keywords x subreddits x (60 / poll interval in minutes) x pages per poll

Acompanhe uma keyword em 12 subreddits, faça polling a cada 5 minutos e puxe uma página por consulta:

1 x 12 x (60 / 5) x 1 = 144 queries per hour per keyword

Seu teto é 100 QPM x 60 minutos = 6.000 consultas por hora, então 6.000 / 144 = 41,6, ou seja, 41 keywords sem margem alguma. Puxe duas páginas por consulta e o custo dobra para 288 por keyword por hora, o que derruba você para 20 keywords. Reserve 20 por cento para renovações de token e retentativas e o teto de uma página vira 4.800 / 144 = 33 keywords.

Os picos são limitados à parte. Cada dez minutos móveis comportam 1.000 consultas, então um backfill que dispara 900 requisições no primeiro minuto deixa 100 para os nove seguintes. Rode o monitoramento contínuo e os backfills sob client ids do OAuth separados. Essa conta decide se você vai construir sobre a API crua, e é a mesma por trás de RedReplier ao lado de rodar a API do Reddit por conta própria.

Teto de keywords por client id do OAuth

Uma página por consulta41 keywords

Duas páginas por consulta20 keywords

Uma página, com 20% de margem reservada33 keywords

Como fica o backoff exponencial diante de uma média de dez minutos?

Backoff aqui significa dobrar a espera depois de cada falha e somar jitter aleatório para que uma frota de workers não tente de novo em uníssono. Um cronograma que cabe na janela de dez minutos: esperar 1, 2, 4, 8 e 16 segundos ao longo de cinco tentativas, somar até 1 segundo de jitter a cada uma, limitar qualquer espera a 60 segundos e abandonar a requisição depois da quinta. Quando o Reddit envia retry-after, use esse valor no lugar do que você calculou.

A estratégia do próprio prawcore é menor de propósito: FiniteRetryStrategy define DEFAULT_RETRIES = 2 e dorme 2 * random() segundos antes da primeira retentativa e 2 + 2 * random() antes da última. Copie o jitter e a parada dura, porque retentativas sem limite contra uma janela com média cavam o buraco mais fundo: cada retentativa conta para a mesma média de dez minutos que gerou o 429. Se o seu sistema precisa de backoff exponencial para ficar dentro do orçamento, o defeito está no cronograma, e escolher entre polling e webhooks é a conversa mais útil.

O que separa o nível gratuito da Data API do licenciamento comercial?

A linha divisória é o que você faz com os dados, não quantas consultas você envia. O artigo da central de ajuda do Reddit sobre acessar dados do Reddit define fins comerciais como "any use of our services by a business or on behalf of a business or as part of a monetized product or service" (qualquer uso dos nossos serviços por uma empresa ou em nome de uma empresa ou como parte de um produto ou serviço monetizado), e lista entre os exemplos serviços por assinatura, aplicativos com paywall e acesso a dados mediante cobrança. A seção 3.1 dos Data API Terms coloca isso em linguagem contratual: fins comerciais, uso acima dos limites de taxa ou qualquer coisa não permitida expressamente "will need to enter into a separate agreement with Reddit." (precisarão firmar um acordo separado com o Reddit).

Ou seja, um produto monetizado que envia 10 consultas por minuto precisa de contrato mesmo sem nunca chegar perto do teto. O trabalho acadêmico agora passa exclusivamente pelo programa Reddit for Researchers, e a Responsible Builder Policy do Reddit afirma que pesquisa sobre dados coletados fora dele viola a política, com punições que chegam a tokens revogados e contas suspensas. Defina de que lado da linha você está antes de escrever o cliente.

Todos os números acima valem porque o client id do OAuth é seu. O RedReplier monitora o Reddit ao lado de X, Bluesky, Facebook e Hacker News em um só lugar, então a cobertura vira uma configuração de plano em vez de uma conta de consultas por hora. Ele também expõe uma API e um servidor MCP que funciona com Claude Code, Cursor e qualquer cliente MCP padrão.

Perguntas frequentes

O limite de 100 QPM vale por usuário ou por aplicativo?

Por client id do OAuth, segundo o Data API Wiki do Reddit. Cada usuário que o seu aplicativo autentica bebe do mesmo pool de 100 QPM ligado a esse client id, então uma ferramenta multi-inquilino não ganha folga adicionando usuários. Registrar client ids separados para aplicações de fato separadas é o caminho suportado para dividir orçamentos.

O que acontece com requisições que pulam o OAuth por completo?

O Reddit bloqueia. O Data API Wiki afirma que tráfego sem OAuth ou credenciais de login será bloqueado e que o limite de taxa padrão não se aplica, e a seção Rules acrescenta que o Reddit pode "freely throttle or block unidentified Data API users." (limitar ou bloquear livremente usuários não identificados da Data API). Não existe cota não autenticada para você planejar em cima.

Os cabeçalhos X-Ratelimit mostram o minuto ou a janela de dez minutos?

Eles informam o período atual, que é a janela de média de dez minutos. X-Ratelimit-Reset faz a contagem regressiva dos segundos até o fim desse período, então um valor perto de 600 quer dizer que a janela acabou de abrir e um valor perto de 0 quer dizer que a sua cota está prestes a renovar. O Reddit rotula os três como aproximados, então deixe margem em vez de gastar até zero.

O Reddit sempre envia um cabeçalho Retry-After no 429?

Não. A exceção TooManyRequests do prawcore lê o cabeçalho com response.headers.get("retry-after") e só imprime uma instrução de espera quando ele está presente, então o seu código precisa tratar a ausência dele. Use retry-after quando ele chegar e recorra ao seu próprio cronograma de backoff quando não chegar.

É obrigatório usar uma string de User-Agent?

Sim, e o formato é prescrito. O Data API Wiki do Reddit exige <platform>:<app ID>:<version string> (by /u/<reddit username>) e observa que padrões como "Python/urllib" ou "Java" são "drastically limited." (drasticamente limitados). Ele também avisa: "NEVER lie about your User-Agent." (NUNCA minta sobre o seu User-Agent).

Dá para aumentar o limite sem contrato comercial?

Bots de moderação têm um caminho documentado: o Data API Wiki do Reddit convida operadores de mod bots que precisam passar dos limites a procurar a empresa pelo formulário de contato. A central de ajuda do Reddit acrescenta que desenvolvedores selecionados com necessidade de acesso mais amplo podem ser cobrados para levantar os limites padrão. Para qualquer coisa monetizada, o caminho é o acordo separado da seção 3.1 dos Data API Terms.

O limite de 100 QPM também vale para as mensagens do chat do Reddit?

O chat opera sob limites próprios, separados do limite de 100 QPM para consultas: 2.000 mensagens por dia por destinatário e 3.000 por dia no total, segundo a Data API Wiki. Contas bot podem entrar em até 300 salas de chat por dia. Nenhum desses números consome a mesma janela móvel de dez minutos usada pelas suas consultas normais.

Como o Reddit trata o 429 de forma diferente de um erro de servidor?

O conjunto RETRY_STATUSES do prawcore cobre 500, 502, 503, 504, 408, 520 e 522, os códigos em que a requisição era válida e o servidor falhou, então o PRAW repete essas automaticamente. O 429 fica de fora desse conjunto de propósito. O prawcore lança uma exceção TooManyRequests em vez disso, porque um erro de limite de taxa indica que o agendamento está errado, não o servidor.

O que acontece com pesquisas acadêmicas que ignoram o programa Reddit for Researchers?

A Responsible Builder Policy do Reddit trata como violação dados coletados fora do programa Reddit for Researchers. A aplicação chega a tokens revogados e contas suspensas. Projetos acadêmicos devem passar pelo programa em vez de puxar dados com um client id de OAuth genérico.

Por que um backfill precisa de um client id de OAuth separado do monitoramento contínuo?

Cada janela móvel de dez minutos comporta 1.000 consultas no total, e um backfill que dispara 900 requisições no primeiro minuto deixa só 100 para os nove restantes. Se esse backfill rodar com o mesmo client id do monitoramento contínuo, o monitoramento fica sem cota pelo resto da janela. Client ids separados dão a cada tarefa seu próprio orçamento de 1.000 consultas.