Как отслеживать упоминания бренда в Instagram (включая те, где вас не отмечают)

Кто-то публикует в Instagram фото вашего продукта. Пишет название продукта в подписи, добавляет пару хэштегов и не отмечает ваш аккаунт. Уведомление вам не приходит. С точки зрения вашей панели этого не было.

В этом главная проблема отслеживания упоминаний бренда в Instagram. Упоминания, о которых вам сообщают, в меньшинстве. Остальные находятся в подписях и хэштегах, и их нужно искать самостоятельно.

В этом руководстве разобраны оба способа поиска: ручные методы, которые дает Instagram, и момент, когда они перестают работать, а также автоматизация поиска через API упоминаний. Оно написано для команд бренда и маркетинга, для разработчиков, которые встраивают мониторинг в свои инструменты, и для авторов, которые хотят понять, о каких брендах уже говорят люди, прежде чем предлагать спонсорство.

Что считается упоминанием бренда в Instagram

Упоминание это любая публичная публикация, которая ссылается на бренд. На практике их три вида, и каждый находится по-своему:

Первый вид проще всего заметить, и он встречается реже всего. Третий заметить труднее всего, и он часто самый честный, потому что тот, кто вас не отмечает, ничего не изображает ради вас.

Ручной способ: что показывает Instagram

Одним только приложением можно сделать на удивление много, если знать, что охватывает каждый источник.

Уведомления

Когда кто-то отмечает или @упоминает ваш аккаунт, вы получаете уведомление. Это удобно, чтобы быстро ответить и сделать репост, но охватывает только действия, напрямую связанные с вашим аккаунтом. Подпись, где ваше название написано без ссылки, уведомления не вызывает.

Вкладка публикаций с отметками в профиле

Публикации, в которых отмечен аккаунт, собираются в разделе отметок этого профиля. Так можно быстро увидеть, кто отмечает бренд, и это работает для любого публичного профиля, а не только для вашего. Поэтому это удобный способ впервые посмотреть на конкурента или бренд, с которым вы хотите работать.

Страницы хэштегов

Найдите хэштег, и Instagram покажет публикации с ним. Проверьте фирменный хэштег, хэштег кампании и само название бренда в виде хэштега. Названия брендов часто становятся популярными хэштегами, так что будьте готовы к шуму от посторонних публикаций с тем же словом.

Где ручной мониторинг перестает работать

• Подписи без отметок не видны. Нет ни уведомления, ни вкладки для подписи, где просто назван ваш продукт.
• Это не масштабируется. Каждый день проверять имя аккаунта, три хэштега и два названия продукта утомительно для одного бренда и невозможно для портфеля клиентов.
• Ничего не сохраняется. Вы видите ленту, а не набор данных. Нет выгрузки, истории и цифр, которые можно сравнивать неделя к неделе.
• Конкуренты требуют тех же усилий заново. Каждый бренд, за которым вы следите, умножает ручную работу.

Если вы следите за одним небольшим брендом и вам важны в основном отметки, ручного способа достаточно. Как только нужны упоминания без отметок, несколько брендов или цифры для отчетов, нужны поиски, которые выполняются за вас.

Автоматический способ: поиск по хэштегам, отметкам и фразам

Сервис мониторинга упоминаний выполняет те же три запроса, но запускает их вместе и возвращает структурированные результаты. Monitor Mentions, наш родственный продукт, создан именно для этого. Вы указываете имя аккаунта, хэштеги и фразы, и он выполняет такие поиски:

• Имя аккаунта добавляет три поиска: проверку аккаунта, имя аккаунта как хэштег и вкладку отметок аккаунта.
• Одно слово ищется как хэштег.
• Два слова и больше ищутся как фраза, и именно так находятся публикации, где о бренде говорят без отметки.

Каждая публикация возвращается с автором, датой, подписью, отметками "Нравится" и поиском, который ее нашел. Последнее поле важнее, чем кажется: публикация, где хэштег поставлен намеренно, и подпись, где слова встретились случайно, это разные доказательства, и оценивать их стоит по-разному.

Сначала можно попробовать в браузере. Первый поиск за день бесплатный и без регистрации, а результаты скачиваются в CSV или JSON.

Шаг 1: Составьте список поисковых запросов

Хорошие результаты начинаются со слов, которые люди действительно используют. Для каждого бренда запишите:

• Имя аккаунта в Instagram, если оно есть.
• Фирменные хэштеги и хэштеги кампаний.
• Названия продуктов, особенно из нескольких слов.
• Слоганы и фразы из кампаний, которые люди цитируют.
• Имя основателя, если он публичное лицо бренда.

Имя аккаунта вообще не обязательно. Оставьте его пустым и ищите только по хэштегам и фразам, чтобы отслеживать продукт, фразу из кампании, событие или человека.

Шаг 2: Получите API-ключ

Войдите в панель Monitor Mentions и создайте ключ. Он начинается с mm_mon_ и показывается только один раз, поэтому храните его в надежном месте, например в переменной окружения. Ключ можно передавать в заголовке Authorization: Bearer или в заголовке x-api-key.

Шаг 3: Запустите поиск упоминаний

Весь API это один endpoint: POST /api/v1/mentions/search. Отправьте имя аккаунта, хотя бы один запрос или и то и другое. Вот пример из документации 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"]}'

Тело запроса принимает три необязательных поля:

За один вызов можно отправить до 5 запросов. Чтобы отслеживать больше, делайте больше вызовов.

Тот же запрос на 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"])

Шаг 4: Разберите ответ

Ответ группирует все нужное в несколько блоков:

• entity и account: запрошенное имя аккаунта и данные его профиля, например имя, подписчики и наличие верификации.
• credits: сколько кредитов списано за этот вызов, сколько осталось и ваш месячный лимит.
• summary: количество публикаций, авторов и видео, самая новая и самая старая публикация, а также публикации по каждому запросу.
• posts: по одной записи на публикацию, с полями id, url, author, caption, thumbnail, is_video, taken_at, likes, comments и found_by.
• failed: каждый поиск, который не вернул результат, с его методом и запросом.

Несколько деталей, которые стоит знать, прежде чем строить что-то на этой основе:

• В found_by есть method со значением hashtag, tagged или phrase, а также term, который совпал. Публикация, найденная двумя поисками, возвращается один раз, под первым поиском, который ее нашел.
• Миниатюры устаревают. Это URL изображений из Instagram, поэтому скачивайте и храните изображение, если оно понадобится позже.
• Likes и comments это значения в том виде, в каком их сообщил Instagram, или null, если они скрыты.
• Полей охвата и тональности нет. Сводка считает публикации, аккаунты и публикации по запросам, и больше ничего, потому что продукт не измеряет ни то, ни другое. Если для отчета нужен охват, определять и считать его придется самостоятельно.

Шаг 5: Запускайте по расписанию и храните историю

Поиски Monitor Mentions возвращают то, что Instagram отдает по каждому запросу: скорее свежие публикации, чем архив, и это зависит от запроса. Загрузки истории задним числом нет. Практическое следствие: история начинается в тот день, когда вы начали отслеживать, поэтому начинайте до того, как она понадобится.

Простая схема, которая подходит большинству команд:

1. Ежедневная задача вызывает endpoint поиска один раз для каждого бренда с его именем аккаунта и запросами.
2. Новые публикации сохраняются в базу данных с ключом по id публикации, чтобы повторы не считались дважды.
3. Миниатюры копируются в ваше собственное хранилище.
4. Показатели по каждому запросу выводятся на график неделя к неделе, а новые публикации отправляются в Slack, таблицу или ваше хранилище данных.

Агентства могут делать один вызов на клиента каждое утро и передавать результат в отчет, который они уже отправляют. Повторный запуск того же поиска в тот же день по UTC бесплатен, так что обновление в течение дня ничего не стоит.

Проверить баланс можно в любой момент через GET /api/v1/mentions/usage: это бесплатно, а в ответе есть plan, monthly, used, remaining и resets_on. Каждый ответ поиска также содержит заголовок x-credits-remaining.

Сколько это стоит

Цена: один кредит за поиск, а список поисков показывается до отправки запроса:

Значит, имя аккаунта с двумя ключевыми словами стоит пять кредитов, и на сайте, и через API. Несуществующее имя аккаунта стоит один кредит за проверку, а остальные поиски не выполняются. Поиск, который не удался на стороне источника, все равно засчитывается, и ответ указывает его в failed.

Тарифы API по данным страницы цен:

Кредиты обновляются 1-го числа каждого месяца по UTC. На сайте бесплатный вход через Google дает 20 баллов в день, и это отдельный баланс, не связанный с кредитами API.

Ошибки, которые нужно обрабатывать

Каждая ошибка возвращается как JSON вида {"error": "...", "status": 400}. Вот те, к которым стоит подготовиться:

Повторяйте 502 и 503 с небольшой задержкой. Считайте 429 сигналом остановиться до обновления кредитов или сменить тариф, а не поводом повторять запрос в цикле.

Для авторов: найдите бренды, прежде чем им писать

Если вы снимаете видео на YouTube, те же поиски отвечают на вопрос о спонсорстве: о каких брендах говорят в вашей нише и кто именно? У каждой публикации указан автор, поэтому поиск по имени аккаунта бренда и названиям его продуктов показывает авторов, которые уже о нем публикуют. Так вы узнаете, работает ли бренд с авторами вашего масштаба, какой контент создается и какие фразы из кампаний люди действительно повторяют.

Это также хороший способ проверить предложение. Если у хэштега кампании бренда много публикаций, а слоган почти не встречается в подписях, вы понимаете, что из этого находит отклик у аудитории. В нашем руководстве о том, как зарабатывать на YouTube, рассказано, как спонсорство сочетается с другими источниками дохода.

Пробел, который не закроет ни один поиск по подписям

Одно ограничение касается любого инструмента, который читает текст, и Monitor Mentions прямо об этом говорит: он читает подписи и хэштеги, а не звук. Reel, где кто-то произносит ваш бренд вслух, но нигде его не пишет, не попадет в результаты, как и название, которое появляется только на экране внутри видео.

В видео настоящее упоминание часто звучит в речи. Именно для этого нужны расшифровки. Если вы отслеживаете упоминания бренда в видео на YouTube, расшифровка превращает каждое произнесенное название бренда в текст, по которому можно искать, а наш API возвращает расшифровки видео с YouTube, чтобы вы могли искать по ним так же, как по подписям.

Краткий чек-лист

• Запишите для каждого бренда имя аккаунта, хэштеги, названия продуктов и слоганы.
• Используйте встроенные уведомления, вкладку отметок и страницы хэштегов как отправную точку.
• Ищите названия из нескольких слов и слоганы как фразы, чтобы находить упоминания без отметок.
• Сохраняйте метод и запрос, по которым найдена каждая публикация.
• Запускайте поиски по расписанию, убирайте дубликаты по id публикации и храните миниатюры сами.
• Помните, что подписи это не звук: для устных упоминаний нужна расшифровка.