Reddit

Visão geral

Reddit é uma plataforma de notícias sociais com comunidades (subreddits) alimentadas por usuários, que oferece compartilhamento de conteúdo, discussões e oportunidades de marketing viral para marcas. Com a integração Reddit no SquadOS, seus agentes podem criar posts, comentar, pesquisar subreddits, recuperar conteúdo e interagir com comunidades diretamente, sem intervenção manual.

• Site oficial: https://www.reddit.com/
• Documentação na Composio: docs.composio.dev/toolkits/reddit

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Campo	Obrigatório	Descrição
—	—	Sem credenciais manuais. A autenticação é feita por OAuth 2.0 via página segura da Composio.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Reddit.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso à sua conta Reddit (OAuth 2.0).
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Criar um post no Reddit

REDDIT_CREATE_REDDIT_POST

Cria um novo post de texto ou link em um subreddit existente especificado, aplicando opcionalmente um flair. Publica imediatamente conteúdo visível publicamente — confirme o subreddit, o título e o corpo com o usuário antes de executar. Posts podem ser removidos silenciosamente após o envio pelo automoderador ou pelas regras do subreddit (erros: SUBMIT_VALIDATION_BODY_BLACKLISTED_STRING, POST_GUIDANCE_VALIDATION_FAILED); verifique a visibilidade pelo permalink retornado. Chamadas consecutivas rápidas disparam erros RATELIMIT com dicas de tempo de espera.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Não	A URL para um post do tipo ‘link’. Obrigatório se kind for ‘link’.
kind	string (“link” | “self”)	Não	O tipo do post. Use ‘self’ para um post de texto (quando fornecer ‘text’) ou ‘link’ para um post que linka para uma URL externa (quando fornecer ‘url’). Se omitido, é inferido automaticamente: ‘self’ quando ‘text’ é fornecido, ‘link’ quando ‘url’ é fornecido.
text	string	Não	O conteúdo de texto formatado em Markdown para um post ‘self’. Obrigatório se kind for ‘self’. O corpo não pode exceder ~40.000 caracteres.
title	string	Sim	O título do post. Deve ter no máximo 300 caracteres.
flair_id	string	Não	ID do template de flair do post (formato UUID). Deve ser um ID de template de flair válido que exista para este subreddit específico. Para obter IDs de flair válidos, use primeiro a ação LIST_SUBREDDIT_POST_FLAIRS para o subreddit alvo. Não passe strings genéricas como ‘general’ ou ‘news’ — esses não são IDs de flair universais. Alguns subreddits exigem flair obrigatório; omitir ou fornecer um ID inválido retorna SUBMIT_VALIDATION_FLAIR_REQUIRED.
subreddit	string	Sim	O nome do subreddit (sem o prefixo ‘r/’) onde o post será enviado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Deletar comentário no Reddit

REDDIT_DELETE_REDDIT_COMMENT

Deleta um comentário no Reddit, identificado pelo seu ID fullname, se foi criado pelo usuário autenticado. A exclusão é permanente e irreversível.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	O ‘thing ID’ completo (fullname, ex.: ‘t1_c0s4w1c’) do comentário a deletar; geralmente começa com ‘t1_’.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Deletar um post no Reddit

REDDIT_DELETE_REDDIT_POST

Deleta permanente e irreversivelmente um post no Reddit pelo seu ID. Confirme com o usuário antes de chamar. Funciona apenas em posts criados pela conta autenticada; tentar deletar o post de outro usuário falhará.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	O nome completo (fullname) do post no Reddit a ser deletado. Este ID deve começar com ‘t3_’ seguido do identificador único base36 do post.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Editar comentário ou post

REDDIT_EDIT_REDDIT_COMMENT_OR_POST

Edita o texto do corpo de um comentário ou self-post existente do usuário autenticado no Reddit; não é possível editar link posts ou títulos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
text	string	Sim	O novo texto Markdown bruto para o corpo do comentário ou self-post.
thing_id	string	Sim	O nome completo (fullname) do comentário ou self-post a editar. É a combinação de um prefixo (ex.: ‘t1_’ para comentário, ‘t3_’ para post) com o ID do item.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter listagem do Reddit por ordenação

REDDIT_GET

