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

Отметки людей и место в публикации Instagram через API

API Instagram отмечает людей через user_tags и добавляет место через location_id. Оба параметра задаются в медиаконтейнере до публикации. user_tags принимает публичные имена пользователей с координатами x и y от 0.0 до 1.0, которые обязательны для изображений. Meta описывает их для изображений, видео и Stories. location_id принимает ID Страницы с данными о местоположении, который находится через Pages Search API.

easyCoexistence публикует фото, карусели, Reels и Stories через publish_instagram_post из Claude, ChatGPT или вашего кода.

0.0 to 1.0

Диапазон координат x и y в user_tags, отсчитываемых от левого и верхнего края изображения.

Images

Где user_tags требует x и y: на Stories они необязательны, а параметры применяются только к изображениям и Stories.

Carousels

location_id не поддерживается для изображений и видео внутри карусели, как указано в справочнике медиа Meta.

USER_TAGGING_FAILURE

Значение config_issue, когда публикация выходит без отметок пользователей; Meta называет это частичным успехом.

13 Mar 2018

Когда Meta открыла отметку локаций и публичных аккаунтов Instagram в фото, опубликованных через API, сначала для бета-партнёров.

Как отмечать людей в публикации?

Добавьте user_tags в контейнер. Это массив объектов, каждый с именем пользователя публичного аккаунта Instagram и, для изображения, x и y: числа с плавающей точкой от 0.0 до 1.0, задающие расстояние отметки от левого и верхнего края. Место указывается в location_id в том же запросе, после чего контейнер публикуется через media_publish, как обычно.

An image container with a user tag and a location
POST /<IG_ID>/media
Content-Type: application/json

{
  "image_url": "https://example.com/team.jpg",
  "caption": "<CAPTION>",
  "user_tags": [
    { "username": "<USERNAME>", "x": 0.42, "y": 0.61 }
  ],
  "location_id": "<PAGE_ID>"
}

Какие публикации принимают отметки и место?

Справочник медиа Meta описывает user_tags для изображений, видео и Stories; x и y применяются только к изображениям и Stories. Там же перечислены параметры, которые принимает каждый контейнер. В карусели место указывается в контейнере карусели, так как location_id не поддерживается для изображений и видео внутри неё:

Imageuser_tags with x and y, and location_id
Reeluser_tags by username, and location_id
Storyuser_tags, with x and y optional; no location_id in its syntax
Carousel containerlocation_id, and no user_tags in its syntax
Carousel itemsNo location_id

Как найти location_id?

Найдите Страницу. location_id: ID Страницы, связанной с локацией. Справочник Meta указывает на Pages Search API: GET /pages/search с q и fields=id,name,location, а затем на проверку, что выбранная Страница содержит данные о местоположении. Страница без них вызывает ошибку INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID. Поиск выполняется в Graph API Meta с токеном вашего приложения Meta: пользовательским токеном или, для публичной информации о Странице, токеном приложения с функцией Page Public Metadata Access.

Searching for a Page with a location
GET /pages/search
  ?q=<PLACE_NAME>
  &fields=id,name,location
  &access_token=<ACCESS_TOKEN>

Что происходит, если отметка не прикрепилась?

Публикация всё равно может выйти. media_publish тогда возвращает config_issue со значением USER_TAGGING_FAILURE, что означает публикацию без отметок пользователей. Meta называет это частичным успехом и просит приложения считать это сигналом для сверки, а не ошибкой, так как ID медиа действителен. Повторная публикация создаст второй пост.

Работают ли отметки пользователей с Instagram Login?

Справочник медиа Meta перечисляет user_tags и location_id для создания контейнера, не привязывая их к одному типу входа. Однако его страница об Instagram API с Instagram Login утверждает, что такая настройка не имеет доступа к рекламе или отметкам, не уточняя, каким именно. Прежде чем строить на любом из параметров с Instagram Login, опубликуйте тестовую публикацию и проверьте ответ и саму публикацию.

Как отмечать людей через easyCoexistence?

Пока нельзя. publish_instagram_post сам создаёт контейнер и не принимает user_tags или location_id, а токены Instagram не выдаются для собственного вызова. Опубликуйте пост через publish_instagram_post, затем добавьте отметки и локацию в приложении Instagram, через пункт «Редактировать» у публикации.

Распространённые ошибки

  • Отсутствие x и y у отметки на изображении. Meta требует их для изображений; только для Stories они необязательны.
  • Координаты в пикселях или процентах. Значения x и y задаются числами с плавающей точкой от 0.0 до 1.0, отсчитываемыми от левого и верхнего края.
  • Установка location_id на элементах карусели. Meta не поддерживает его для изображений или видео внутри карусели.
  • Отметка закрытого аккаунта. user_tags принимает имена пользователей публичных аккаунтов Instagram.
Настройка с EasyCoexistence

Инструмент не принимает user_tags и location_id, поэтому людей и места отмечают в приложении Instagram, через пункт «Редактировать» у публикации. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений, и с бесплатным пробным периодом на первые 3 дня.

Часто задаваемые вопросы

Можно ли отметить закрытый аккаунт Instagram через API?

Нет. Справочник медиа Meta указывает, что user_tags принимает имена публичных аккаунтов Instagram, поэтому закрытый аккаунт таким способом не отметить.

Сколько людей можно отметить в одной публикации?

Справочник Meta для user_tags не задаёт максимума. Ограничение в 20 упомянуто для @-отметок в подписи.

Можно ли добавить место к Stories через API?

Нет. Синтаксис контейнера Stories у Meta перечисляет user_tags, но не location_id.

Можно ли отметить товар вместо человека?

Отметки товаров являются отдельной функцией. Обзор Meta указывает, что она поддерживается с Facebook Login и Unified Login, но не с Instagram Login.

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

Совместные посты Instagram через APIКак API Instagram публикует совместные посты: параметр collaborators, до 3 имён на фото, Reels и каруселях, приглашения и правила входа.Упоминания в Instagram через API: поиск и ответы на @упоминанияКак @упоминания в Instagram приходят через API в вебхуке комментариев с Instagram Login и как на них отвечать в комментариях и подписях.Получение постов аккаунта Instagram через APIКак API Instagram выводит посты аккаунта через GET /<IG_ID>/media: поля, элементы каруселей, курсоры, пагинация по дате и лента для сайта.Лимиты публикации в Instagram API: форматы, размеры и посты в деньЧто вмещает публикация через Instagram API и сколько их в сутки: JPEG до 8 МБ, Reels, Stories, подписи до 2 200 символов, 100 постов за 24 часа.Что умеет Instagram API в 2026 году и что остаётся в приложенииПубликации, комментарии, личные сообщения, статистика и упоминания через Instagram Login в 2026 году, и что остаётся в приложении Instagram.

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

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

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

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