Como monitorar menções de marca no Instagram (inclusive as que nunca marcam você)

Alguém publica uma foto do seu produto no Instagram. A pessoa escreve o nome do produto na legenda, adiciona umas hashtags e nunca marca sua conta. Você não recebe nenhuma notificação. Para o seu painel, isso nunca aconteceu.

Esse é o problema central de monitorar menções de marca no Instagram. As menções de que você fica sabendo são a minoria. O resto está em legendas e hashtags, e você precisa ir atrás delas.

Este guia mostra as duas formas de buscar: os métodos manuais que o Instagram oferece e onde eles deixam de funcionar, e como automatizar a busca com uma API de menções. Ele foi escrito para equipes de marca e marketing, para desenvolvedores que integram monitoramento às próprias ferramentas e para criadores que querem ver de quais marcas as pessoas já falam antes de propor um patrocínio.

O que conta como menção de marca no Instagram

Uma menção é qualquer post público que se refere à marca. Na prática, existem três tipos, e cada um é encontrado de um jeito diferente:

O primeiro tipo é o mais fácil de ver e o menos comum. O terceiro é o mais difícil de ver e muitas vezes o mais sincero, porque quem não marca você não está fazendo pose para você.

O jeito manual: o que o Instagram mostra

Dá para ir surpreendentemente longe só com o app, desde que você saiba o que cada fonte cobre.

Notificações

Quando alguém marca ou @menciona sua conta, você é avisado. Isso é útil para responder rápido e repostar conteúdo, mas só cobre a atividade que envolve sua conta diretamente. Uma legenda que escreve seu nome sem link não gera notificação.

A aba de posts marcados de um perfil

Os posts que marcam uma conta ficam reunidos na seção de marcados desse perfil. É um jeito rápido de ver quem marca uma marca, e funciona em qualquer perfil público, não só no seu. Isso faz dela uma boa primeira olhada em um concorrente ou em uma marca com a qual você quer trabalhar.

Páginas de hashtag

Busque uma hashtag e o Instagram mostra os posts que a usaram. Confira a hashtag da sua marca, a hashtag da campanha e o nome da marca puro como hashtag. Nomes de marca costumam virar hashtags populares, então espere ruído de posts sem relação que por acaso usam a mesma palavra.

Onde o monitoramento manual deixa de funcionar

• Legendas sem marcação são invisíveis. Não há notificação nem aba para uma legenda que simplesmente cita seu produto.
• Não escala. Verificar um @, três hashtags e dois nomes de produto todo dia é cansativo para uma marca e impossível para uma carteira de clientes.
• Nada fica registrado. Você vê um feed, não um conjunto de dados. Não há exportação, histórico nem números para comparar semana a semana.
• Concorrentes exigem o mesmo esforço de novo. Cada marca acompanhada multiplica o trabalho manual.

Se você monitora uma marca pequena e se importa principalmente com marcações, o caminho manual resolve. Quando você precisa de menções sem marcação, de mais de uma marca ou de números para relatórios, precisa de buscas que rodem por você.

O jeito automatizado: buscas por hashtag, marcações e frases

Um rastreador de menções faz as mesmas três consultas, mas as executa juntas e devolve resultados estruturados. O Monitor Mentions, nosso produto irmão, foi criado exatamente para isso. Você informa um @, hashtags e frases, e ele faz estas buscas:

• O @ adiciona três buscas: a consulta da conta, o @ como hashtag e a aba de marcados da conta.
• Uma única palavra é buscada como hashtag.
• Duas ou mais palavras são buscadas como frase, que é como você encontra os posts que falam de uma marca sem marcá-la.

Cada post volta com autor, data, legenda, curtidas e a busca que o encontrou. Esse último campo importa mais do que parece: um post com hashtag colocada de propósito e uma legenda que por acaso contém as palavras são evidências diferentes, e vale a pena dar pesos diferentes a cada uma.

Você pode testar primeiro no navegador. A primeira busca do dia é gratuita e sem cadastro, e os resultados podem ser baixados em CSV ou JSON.

Passo 1: Monte sua lista de termos de busca

Bons resultados começam com as palavras que as pessoas realmente usam. Para cada marca, liste:

• O @ do Instagram, se houver.
• As hashtags da marca e das campanhas.
• Os nomes dos produtos, principalmente os de várias palavras.
• Slogans e frases de campanha que as pessoas citam.
• O nome de um fundador, se ele for o rosto público da marca.

Você nem precisa de um @. Deixe-o em branco e busque só hashtags e frases para monitorar um produto, uma frase de campanha, um evento ou uma pessoa.

Passo 2: Gere uma chave de API

Entre no painel do Monitor Mentions e crie uma chave. Ela começa com mm_mon_ e aparece só uma vez, então guarde-a em um lugar seguro, como uma variável de ambiente. Você pode enviá-la como cabeçalho Authorization: Bearer ou como cabeçalho x-api-key.

Passo 3: Faça uma busca de menções

A API inteira é um único endpoint: POST /api/v1/mentions/search. Envie um @, pelo menos um termo, ou os dois. Este é o exemplo da documentação da API:

curl -X POST https://www.monitormentions.com/api/v1/mentions/search \
  -H "Authorization: Bearer $MM_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle": "liquiddeath", "keywords": ["murder your thirst", "deathwish"]}'

O corpo da requisição aceita três campos opcionais:

Você pode enviar até 5 termos por chamada. Para acompanhar mais, faça mais chamadas.

A mesma requisição em Python:

import os
import requests

resp = requests.post(
    "https://www.monitormentions.com/api/v1/mentions/search",
    headers={"Authorization": f"Bearer {os.environ['MM_KEY']}"},
    json={"handle": "liquiddeath", "keywords": ["murder your thirst", "deathwish"]},
    timeout=120,
)
resp.raise_for_status()
data = resp.json()