Recupera uma listagem de posts do Reddit ordenados pelo critério especificado (hot, new, top, etc.). Use quando precisar obter posts da página inicial do Reddit ou de todo o Reddit com uma ordem de classificação específica. Suporta paginação e filtro por tempo para as classificações top/controversial.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
show	string	Não	A string ‘all’ para mostrar todos os posts, incluindo os filtrados.
sort	string	Sim	O método de ordenação dos resultados. Valores válidos: hot, new, top, rising, controversial, best. Nota: ‘random’ NÃO é suportado aqui — use a ação GET_RANDOM.
after	string	Não	Fullname de um item para paginação (carrega posts após este item).
count	integer	Não	Um inteiro positivo representando o número de itens já vistos (padrão: 0).
limit	integer	Não	O número máximo de itens desejados (padrão: 25, máximo: 100).
before	string	Não	Fullname de um item para paginação (carrega posts antes deste item).
time_filter	string	Não	Filtro de tempo para as ordenações ‘top’ e ‘controversial’. Valores válidos: hour, day, week, month, year, all.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter posts controversos de todos os subreddits

REDDIT_GET_CONTROVERSIAL_POSTS

Recupera posts controversos de todos os subreddits com filtros de tempo. Use quando precisar encontrar os posts mais controversos do Reddit em um período específico (hora, dia, semana, mês, ano ou todos os tempos). Retorna uma listagem paginada de posts classificados por controvérsia no período especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
t	string (“hour” | “day” | “week” | “month” | “year” | “all”)	Não	Filtro de tempo para classificar posts controversos. Especifica o período: ‘hour’, ‘day’, ‘week’, ‘month’, ‘year’ ou ‘all’ (padrão).
after	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem após este fullname na listagem.
limit	integer	Não	Número máximo de posts controversos a retornar. O padrão é 25, o máximo é 100.
before	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem antes deste fullname na listagem.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter preferências do usuário

REDDIT_GET_ME_PREFS

Recupera as configurações de preferências do usuário autenticado. Use quando precisar verificar preferências ou configurações do usuário.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
fields	string	Não	Uma lista separada por vírgulas de campos de preferência a retornar. Se não especificado, todos os campos de preferência são retornados. Campos suportados incluem: threaded_messages, hide_downs, hide_ups, activity_relevant_ads, nightmode, compress, beta, media, media_preview, label_nsfw, over_18, search_include_over_18, hide_ads, email_messages, email_digests, monitor_mentions, hide_from_robots, profile_opt_out, public_votes, lang, theme_selector, min_comment_score, min_link_score, accept_pms, show_link_flair, show_trending, private_feeds, research, ignore_suggested_sort, domain_details, legacy_search, live_orangereds, highlight_controversial, no_profanity, email_unsubscribe_all, in_redesign_beta, allow_clicktracking, show_twitter, store_visits, threaded_modmail, enable_default_themes, geopopular, show_stylesheets, show_promote, organic, collapse_read_messages, show_flair, mark_messages_read, top_karma_subreddits, newwindow, video_autoplay, credit_autorenew, clickgadget, use_global_defaults, other_theme, num_comments, numsites e g.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter posts novos do subreddit (Descontinuado)

REDDIT_GET_NEW

DESCONTINUADO: Use RetrieveRedditPost. Recupera os posts mais recentes de um subreddit ordenados por tempo de criação. Use quando precisar encontrar os posts mais recentemente enviados para descobrir conteúdo novo. Retorna uma listagem paginada de posts classificados do mais novo ao mais antigo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
after	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem após este fullname na listagem.
count	integer	Não	Usado pelo Reddit para numerar listagens após a primeira página para paginação. Representa o número de itens já vistos.
limit	integer	Não	Número máximo de posts novos a retornar. O padrão é 25, o máximo é 100.
before	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem antes deste fullname na listagem.
subreddit	string	Sim	Nome do subreddit (sem o prefixo ‘r/’). Deve conter apenas letras, números e underscores. Sem espaços ou caracteres especiais. Insensível a maiúsculas/minúsculas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter post aleatório do Reddit

REDDIT_GET_RANDOM

Recupera um post público aleatório do Reddit de qualquer subreddit. Use quando quiser descobrir conteúdo de forma aleatória ou precisar de um post aleatório para testes ou entretenimento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
subreddit	string	Não	Nome do subreddit do qual obter um post aleatório. Se não especificado, retorna um post aleatório de todo o Reddit. Não inclua o prefixo ‘r/’.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter informações do usuário

REDDIT_GET_REDDIT_USER_ABOUT

Recupera informações sobre uma conta de usuário do Reddit especificada, incluindo pontuações de karma e status gold. Use quando precisar obter informações de perfil de qualquer usuário público do Reddit.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
username	string	Sim	O nome de um usuário existente do Reddit para obter informações. Não inclua o prefixo ‘u/’. Use ‘me’ para obter informações sobre o usuário atualmente autenticado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter posts mais votados do subreddit

