instagram/
tagged-posts

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

Instagram Tagged Posts API

Отметки профилей
Контекст публикации
Публичный контент
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Tagged Posts

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

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

  • Поиск по отметкам профиляИспользуйте публичные имена пользователей Instagram как цели и получайте публикации, в которых эти профили отмечены, а не публикации самого целевого аккаунта.
  • Данные публикации и автораПолучайте ID публикаций, шорткоды, URL публикаций, подписи и нормализованные поля профиля автора для отслеживаемых записей контента.
  • Контекст отметок и упоминанийСтруктурированный контекст tagged_users хранится вместе с хештегами и возвращенными упоминаниями, поэтому разные виды связей публикации остаются различимыми.
  • Медиа и видимая вовлеченностьВозвращает нормализованные ссылки на изображения или видео с видимым числом лайков, комментариев, просмотров и воспроизведений для каждой публичной публикации.
  • Контекст публикации во времениВключает нормализованное время публикации, время сбора и product_type для хронологического просмотра и классификации форматов публикаций.

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

ПараметрыОбязательныйОписание
usernamesОбязательныйОдно или несколько публичных имен пользователей Instagram без @, разделенные запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число записей публикаций с отметкой, запрашиваемых задачей; целое число от 1 до 2 000, по умолчанию 100.

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

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

  1. Подготовьте одно или несколько публичных имен пользователей Instagram без начального символа @.
  2. Отправьте usernames и необязательный results_limit от 1 до 2 000 методом POST на /v1/instagram/tagged-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/tagged-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

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

  • Мониторинг отметок профиля: Используйте tagged_users, URL публикаций, подписи, данные авторов и метки времени, чтобы просматривать публичные публикации с отметками выбранных профилей.
  • Проверка связи с кампанией: Сравнивайте подписи, медиа, контекст отметок и видимую вовлеченность публикаций, связанных с отметкой профиля кампании.
  • Исследование вклада авторов: Используйте нормализованные данные авторов и связи через отметки профилей, чтобы находить публичных авторов, публикующих контент вокруг выбранных аккаунтов.
  • Архив контента с отметками: Храните ID публикаций, шорткоды, возвращенные URL, ссылки на медиа, время публикации и время сбора в записях контента, удобных для проверки.

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

  • Удаляйте начальный @ из каждого целевого имени пользователя перед отправкой, чтобы запрос использовал чистый идентификатор профиля.
  • Читайте extra.tagged_users для отметок профилей на уровне публикации, а mentions — для возвращенных строк упоминаний, и не считайте эти поля взаимозаменяемыми.
  • Убирайте дубли при повторных сборах по ID публикации или шорткоду и сохраняйте возвращенный URL публикации для проверки и отслеживания.
  • Допускайте отсутствие медиа, счетчиков вовлеченности, признаков автора и меток времени: нормализованные публичные записи сохраняют поля источника, допускающие null.
  • Продолжайте с results.next_cursor, пока results.has_more равно true, чтобы большие наборы публикаций с отметкой не обрывались после первой страницы.

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

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

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

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

Instagram Tagged Posts API — FAQ

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

Нет. Этот эндпоинт находит публикации, в которых отмечен целевой профиль; mentions — это поля, возвращаемые вместе с найденными публикациями, если публичный результат их содержит, а не отдельный поиск публикаций с упоминаниями.

Передайте непустой массив usernames с публичными именами пользователей; при обработке входных данных начальный @ удаляется. results_limit необязателен и принимает целое число от 1 до 2 000, по умолчанию 100.

extra.tagged_users сохраняет структурированный контекст отметок профилей, возвращенный для публикации. mentions — это отдельный список имен пользователей, возвращенных как упоминания в нормализованной записи контента.

Tagged Posts находит публичные публикации, в которых отмечены выбранные профили. Instagram Posts, напротив, собирает публикации, автором которых являются переданные имена пользователей.

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

Вернуть можно только общедоступные подходящие публикации. Удаленные, ограниченные, закрытые, доступные только после входа или не переданные источником записи и поля могут привести к неполному или пустому результату.

Читайте до 500 результатов задачи на страницу и продолжайте с next_cursor, пока has_more равно true.

Успешные нормализованные результаты стоят 0,5 кредита за запись, базовой платы нет. Пустой результат стоит ноль кредитов в соответствии с политикой только базовой платы.