Reddit Ads

Visão geral

O Reddit Ads é a plataforma de publicidade do Reddit, que permite criar e gerenciar campanhas de anúncios segmentadas por interesses, comunidades, palavras-chave e dados demográficos em uma das maiores redes de discussão do mundo. Com a integração no SquadOS, seus agentes podem criar campanhas, gerenciar grupos de anúncios, configurar audiências personalizadas, gerenciar catálogos de produtos e obter relatórios detalhados de desempenho de forma automatizada.

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

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

Você vai precisar dos seguintes campos:

Consulte a Composio para os campos obrigatórios de conexão.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Reddit Ads.
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 Ads via 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

Nota

Esta integração expõe 83 ações no total. Abaixo estão as principais; a lista completa está na documentação da Composio.

Criar grupo de anúncios

REDDIT_ADS_CREATE_AD_GROUP

Cria um novo grupo de anúncios dentro de uma campanha do Reddit Ads. Use ao configurar grupos de anúncios com estratégias de lance, metas de orçamento e critérios de segmentação específicos. Observe que optimization_goal é obrigatório para objetivos de campanha de conversão, visualizações de vídeo, vendas por catálogo e instalações de aplicativo.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados de configuração do grupo de anúncios, incluindo campaign_id, nome, estratégia de lance, metas de orçamento e configurações de segmentação.
ad_account_id	string	Sim	O ID da conta de anúncios na qual criar o grupo de anúncios.

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.

Criar campanha Reddit Ads

REDDIT_ADS_CREATE_CAMPAIGN

Cria uma nova campanha de anúncios no Reddit para a conta de anúncios especificada. Use ao configurar uma nova campanha com objetivo, orçamento e segmentação. Observação: a criação de campanhas Max não é suportada via API — configure campanhas Max no Ads Manager.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados da campanha contendo nome, status, objetivo e parâmetros opcionais de configuração.
ad_account_id	string	Sim	O ID da conta de anúncios na qual criar a campanha. Deve corresponder ao padrão ^(t2|a2)_.*.

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.

Criar audiência personalizada

REDDIT_ADS_CREATE_CUSTOM_AUDIENCE

Cria uma nova audiência personalizada no Reddit Ads. Use ao configurar uma audiência customizada para campanhas de publicidade segmentada. Limite de taxa: 3.000 requisições por 900 segundos com burst de 500 por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados da audiência personalizada contendo nome e tipo.
ad_account_id	string	Sim	O ID da conta de anúncios pai (formato: a2_xxxxx).

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.

Criar formulário de geração de leads

REDDIT_ADS_CREATE_LEAD_GEN_FORM

Cria um novo formulário de geração de leads no Reddit Ads. Use ao configurar um formulário para coletar informações de usuários como e-mails, nomes, telefones, etc. Limite de taxa: 20 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados do formulário contendo nome, link de privacidade, texto de apresentação e perguntas.
ad_account_id	string	Sim	O ID da conta de anúncios (formato: a2_xxxxx ou t2_xxxxx).

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.

Criar post no Reddit

REDDIT_ADS_CREATE_POST

Cria um novo post no Reddit para um perfil especificado. Use ao criar conteúdo promocional incluindo posts de texto, imagem, vídeo ou carrossel. Limite de taxa: 200 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados do post contendo tipo, título, corpo e parâmetros opcionais de configuração.
profile_id	string	Sim	O ID do perfil para o qual criar o post. Deve corresponder ao padrão ^t2_.*.

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.

Criar catálogo de produtos

REDDIT_ADS_CREATE_PRODUCT_CATALOG

Cria um novo catálogo de produtos. Use ao configurar um catálogo de produtos para o Reddit Ads. Após a criação, finalize o cadastro criando produtos manualmente ou vinculando um feed de produtos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Objeto com os dados do catálogo, contendo nome, idioma, moeda e fontes de eventos opcionais.
business_id	string	Sim	O ID do negócio pai.

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.

Criar feed de produtos

REDDIT_ADS_CREATE_PRODUCT_FEED

