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 задачи, затем читайте нормализованные публикации с отметкой с курсорной пагинацией.
- Подготовьте одно или несколько публичных имен пользователей Instagram без начального символа @.
- Отправьте usernames и необязательный results_limit от 1 до 2 000 методом POST на /v1/instagram/tagged-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/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, чтобы большие наборы публикаций с отметкой не обрывались после первой страницы.
Связанные API
Помимо 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 Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search 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 Hashtag Search API
- Instagram Account Age Checker API