REDDIT_GET_R_TOP

Recupera posts mais votados de um subreddit com filtros de tempo. Use quando precisar encontrar os posts mais populares de um período específico (hora, dia, semana, mês, ano ou todos os tempos). Retorna uma listagem paginada de posts classificados por pontuação no período especificado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
t	string (“hour” | “day” | “week” | “month” | “year” | “all”)	Não	Filtro de tempo para classificar os posts mais votados. Especifica o período: ‘hour’, ‘day’, ‘week’, ‘month’, ‘year’ ou ‘all’ (padrão).
show	string	Não	Opção de filtro de exibição. Use ‘all’ para retornar itens que normalmente seriam omitidos (ex.: posts que você ocultou).
after	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem após este fullname na listagem.
count	integer	Não	Usado pelo Reddit para numerar listagens após a primeira página para paginação. Representa o número de itens já vistos.
limit	integer	Não	Número máximo de posts mais votados a retornar. O padrão é 25, o máximo é 100.
before	string	Não	Fullname de um item para usar como âncora de paginação. Retorna resultados que ocorrem antes deste fullname na listagem.
sr_detail	boolean	Não	Expandir detalhes dos subreddits na resposta. Defina como true para obter informações mais detalhadas do subreddit.
subreddit	string	Sim	Nome do subreddit (sem o prefixo ‘r/’). Deve conter apenas letras, números e underscores. Sem espaços ou caracteres especiais. Insensível a maiúsculas/minúsculas.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter escopos OAuth

REDDIT_GET_SCOPES

Recupera todos os escopos OAuth disponíveis suportados pela API do Reddit. Use quando precisar entender quais permissões estão disponíveis ou verificar definições de escopo.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter regras do subreddit

REDDIT_GET_SUBREDDIT_RULES

Busca as regras explícitas de postagem de um subreddit para garantir conformidade antes de postar ou comentar. Use quando precisar verificar se o conteúdo atende às diretrizes da comunidade ou explicar os requisitos do subreddit aos usuários.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
raw_json	boolean	Não	Se verdadeiro, evita a codificação HTML de caracteres especiais nas descrições das regras. Recomendado definir como verdadeiro para saída de texto mais limpa.
subreddit	string	Sim	Nome do subreddit (sem o prefixo ‘r/’) para o qual recuperar as regras de postagem.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar subreddits

REDDIT_GET_SUBREDDITS_SEARCH

Pesquisa subreddits por título e descrição. Use quando precisar encontrar subreddits que correspondam a um tópico ou palavra-chave específica. Retorna uma listagem paginada de subreddits com seus detalhes, incluindo assinantes, descrições e outros metadados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Sim	Um termo de busca para pesquisar títulos e descrições de subreddits. Use palavras-chave específicas para encontrar subreddits relevantes.
show	string	Não	A string ‘all’ para mostrar todos os subreddits, incluindo os que o usuário pode ter filtrado.
sort	string (“relevance” | “activity”)	Não	Ordem de classificação dos resultados da busca. ‘relevance’ classifica por relevância à consulta (padrão). ‘activity’ classifica pela atividade do subreddit.
after	string	Não	Fullname de um item — cursor de paginação para a próxima página. Use o valor ‘after’ da resposta anterior para obter o próximo conjunto de resultados.
count	integer	Não	Um inteiro positivo (padrão: 0) representando o número de itens já vistos em páginas anteriores. Usado para rastreamento de paginação.
limit	integer	Não	O número máximo de subreddits a retornar. O padrão é 25. O valor máximo permitido é 100.
before	string	Não	Fullname de um item — cursor de paginação para a página anterior. Use o valor ‘before’ da resposta anterior para obter os resultados anteriores.
sr_detail	boolean	Não	Expandir subreddits com detalhes adicionais. Defina como true para obter informações mais detalhadas sobre cada subreddit.
show_users	boolean	Não	Valor booleano para incluir resultados de usuários na pesquisa. Defina como true para incluir usuários que correspondam à consulta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter flair do usuário

REDDIT_GET_USER_FLAIR