Cria um novo feed para um catálogo de produtos. Use ao configurar feeds de produtos para campanhas de vendas por catálogo no Reddit. Cada catálogo pode conter até 2 feeds, mas devem ser de tipos diferentes (REPLACE ou UPDATE).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Objeto com os dados do feed, contendo URL, modo e credenciais de autenticação opcionais.
catalog_id	string	Sim	O ID do catálogo de produtos pai.

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.

Criar conjunto de produtos

REDDIT_ADS_CREATE_PRODUCT_SET

Cria um novo conjunto de produtos em um catálogo de produtos. Use ao definir um subconjunto de produtos de um catálogo usando regras de filtro para publicidade segmentada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Objeto com os dados do conjunto de produtos, contendo nome e regra de filtro.
catalog_id	string	Sim	O ID do catálogo de produtos pai.

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.

Criar audiência salva

REDDIT_ADS_CREATE_SAVED_AUDIENCE

Cria uma audiência salva para uma conta de anúncios do Reddit Ads com critérios de segmentação. Use ao definir e salvar segmentos de audiência para campanhas. Limite de taxa: 200 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Configuração da audiência salva, incluindo nome, tipo e parâmetros de segmentação.
ad_account_id	string	Sim	O ID da conta de anúncios (formato: a2_...).

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.

Excluir audiência personalizada

REDDIT_ADS_DELETE_CUSTOM_AUDIENCE

Exclui permanentemente uma audiência personalizada por ID no Reddit Ads. Esta operação está sujeita a limites de taxa: 3.000 requisições por 900 segundos com burst de 500 por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
audience_id	string	Sim	O ID da audiência personalizada a excluir.

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 conta de anúncios por ID

REDDIT_ADS_GET_AD_ACCOUNT

Recupera detalhes de uma conta de anúncios específica do Reddit por ID. Use ao precisar de informações da conta, incluindo status de aprovação, configurações de atribuição, moeda, comunidades/palavras-chave excluídas e outras configurações. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios a obter. Deve corresponder ao padrão ^(t2|a2)_.*.

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 campanha por ID

REDDIT_ADS_GET_CAMPAIGN

Recupera uma campanha específica do Reddit Ads por ID. Retorna informações completas da campanha, incluindo objetivo, status, orçamento, segmentação e configurações de otimização. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
campaign_id	string	Sim	O ID da campanha a recuperar.

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 grupo de anúncios

REDDIT_ADS_GET_AD_GROUP

Recupera um grupo de anúncios por ID na API do Reddit Ads. Use ao precisar de detalhes sobre um grupo de anúncios específico. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_group_id	string	Sim	O ID do grupo de anúncios a obter.

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.

Gerar relatório de desempenho

REDDIT_ADS_GET_A_REPORT

Gera um relatório de métricas de desempenho de anúncios com base em campos e segmentações especificados. Use ao precisar de análises detalhadas sobre desempenho de anúncios, engajamento, impressões, cliques, gastos e outras métricas. Suporta até 3 segmentações e retorna resultados paginados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Parâmetros do relatório incluindo intervalo de tempo, campos e segmentações opcionais.
page.size	integer	Não	Número de itens retornados por página.
page.token	string	Não	Token da página a recuperar. Usado para paginação.
ad_account_id	string	Sim	O ID da conta de anúncios. Exemplo: a2_imh76hh7e126.

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 membro autenticado

REDDIT_ADS_GET_ME

Recupera informações do membro autenticado na API do Reddit Ads, incluindo nome de usuário, e-mail, nome e telefone. Limite de taxa: 100 requisições por 60 segundos.

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 por ID

REDDIT_ADS_GET_POST

Recupera um post promovido ou orgânico do Reddit por ID. Retorna detalhes do post incluindo tipo, conteúdo, título e metadados. Limite de taxa: 200 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
post_id	string	Sim	O ID do post promovido a obter. Deve corresponder ao padrão ^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.

Listar contas de anúncios por negócio

REDDIT_ADS_LIST_AD_ACCOUNTS_BY_BUSINESS

