Apenas oito operadores de busca do Reddit são documentados oficialmente

Quais são os operadores de busca do Reddit?

A lista completa de operadores de busca do Reddit que o próprio Reddit documenta chega a oito campos: author, flair, self, selftext, site, subreddit, title e url. O Reddit os publica em um único artigo da central de ajuda, "Available search features", e ali os chama de "manual filtering words" em vez de operadores. Digite-os na barra de busca ao lado dos seus termos, sem espaço entre o nome do campo e o valor.

Operador	O que ele encontra	Exemplo do próprio Reddit
author	O usuário que enviou o post	author:reddit
flair	O texto do flair de link no post	flair:cats
self	Somente posts de texto, definido como true ou false	self:true
selftext	O corpo do post	selftext:cats
site	O domínio da URL enviada	site:example.com
subreddit	O subreddit do envio	subreddit:cats
title	O título do envio	title:cats
url	A URL do envio	url:cats

O artigo do Reddit é direto sobre a regra do espaço e mostra os dois lados dela: author:cats funciona, author: cats não. Os campos se empilham, então cats subreddit:pics site:imgur.com é uma consulta válida. Um valor com espaço dentro precisa ficar entre aspas, como em title:"kitten gif", e o Reddit aceita aspas simples ou duplas.

Quais operadores de busca do Reddit só aparecem em posts da comunidade?

Operadores como timestamp, nsfw, ups, is_self, over18 e distinguished circulam muito nos tópicos do r/help, em páginas antigas de wiki e em guias de terceiros, e o Reddit não documenta nenhum deles. São sobras do cloudsearch, o backend de consultas que o Reddit rodava atrás de um parâmetro syntax=cloudsearch anos atrás. A central de ajuda atual do Reddit nunca os nomeia, e a referência da API tampouco.

Essa ausência dá para conferir, em vez de ser questão de opinião. A seção Search da central de ajuda do Reddit tem seis artigos, e só "Available search features" lista operadores de campo. A referência da API em reddit.com/dev/api documenta GET [/r/subreddit]/search com os parâmetros q, sort, t, type, restrict_sr, limit, count, category, include_facets, before, after, show e sr_detail. Não existe parâmetro syntax nessa lista, e as strings "cloudsearch" e "timestamp" não aparecem em lugar nenhum da página.

Então a divisão honesta fica assim.

Operador	Documentado pelo Reddit	De onde vem
author, flair, self, selftext, site, subreddit, title, url	Sim, na central de ajuda	O artigo "Available search features" do Reddit
AND, OR, NOT, ( )	Sim, na central de ajuda	O mesmo artigo, seção booleana
timestamp, nsfw, ups, is_self, over18, distinguished	Não	Sintaxe da era cloudsearch, mantida viva em posts da comunidade
-term como prefixo de negação	Não	Emprestado do Google, repetido em guias do Reddit

Uma ressalva sobre testar. O Reddit hoje serve um muro de cadastro a visitantes deslogados em reddit.com/search, e o endpoint JSON devolve 403 a clientes não autenticados, então os operadores não documentados não podem ser exercitados de fora de uma conta. O que dá para estabelecer de fora é de que lado da linha da documentação cada um está, e um operador que o Reddit não documenta é um operador que o Reddit pode aposentar sem avisar você.

Como AND, OR e NOT funcionam no Reddit?

O Reddit aceita AND, OR e NOT como operadores booleanos, e a central de ajuda afirma que eles são sensíveis a maiúsculas e minúsculas. Um and minúsculo é tratado como palavra de busca, não como lógica. Os parênteses agrupam partes de uma consulta, e o Reddit usa o próprio exemplo para mostrar por que você precisa deles: hedgehog NOT sonic OR shadow devolve resultados bem diferentes de hedgehog NOT (sonic OR shadow).

Essa é toda a gramática booleana. Não há operador de proximidade, nem curinga, nem sintaxe de intervalo por campo, nem filtro de engajamento mínimo. Se você vem do conjunto de operadores do X, a distância é grande: o X entrega limiares de engajamento, filtros geográficos e um filtro de conversa que não têm equivalente no Reddit.