Busca a lista de atribuições de flair de usuário para um determinado subreddit. Retorna resultados paginados com detalhes de flair de usuário. Os valores de flair_id retornados são específicos do subreddit e não devem ser reutilizados em subreddits diferentes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
after	string	Não	ID de usuário para usar como âncora para buscar a próxima página de resultados. Use o valor ‘next’ de uma resposta anterior.
limit	integer	Não	Número máximo de entradas de flair de usuário a retornar por página. O padrão do Reddit é 25, o máximo é 1000.
before	string	Não	ID de usuário para usar como âncora para buscar a página anterior de resultados. Use o valor ‘prev’ de uma resposta anterior.
subreddit	string	Sim	Nome do subreddit (ex.: ‘pics’, ‘gaming’) para o qual recuperar atribuições de flair de usuário. Não inclua o prefixo ‘r/’ nem caminhos de URL — apenas o nome simples.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Verificar disponibilidade de nome de usuário

REDDIT_GET_USERNAME_AVAILABLE

Verifica se um nome de usuário está disponível para registro no Reddit. Use quando precisar confirmar se um nome de usuário pode ser usado para criar uma nova conta.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
user	string	Sim	O nome de usuário a verificar a disponibilidade. Deve ser uma string de nome de usuário válida e não utilizada. Nomes de usuário são insensíveis a maiúsculas/minúsculas e devem ter entre 3 e 20 caracteres.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar flairs de post do subreddit

REDDIT_LIST_SUBREDDIT_POST_FLAIRS

Lista os flairs de link/post disponíveis para um subreddit (incluindo flair_template_id) para que os posts possam satisfazer a validação de flair obrigatório. Use quando precisar descobrir IDs de flair válidos antes de criar um post em um subreddit que exige flair. Nota: o Reddit pode retornar vazio ou negar o acesso se o usuário autenticado não puder definir flair de link e não for moderador.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
subreddit	string	Sim	O nome do subreddit (sem o prefixo ‘r/’) para o qual recuperar os flairs de post/link disponíveis.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Publicar um comentário

REDDIT_POST_REDDIT_COMMENT

Publica um comentário no Reddit, respondendo a uma submissão (post) existente ou a outro comentário. Falha se o thread alvo estiver bloqueado, arquivado ou restrito — verifique o estado do thread previamente. Chamadas sucessivas rápidas disparam erros RATELIMIT do Reddit com dicas explícitas de tempo de espera (ex.: ‘take a break for 9 minutes’); respeite a espera especificada antes de tentar novamente. Uma resposta de API bem-sucedida não garante visibilidade pública — o automoderador ou filtros de spam podem remover o comentário silenciosamente. Publica imediatamente e publicamente; confirme o alvo e o texto antes de executar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
text	string	Sim	OBRIGATÓRIO. O texto Markdown bruto do comentário a ser enviado. Este campo deve ser fornecido e não pode estar vazio.
thing_id	string	Sim	OBRIGATÓRIO. O ID do post pai (link) ou comentário, prefixado com ‘t3_’ para um post (ex.: ‘t3_10omtdx’) ou ‘t1_’ para um comentário (ex.: ‘t1_h2g9w8l’). Este campo deve ser fornecido.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Recuperar comentários de um post

REDDIT_RETRIEVE_POST_COMMENTS

Recupera todos os comentários de um post no Reddit dado o seu ID de artigo base-36. A resposta é um array de duas listagens: metadados do post em listings[0]; comentários em listings[1].data.children com texto em cada [].data.body e respostas aninhadas no campo replies de cada comentário. As respostas requerem percurso recursivo para capturar a discussão completa. Threads grandes, bloqueados ou arquivados podem retornar árvores truncadas ou placeholders more em vez de resultados completos. Filtre comentários onde body é [deleted] ou [removed]; use parent_id para reconstruir o fluxo da conversa. Sem parâmetro de filtro de tempo — compare created_utc com um limite UTC para filtrar por data.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
article	string	Sim	ID base-36 do post no Reddit (ex.: ‘q5u7q5’), geralmente encontrado na URL do post e sem o prefixo ‘t3_’.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Recuperar posts do subreddit

REDDIT_RETRIEVE_REDDIT_POST

Recupera posts de um subreddit público e acessível especificado. As respostas aninham os dados dos posts em data.children[].data; inspecione a estrutura antes de analisar. A paginação usa um cursor data.after; desduplicar entre páginas pelo id do post. Sem filtro de data incorporado; compare created_utc (segundos Unix, UTC) no lado do cliente. Taxa de limite: ~1–2 requisições/segundo; recue em HTTP 429.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
sort	string (“hot” | “new” | “top” | “rising” | “controversial”)	Não	Ordem de classificação dos posts. Opções: ‘hot’ (padrão, posts mais ativos), ‘new’ (mais recentes primeiro), ‘top’ (maior pontuação), ‘rising’ (posts em alta), ‘controversial’ (mais controversos).
subreddit	string	Sim	O nome do subreddit do qual recuperar posts (ex.: ‘popular’, ‘pics’). Não inclua ‘r/’. Os nomes de subreddit devem ter entre 3 e 21 caracteres e podem conter apenas letras, números e underscores.
max_results	integer	Não	O número máximo de posts a retornar. O padrão é 5. Defina como 0 para recuperar o máximo permitido pela API do Reddit (100 posts). Intervalo válido: 0–100.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Recuperar comentário ou post específico

