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 задачи, затем читайте нормализованные записи публикаций с курсорной пагинацией.
- Подготовьте один или несколько уникальных хештегов с начальным # или без него.
- Отправьте hashtags и необязательные поля results_limit, published_within и media_type методом POST на /v1/instagram/hashtag-posts.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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 для указания происхождения.
- Обрабатывайте медиафайлы, счетчики, метки времени и другие публичные поля как необязательные: доступность источника может различаться от публикации к публикации.
Связанные API
Помимо 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 Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API