Por que a mesma consulta se comporta de forma diferente em posts e comentários?

O Reddit aplica regras de correspondência diferentes aos três tipos de resultado, e diz isso no mesmo artigo. Para posts, "results only need to include some of your search words, unless you use the special syntax above to force an exact match" (os resultados só precisam incluir algumas das suas palavras de busca, a menos que você use a sintaxe especial acima para forçar uma correspondência exata). Para comentários e usuários, os resultados "must currently include all of your search words" (por ora precisam incluir todas as suas palavras de busca). A mesma consulta de três palavras é, portanto, meio que uma consulta OR sobre posts e uma consulta AND sobre comentários, o que basta para um termo parecer morto em uma aba e movimentado na outra.

O movimento prático é colocar a frase entre aspas quando você quer correspondência exata na busca de posts, e tratar a busca de comentários como já estrita. Os comentários são também onde vive a maior parte do sinal de compra no Reddit, já que a pergunta é feita em um post e as recomendações chegam embaixo dele.

Posts combinam de forma solta, comentários de forma estrita

Busca de posts

• Só algumas palavras de busca precisam bater
• Colocar uma frase entre aspas força uma correspondência exata
• Funciona como um OR entre os termos

Busca de comentários e usuários

• Todas as palavras de busca precisam estar presentes
• Já é estrita por padrão
• Funciona como um AND entre os termos

Que limites o Reddit impõe a uma consulta de busca?

A referência da API do Reddit limita o parâmetro q a 512 caracteres e o limit a 100 resultados por requisição, com 25 como padrão. O parâmetro sort aceita relevance, hot, top, new e comments. O parâmetro t aceita hour, day, week, month, year e all. O parâmetro type recebe uma lista separada por vírgulas de sr, link e user, e category é limitado a cinco caracteres.

Parâmetro	Valor documentado
q	Uma string de no máximo 512 caracteres
limit	Padrão 25, máximo 100
sort	relevance, hot, top, new, comments
t	hour, day, week, month, year, all
type	Lista separada por vírgulas de sr, link, user
restrict_sr	Booleano, restringe a busca a um subreddit

O teto de 512 caracteres é o que morde. Uma consulta de monitoramento que nomeia um produto, três concorrentes e seis palavras negativas cruza esse teto rápido, e a resposta são várias consultas estreitas em vez de uma ampla. A própria interface do Reddit expõe as mesmas ordenações: relevância, hot, top, novo e número de comentários, com um filtro de tempo cobrindo todo o período, o último ano, mês, semana, 24 horas e hora. Resultados de comentários ordenam apenas por relevância, top e novo.

Como transformar operadores em uma consulta de monitoramento?

Comece pelo subreddit, porque ele tira mais ruído por caractere gasto. A mesma frase significa coisas diferentes no r/sysadmin e no r/smallbusiness, e restringir primeiro deixa menos trabalho para o resto da consulta. Achar as comunidades certas é um trabalho à parte, e um buscador de subreddits devolve uma lista de candidatas mais rápido do que navegar.

Depois acrescente a linguagem da intenção em vez da linguagem do produto. Quem pede uma recomendação escreve "any alternative to", "worth switching from", "what do you use for". Essas frases entre aspas e restritas a um punhado de subreddits devolvem uma lista mais curta do que um nome de marca jamais devolverá, que é justamente o ponto. O fluxo completo, incluindo com que frequência refazer a lista de comunidades, está no guia mais longo sobre buscar no Reddit direito.

O teto de tudo isso é que a busca responde a uma pergunta que você faz, e nada diz quando algo novo aparece. Rodar oito consultas na mão toda manhã é como a maioria acaba chegando ao monitoramento contínuo de marca.

Perguntas frequentes

O Reddit aceita curingas na busca?

Não. A central de ajuda do Reddit documenta oito operadores de campo, três operadores booleanos e os parênteses, e um caractere curinga não está entre eles. Buscar market* encontra a string literal em vez de se expandir para marketing e marketer. Escreva as variantes e junte-as com OR.

