instagram/
hashtag-posts

Собирайте публичные публикации Instagram по одному или нескольким хештегам: данные автора, подписи, медиафайлы, исходные хештеги, метки времени и видимые метрики вовлеченности.

Instagram Hashtag Posts API

Поиск по хештегам
Записи публикаций
Фильтры по времени и типу медиа
0,5 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Instagram Hashtag Posts

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

Возможности Instagram Hashtag Posts API

  • Сбор по нескольким хештегамОтправляйте один или несколько хештегов с # или без него; results_limit применяется к каждому отправленному хештегу отдельно.
  • Фильтры по времени и медиаОграничивайте поиск последним часом, днем, неделей, месяцем или годом и выбирайте все публикации или только Reels.
  • Нормализованные записи публикацийПолучайте ID публикаций, шорткоды, канонические URL, подписи, данные автора, ссылки на медиафайлы, хештеги, упоминания и метки времени в единой структуре.
  • Контекст источника и вовлеченностьСохраняет отправленный хештег, по которому получена каждая запись, вместе с доступным числом лайков, комментариев, просмотров и воспроизведений.

Параметры Instagram Hashtag Posts API

ПараметрыОбязательныйОписание
hashtagsОбязательныйОдин или несколько непустых хештегов с # или без него, разделенных запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число записей, запрашиваемых для каждого хештега; по умолчанию 100, принимаются целые числа от 10 до 2 000.
published_withinНеобязательныйНеобязательный период публикации: hour, day, week, month или year.
media_typeНеобязательныйФильтр контента: all включает поддерживаемые типы публикаций, а reels ограничивает результаты роликами Reels.

Как использовать Instagram Hashtag Posts API

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

  1. Подготовьте один или несколько уникальных хештегов с начальным # или без него.
  2. Отправьте hashtags и необязательные поля results_limit, published_within и media_type методом POST на /v1/instagram/hashtag-posts.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Сценарии использования Instagram Hashtag Posts API

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

Практические советы по Instagram Hashtag Posts API

  • Убирайте дубли среди входных хештегов и используйте одно написание для каждой темы: сборщик обрабатывает каждое отправленное значение независимо.
  • Планируйте объем на каждый хештег: results_limit применяется к каждому хештегу, а не ко всему запросу.
  • Используйте published_within и media_type вместе, когда регулярному мониторингу нужны постоянный период и тип контента.
  • Удаляйте пересекающиеся результаты по стабильным ID публикаций, шорткодам или каноническим URL, сохраняя extra.hashtag для указания происхождения.
  • Обрабатывайте медиафайлы, счетчики, метки времени и другие публичные поля как необязательные: доступность источника может различаться от публикации к публикации.

Помимо Instagram Hashtag Posts API, используйте эти API, когда нужен другой тип публичных данных Instagram.

  • Instagram Search API — Ищите публичные профили по ключевому слову или имени пользователя: данные аккаунта и видимые признаки.
  • Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
  • Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
  • Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.
  • Instagram Reels Search API — Ищите публичные Reels по текстовому запросу: подписи, авторы, медиа, метки времени, видимая вовлеченность и контекст запроса.
  • Instagram Hashtag Search API — Находите хештеги по ключевому слову: названия, ID, URL страниц хештегов и число публичных публикаций.

Другие платформы

Объединяйте данные Instagram с публичными данными других поддерживаемых соцсетей.

Instagram Hashtag Posts API — FAQ

Instagram Hashtag Posts API — это программный интерфейс для получения публичных публикаций Instagram, связанных с одним или несколькими отправленными хештегами. Он возвращает нормализованные идентификаторы публикаций, подписи, авторов, медиафайлы, метки времени, контекст исходного хештега и видимые метрики вовлеченности.

Отправьте непустой массив hashtags; значения могут содержать начальный # или нет. results_limit принимает значения от 10 до 2 000, по умолчанию 100, и применяется к каждому хештегу отдельно.

published_within принимает hour, day, week, month или year. media_type принимает all или reels; если поле не указано, используется all.

Нормализованный результат может включать ID, шорткод, URL, подпись, автора, медиафайлы, хештеги, упоминания, created_at, collected_at, видимое число лайков, комментариев, просмотров и воспроизведений, а также extra.hashtag для совпавшего входного значения.

Тариф — 0,5 кредита за каждую возвращенную нормализованную запись без базовой платы. Оценка рассчитывается как results_limit на хештег, умноженный на число отправленных хештегов; итоговое списание считается по фактически возвращенным записям.