for post in data["posts"]:
    found = post["found_by"]
    print(post["author"], post["url"], found["method"], found["term"])

for miss in data["failed"]:
    print("failed:", miss["method"], miss["term"])

Passo 4: Leia a resposta

A resposta agrupa tudo o que você precisa em poucos blocos:

• entity e account: o @ consultado e os dados do perfil, como nome, seguidores e se é verificado.
• credits: quantos créditos esta chamada cobrou, quantos restam e sua cota mensal.
• summary: contagem de posts, criadores e vídeos, o post mais recente e o mais antigo, e posts por termo.
• posts: uma entrada por post, com id, url, author, caption, thumbnail, is_video, taken_at, likes, comments e found_by.
• failed: qualquer busca que não retornou, com seu método e termo.

Alguns detalhes que vale saber antes de construir em cima disso:

• found_by tem um method que pode ser hashtag, tagged ou phrase, mais o term que correspondeu. Um post encontrado por duas buscas é retornado uma única vez, na primeira busca que o encontrou.
• As miniaturas expiram. São URLs de imagem do Instagram, então baixe e guarde a imagem se for precisar dela depois.
• Likes e comments são os números informados pelo Instagram, ou null quando estão ocultos.
• Não há campo de alcance nem de sentimento. O resumo conta posts, contas e posts por termo, e nada mais, porque o produto não mede nenhum dos dois. Se um relatório precisar de alcance, você terá que defini-lo e calculá-lo por conta própria.

Passo 5: Rode com frequência e guarde o histórico

As buscas do Monitor Mentions retornam o que o Instagram retorna em cada busca, ou seja, conteúdo recente e não histórico, que varia conforme o termo. Não há dados retroativos. A consequência prática: o histórico começa no dia em que você começa a monitorar, então comece antes de precisar dele.

Uma configuração simples que funciona para a maioria das equipes:

1. Uma tarefa diária chama o endpoint de busca uma vez por marca, com seu @ e seus termos.
2. Os posts novos são salvos em um banco de dados, usando o id do post como chave para que repetições não sejam contadas duas vezes.
3. As miniaturas são copiadas para o seu próprio armazenamento.
4. Os números por termo viram um gráfico semana a semana, e os posts novos vão para o Slack, uma planilha ou seu data warehouse.

Agências podem fazer uma chamada por cliente toda manhã e enviar o resultado para o relatório que já mandam. Repetir a mesma busca no mesmo dia UTC é gratuito, então atualizar ao longo do dia não custa nada a mais.

Você pode consultar seu saldo a qualquer momento com GET /api/v1/mentions/usage, que é gratuito e retorna plan, monthly, used, remaining e resets_on. Toda resposta de busca também traz um cabeçalho x-credits-remaining.

Quanto custa

O preço é um crédito por busca, e as buscas aparecem listadas antes de você enviar qualquer coisa:

Então um @ com duas palavras-chave custa cinco créditos, tanto na página web quanto pela API. Um @ que não existe custa um crédito, pela consulta, e as outras buscas não são feitas. Uma busca que falha na origem é contada mesmo assim, e a resposta a lista em failed.

Os planos da API, segundo a página de preços:

Os créditos são renovados no dia 1º de cada mês, em UTC. Na web, entrar gratuitamente com o Google dá 20 pontos por dia, um saldo separado dos créditos da API.

Erros que você deve tratar

Todo erro é um JSON no formato {"error": "...", "status": 400}. Os que você deve prever:

Tente de novo os erros 502 e 503 com uma espera curta. Trate o 429 como sinal para parar até a renovação ou para mudar de plano, não como algo para tentar de novo em loop.

Para criadores: encontre marcas antes de fazer a proposta

Se você faz vídeos no YouTube, as mesmas buscas respondem a uma pergunta sobre patrocínio: de quais marcas se fala no seu nicho, e quem fala delas? Cada post traz seu autor, então uma busca pelo @ e pelos nomes de produto de uma marca mostra os criadores que já publicam sobre ela. Isso indica se a marca trabalha com criadores do seu tamanho, que tipo de conteúdo é produzido e quais frases de campanha as pessoas realmente repetem.

Também é um bom jeito de validar uma proposta. Se a hashtag de campanha de uma marca tem muitos posts, mas o slogan quase não aparece nas legendas, você sabe qual dos dois conquista o público. Nosso guia sobre como ganhar dinheiro no YouTube explica como os patrocínios se encaixam com suas outras fontes de renda.

A lacuna que nenhuma busca em legendas consegue cobrir

Existe um limite que vale para qualquer ferramenta que lê texto, e o Monitor Mentions o declara com clareza: ele lê legendas e hashtags, não áudio. Um reel em que alguém fala sua marca em voz alta e nunca a escreve não é detectado, assim como um nome que só aparece na tela dentro do vídeo.

Em vídeo, as palavras faladas muitas vezes são onde está a menção de verdade. É esse o papel das transcrições. Se você monitora menções de marca em vídeos do YouTube, uma transcrição transforma cada nome de marca falado em texto pesquisável, e a nossa API retorna transcrições de vídeos do YouTube para que você possa buscar nelas do mesmo jeito que busca nas legendas.

Checklist rápido

• Liste o @, as hashtags, os nomes de produto e os slogans de cada marca.
• Use as notificações nativas, a aba de marcados e as páginas de hashtag como base.
• Busque nomes de várias palavras e slogans como frases para encontrar menções sem marcação.
• Guarde o método e o termo que encontraram cada post.
• Rode as buscas com frequência, remova duplicatas pelo id do post e guarde você mesmo as miniaturas.
• Lembre que legenda não é áudio: menções faladas precisam de uma transcrição.