Posso buscar no Reddit por intervalo de datas?

Não com um operador. O controle de tempo documentado do Reddit é o parâmetro t, que aceita hour, day, week, month, year e all, então a granularidade mais fina que você pode pedir é a última hora e os únicos intervalos são os que terminam hoje. O operador timestamp que circula em posts da comunidade pertence à sintaxe aposentada do cloudsearch e não aparece na central de ajuda nem na referência da API do Reddit.

flair: é o mesmo que clicar em uma tag de flair?

Quase, e o Reddit documenta os dois. flair:cats encontra o texto do flair de link em um post, enquanto tocar em uma tag de flair nos apps de celular leva você aos posts que carregam aquele flair. O texto do flair é definido por comunidade, então uma consulta com flair só faz sentido depois que você restringiu a um subreddit que o usa.

Por que author: não devolve nada de um usuário que eu vejo postando?

Conteúdo removido e apagado sai do índice de busca mesmo que o tópico continue aparecendo, então uma consulta de autor volta magra para uma conta cujos posts foram retirados pelos moderadores. A busca por autor também cobre envios em vez de comentários por padrão, então um redditor que só comenta parece mudo sob author:.

Esses operadores funcionam pela API do Reddit?

Os operadores de campo vão no parâmetro q de GET [/r/subreddit]/search, então valem as mesmas oito strings. O que muda é o envelope: q é limitado a 512 caracteres, limit para em 100, e o acesso tem limite de taxa por cliente. Esses tetos estão descritos na nota sobre os limites de taxa da API do Reddit.

O Google acha tópicos do Reddit que a busca do próprio Reddit perde?

Sim, porque os dois índices são construídos de formas diferentes e o Google rastreia essas URLs há anos. Uma consulta site:reddit.com no Google é a segunda passada certa quando uma consulta do lado do Reddit volta vazia. Repare na colisão: site: no Google significa o domínio da página que você está buscando, enquanto site: no Reddit significa o domínio para o qual um post de link aponta.

Posso usar um sinal de menos para excluir uma palavra na busca do Reddit?

O sinal de menos não faz parte da sintaxe documentada do Reddit. Ele vem do Google e se repete em guias da comunidade, mas o centro de ajuda do Reddit só lista AND, OR, NOT e parênteses como ferramentas booleanas. Use NOT em vez disso se quiser algo que a própria documentação do Reddit sustente.

Por que o Reddit chama essas palavras de palavras de filtragem em vez de operadores?

O artigo do centro de ajuda do Reddit chama os oito campos de palavras de filtragem manual, não operadores, mesmo que a comunidade os chame de operadores em todo lugar. O nome combina com o jeito que o artigo os trata: eles são digitados junto dos seus termos, sem espaço antes do valor, como qualquer outra palavra de busca.

O que foi o cloudsearch e por que ele ainda aparece em guias de busca do Reddit?

Cloudsearch foi o backend de busca que o Reddit rodava anos atrás por trás de um parâmetro syntax=cloudsearch, e ele aceitava campos extras como timestamp, nsfw e ups. O centro de ajuda e a referência de API atuais do Reddit nunca o mencionam, e as strings "cloudsearch" e "timestamp" não aparecem em lugar nenhum da página de referência da API. Esses campos continuam circulando em páginas antigas de wiki e guias de terceiros porque ninguém os removeu quando o backend mudou.

Os resultados de busca do Reddit devem ser ordenados por relevância ou por novos?

Isso depende mais do tipo de resultado do que de preferência pessoal. A busca de posts do Reddit oferece relevância, quentes, melhores, novos e número de comentários como opções de ordenação, além de um filtro de tempo, enquanto os resultados de comentários só ordenam por relevância, melhores e novos. Para uma thread que muda rápido, novos mostra as respostas mais recentes, mas relevância é a escolha padrão melhor para revisar uma consulta ampla, já que os posts já combinam de forma solta.