REDDIT_RETRIEVE_SPECIFIC_COMMENT

Recupera informações detalhadas de um único comentário ou post no Reddit usando seu fullname. Retorna apenas o item especificado, não o contexto do thread ao redor; use REDDIT_RETRIEVE_POST_COMMENTS para recuperação de discussão completa. Itens deletados, removidos ou em quarentena podem retornar payloads vazios ou parciais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador fullname do Reddit. Formato: prefixo de tipo (t1_ para comentários, t3_ para posts) seguido de um ID base36. Exemplos: ‘t1_abc123’, ‘t3_1abc2de’. Nota: tokens de URL de compartilhamento de reddit.com/r/…/s/… NÃO são fullnames válidos e não podem ser usados diretamente. Nota: REDDIT_RETRIEVE_POST_COMMENTS espera o ID base-36 sem o prefixo t3_, ao contrário desta ferramenta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisar em todos os subreddits

REDDIT_SEARCH_ACROSS_SUBREDDITS

Pesquisa posts e comentários no Reddit usando uma consulta. Resultados aninhados em data.children[i].data (kind t3 para posts); um array posts também pode aparecer — inspecione o caminho real da resposta. Sem filtro de intervalo de tempo nativo; compare created_utc (época Unix, UTC) no lado do cliente para filtragem por recência. children vazio é um resultado válido de nenhum resultado encontrado. Campos principais do post: score, num_comments, created_utc, permalink. Taxa de limite: ~1–2 requisições/seg; HTTP 429 indica limitação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
sort	string (“relevance” | “hot” | “new” | “top” | “comments”)	Não	O critério para ordenar os resultados da pesquisa. ‘relevance’ (padrão) classifica por relevância à consulta. ‘hot’ classifica por posts em alta com upvotes e atividade recentes. ‘new’ classifica pelo mais recente primeiro. ‘top’ classifica pela maior pontuação (tipicamente de todos os tempos). ‘comments’ classifica pelo número de comentários.
after	string	Não	Cursor de paginação para buscar a próxima página de resultados. Use o valor after da resposta anterior para obter resultados subsequentes.
limit	integer	Não	O número máximo de resultados de pesquisa a retornar. O padrão é 5. O valor máximo permitido é 100. Pagine além da primeira página usando o cursor after de data.after na resposta; desduplicar resultados entre páginas pelo id do post.
before	string	Não	Cursor de paginação para buscar a página anterior de resultados. Use o valor before da resposta anterior para obter resultados anteriores.
restrict_sr	boolean	Não	Se verdadeiro (padrão), restringe a pesquisa a posts e comentários dentro de subreddits. Se falso, o escopo da pesquisa é mais amplo e pode incluir nomes de subreddits correspondentes ou outras entidades do Reddit.
search_query	string	Sim	A string de consulta de pesquisa. Suporta operadores de pesquisa do Reddit: ‘title:’, ‘author:’, ‘subreddit:’, ‘url:’, ‘site:’, ‘flair:’, ‘self:yes/no’, ‘nsfw:yes/no’, e operadores booleanos (AND, OR, NOT). URLs brutas (começando com http:// ou https://) não são permitidas — use os operadores ‘url:’ ou ‘site:’ (ex.: ‘url:example.com’ para encontrar posts que linkam para aquele domínio).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Ativar ou desativar respostas na caixa de entrada

REDDIT_TOGGLE_INBOX_REPLIES

Ativa ou desativa as respostas na caixa de entrada para uma submissão ou comentário. Use quando quiser controlar se você recebe notificações na caixa de entrada por respostas aos seus próprios posts ou comentários.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	O fullname de um item criado pelo usuário. Deve ser prefixado com o tipo do item (ex.: ‘t3_’ para uma submissão/post, ‘t1_’ para um comentário). Exemplo: ‘t3_abc123’ para um post.
state	boolean	Sim	Valor booleano para ativar ou desativar as respostas na caixa de entrada. Defina como true para habilitar o recebimento de notificações quando usuários responderem a este item, ou false para desabilitar as notificações.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.