API поиска по хэштегам в Instagram: поиск постов по хэштегу
Поиск по хэштегам в Instagram находит публичные фото и видео с хэштегом за два запроса. GET /ig_hashtag_search с user_id и q возвращает ID хэштега, затем GET /<HASHTAG_ID>/top_media выводит самые популярные посты, а /recent_media выводит посты, опубликованные за последние 24 часа. Аккаунт может запросить 30 уникальных хэштегов за скользящие 7 дней, с Facebook Login или Unified Login.
easyCoexistence подключает Instagram через Instagram Login, поэтому Claude, ChatGPT или ваш собственный код работает с собственными постами аккаунта, комментариями, упоминаниями и статистикой через официальный API Meta, а его комментарии и упоминания могут передаваться на ваш эндпоинт по мере поступления.
Уникальные хэштеги, которые один бизнес- или креаторский аккаунт может запросить за скользящий 7-дневный период.
recent_media возвращает только медиа, опубликованные в течение 24 часов до запроса.
Больше всего результатов на страницу возвращает top_media, который листается только курсором after.
В сравнении трёх схем, которое приводит Meta, поиск по хэштегам через Instagram API с Instagram Login.
ID хэштегов статичны и глобальны: хэштег сохраняет один и тот же ID для каждого приложения и пользователя.
Как работает поиск по хэштегам?
В два шага, от имени бизнес-аккаунта или аккаунта креатора Instagram, ID которого передаётся в user_id. GET /ig_hashtag_search с q, равным названию хэштега, возвращает его ID. Meta указывает, что он статичен и глобален, поэтому его можно сохранить. GET /<HASHTAG_ID>/top_media или /recent_media с user_id и fields затем выводит посты.
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_countВ чём разница между top_media и recent_media?
top_media возвращает самые популярные фото и видео с этим хэштегом; Meta определяет популярность по сочетанию просмотров и взаимодействия зрителей. recent_media возвращает самые свежие публикации, только за последние 24 часа до запроса, и Meta отмечает, что ответы не всегда идут в хронологическом порядке. Оба возвращают только публичные медиа, не включая продвигаемые, усиленные и рекламные публикации, и выдают результаты постранично, по 50, с курсором after.
Какие поля возвращаются?
Поля медиа, которые справочники Meta перечисляют для обоих эндпоинтов, возвращающих только публичные фото и видео:
- id,
media_type(CAROUSEL_ALBUM, IMAGE или VIDEO), permalink и timestamp. - caption и
comments_count, плюсlike_count, если владелец скрыл счётчики лайков. - children для медиа-альбомов и
media_urlдля остальных типов медиа, но не для видео с защищённым авторскими правами или лицензированным аудио. - Нет поля username: Meta не разрешает его для медиа, найденных по хэштегу.
Какие ограничения?
Meta задаёт их для каждого аккаунта и для каждого хэштега:
- 30 уникальных хэштегов за скользящие 7 дней. Хэштег учитывается с первого запроса; повторный запрос в этот срок бесплатен и не сбрасывает его 7 дней.
- Получение
top_mediaилиrecent_mediaсчитается запросом хэштега, даже если его ID уже сохранён. - GET /<
IG_ID>/recently_searched_hashtagsпоказывает уникальные хэштеги, которые аккаунт искал на текущей неделе. - Хэштеги в Истории и эмодзи в запросах не поддерживаются, а хэштеги, которые Meta считает чувствительными или оскорбительными, возвращают общую ошибку.
- Медиа, найденные таким способом, нельзя комментировать через API.
Что нужно для поиска по хэштегам?
Одобрение App Review для функции Instagram Public Content Access и разрешения instagram_basic, которые Meta требует до использования приложением, а также пользовательский токен доступа из Facebook Login для человека, который может выполнять задачи на связанной Странице, либо токен Unified Login. Обзор Meta указывает, что поиск по хэштегам не поддерживается с Instagram Login, а его вызовы подпадают под ограничения частоты запросов платформы Meta, а не под лимит вызовов Instagram на аккаунт. Разрешённые сценарии, которые перечисляет Meta: поиск контента в кампаниях с хэштегами, понимание общественного мнения о бренде и выявление участников конкурсов.
Можно ли искать хэштеги через easyCoexistence?
easyCoexistence подключает Instagram через Instagram Login, который даёт доступ к собственным постам подключённого аккаунта, комментариям, упоминаниям и статистике. Meta предлагает поиск по хэштегам только через Facebook Login и Unified Login, поэтому он находится вне этого подключения. Вместо этого подключение охватывает собственные посты аккаунта через list_social_posts, а также его комментарии и упоминания, которые передаются на ваш эндпоинт по мере поступления.
Распространённые ошибки
- Трата недельной квоты на тесты. Каждый новый хэштег входит в 30 за 7 дней, а получение его медиа учитывается, даже при сохранённом ID.
- Запрос username в результатах по хэштегу. Meta не возвращает его для медиа, найденных поиском по хэштегам.
- Чтение recent_media как архива. Он охватывает публикации за 24 часа до запроса и не идёт строго в хронологическом порядке.
- Вызов с токеном Instagram Login. Meta помечает поиск по хэштегам как не поддерживаемый в такой схеме.
От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, первые 3 дня бесплатно.
Часто задаваемые вопросы
Может ли Instagram API искать хэштеги без App Review?
Нет. Meta требует одобрения App Review для функции Instagram Public Content Access и instagram_basic до того, как приложение сможет вызвать поиск по хэштегам.
Могу ли я узнать, кто опубликовал пост с хэштегом?
Не по username, который Meta не включает в результаты по хэштегам. Permalink каждого поста открывает его в Instagram.
Включает ли поиск по хэштегам Истории?
Нет. Meta не поддерживает хэштеги в Историях, а оба эндпоинта возвращают только публичные фото и видео.
Засчитывается ли повторный запрос того же хэштега дважды?
Нет. Повторные запросы в течение 7 дней не расходуют лимит из 30 и не сбрасывают таймер хэштега.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на