ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

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, а его комментарии и упоминания могут передаваться на ваш эндпоинт по мере поступления.

30

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

24 hours

recent_media возвращает только медиа, опубликованные в течение 24 часов до запроса.

50

Больше всего результатов на страницу возвращает top_media, который листается только курсором after.

Not supported

В сравнении трёх схем, которое приводит Meta, поиск по хэштегам через Instagram API с Instagram Login.

Static

ID хэштегов статичны и глобальны: хэштег сохраняет один и тот же ID для каждого приложения и пользователя.

Как работает поиск по хэштегам?

В два шага, от имени бизнес-аккаунта или аккаунта креатора Instagram, ID которого передаётся в user_id. GET /ig_hashtag_search с q, равным названию хэштега, возвращает его ID. Meta указывает, что он статичен и глобален, поэтому его можно сохранить. GET /<HASHTAG_ID>/top_media или /recent_media с user_id и fields затем выводит посты.

Finding a hashtag's ID, then its recent posts
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 помечает поиск по хэштегам как не поддерживаемый в такой схеме.
Настройка с EasyCoexistence

От 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 и не сбрасывают таймер хэштега.

Читайте дальше

Instagram Business Discovery: чтение публикаций и подписчиков другого аккаунтаКак Business Discovery в Instagram читает подписчиков, профиль и публикации другого аккаунта по username и какой вход для этого нужен.Упоминания в Instagram через API: поиск и ответы на @упоминанияКак @упоминания в Instagram приходят через API в вебхуке комментариев с Instagram Login и как на них отвечать в комментариях и подписях.Получение постов аккаунта Instagram через APIКак API Instagram выводит посты аккаунта через GET /<IG_ID>/media: поля, элементы каруселей, курсоры, пагинация по дате и лента для сайта.Отметки людей и место в публикации Instagram через APIКак отметить людей через user_tags и добавить место через location_id в API Instagram: какие публикации поддерживают и как найти location_id.Ограничения Instagram API: вызовы за 24 часа и пропускная способность личных сообщенийОграничения Instagram API: 4 800 вызовов на показ за 24 часа, 100 сообщений в секунду, 750 частных ответов в час и ошибка 80002.Разрешения Instagram API: области доступа для каждой функцииРазрешения, которые API Instagram использует с Instagram Login: от instagram_business_basic до manage_insights и что нужно каждой функции.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на