Lista contas de anúncios vinculadas a um negócio no Reddit Ads. Use ao precisar recuperar contas de anúncios associadas a um ID de negócio específico. Suporta filtragem e paginação. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
business_id	string	Sim	O ID do negócio para listar contas de anúncios.
ids	string	Não	IDs de contas de anúncios a buscar, separados por vírgula.
page_size	integer	Não	Número de itens retornados por página.
page_token	string	Não	Token da página a recuperar.

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 grupos de anúncios

REDDIT_ADS_LIST_AD_GROUPS

Lista grupos de anúncios de uma conta do Reddit Ads. Use ao precisar recuperar grupos de anúncios para gerenciamento de campanhas. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios para listar grupos de anúncios.
campaign_id	string	Não	O ID da campanha para filtrar grupos de anúncios.
id	array	Não	Lista de IDs de grupos de anúncios para filtrar.
page_size	integer	Não	Número de itens retornados por página.
page_token	string	Não	Token da página a recuperar (para paginação).

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 anúncios

REDDIT_ADS_LIST_ADS

Lista anúncios por conta de anúncios na plataforma Reddit Ads. Use ao precisar recuperar anúncios de uma conta específica. Suporta filtragem por IDs e paginação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios para listar anúncios.
id	array	Não	Lista opcional de IDs específicos de anúncios para filtrar.
page.size	integer	Não	Número de anúncios a retornar por página.
page.token	string	Não	Token para recuperar uma página específica de resultados.

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 campanhas

REDDIT_ADS_LIST_CAMPAIGNS

Lista campanhas por conta de anúncios com suporte a paginação. Use ao precisar recuperar campanhas de uma conta específica do Reddit Ads. Limite de taxa: 400 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios para listar campanhas.
id	array	Não	Lista de IDs de campanha para filtrar.
page_size	integer	Não	Número de itens retornados por página.
page_token	string	Não	Token da página a recuperar.

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 formulários de geração de leads

REDDIT_ADS_LIST_LEAD_GEN_FORMS

Lista formulários de geração de leads de uma conta de anúncios do Reddit Ads. Use ao precisar recuperar todos os formulários de leads associados a uma conta específica. Limite de taxa: 20 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios para listar formulários de leads. Formato: a2_<identificador>.
page_size	integer	Não	Número de itens a retornar por página.
page_token	string	Não	Token da página a recuperar.

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 pixels por conta de anúncios

REDDIT_ADS_LIST_PIXELS_BY_AD_ACCOUNT

Lista pixels de conversão de uma conta de anúncios específica do Reddit Ads. Limite de taxa: 30 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ad_account_id	string	Sim	O ID da conta de anúncios para listar pixels.
page.size	integer	Não	Número de itens a retornar por página.
page.token	string	Não	Token da página a recuperar.

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.

Consultar contas de anúncios

REDDIT_ADS_QUERY_AD_ACCOUNTS

Consulta contas de anúncios por negócio com filtragem opcional por atores, ativos, funções ou string de filtro personalizada. Use ao precisar recuperar contas de anúncios de um negócio específico com capacidades de filtragem. Limite de taxa: 100 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
business_id	string	Sim	O ID do negócio para consultar contas de anúncios.
data	object	Não	Critérios de filtro para consulta de contas de anúncios.
page_size	integer	Não	Número de itens a retornar por página.
page_token	string	Não	Token da página a recuperar.

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.

Atualizar campanha

REDDIT_ADS_UPDATE_CAMPAIGN

Atualiza uma campanha por ID no Reddit Ads. Use ao precisar modificar configurações da campanha como nome, status, orçamento ou parâmetros de segmentação. Limite de taxa: 200 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Dados da campanha a atualizar.
campaign_id	string	Sim	O ID da campanha a atualizar.

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.

Atualizar post

REDDIT_ADS_UPDATE_POST

Atualiza um post do Reddit por ID. Use ao precisar modificar configurações do post, como habilitar/desabilitar comentários. Limite de taxa: 200 requisições por 60 segundos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
data	object	Sim	Metadados do post a atualizar.
post_id	string	Sim	O ID do post a atualizar. Deve começar com 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.