instagram/
highlight-items

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

Instagram Highlight Items API

Известные ID актуального
Записи историй
Медиа и контекст источника
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Highlight Items

Instagram Highlight Items — это истории, сохраненные в подборках актуального публичных профилей, с текстом, данными автора, ссылками на медиафайлы, метками времени и видимыми сигналами вовлеченности. Такие записи помогают вести опись контента в актуальном, проверять медиафайлы, готовить отчеты с учетом источника и сравнивать известные подборки актуального.

Возможности Instagram Highlight Items API

  • Несколько подборок на входеОтправляйте один или несколько числовых ID подборок актуального; для каждого переданного идентификатора выполняется один запрос к источнику.
  • Нормализованные записи историйПолучайте ID элементов, публичные URL, заголовок или текст подписи, данные автора, видимые метрики, метаданные медиафайлов и метки времени в единой структуре записи.
  • Привязка к исходной подборкеКаждый возвращенный элемент сохраняет отправленный ID подборки в extra.highlight_id, поэтому записи из разных подборок актуального остаются различимыми.

Параметры Instagram Highlight Items API

ПараметрыОбязательныйОписание
highlight_idsОбязательныйОдин или несколько известных ID подборок актуального Instagram в виде непустых числовых строк, разделенных запятыми или переводами строки.

Как использовать Instagram Highlight Items API

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

  1. Подготовьте один или несколько актуальных числовых ID подборок; если ID неизвестен, сначала соберите Story Highlights по имени пользователя и возьмите extra.highlight_id из возвращенной записи-контейнера.
  2. Отправьте highlight_ids методом POST на /v1/instagram/highlight-items.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
# Replace the documented sample with a current highlight ID before running.
curl -X POST "https://api.socq.ai/v1/instagram/highlight-items" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"highlight_ids":["18067016518767507"]}'

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

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

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

Практические советы по Instagram Highlight Items API

  • Если ID подборок неизвестны, сначала вызовите instagram/story-highlights по имени пользователя и используйте extra.highlight_id из успешных результатов; этот эндпоинт не находит ID по именам пользователей.
  • Удаляйте дубли ID перед отправкой: сборщик выполняет отдельный запрос для каждого переданного значения.
  • Не добавляйте results_limit: каждый ID подборки дает те элементы, которые есть в единственном ответе источника.
  • Используйте resource, чтобы отличать highlight-items от story-highlights: обе группы нормализованных записей используют type story.
  • Считайте текст, поля автора, метрики, медиафайлы, URL и метки времени необязательными и учитывайте, что недоступные или удаленные истории могут не дать записи.
  • Переходите по results.next_cursor только для чтения следующих сохраненных записей задачи: курсор не продолжает сбор из Instagram.

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

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

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

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

Instagram Highlight Items API — FAQ

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

Используйте известный текущий ID подборки или сначала соберите Story Highlights по имени пользователя. Успешные результаты instagram/story-highlights содержат исходный идентификатор в extra.highlight_id, если он доступен; этот эндпоинт не принимает имена пользователей.

Нормализованный элемент может содержать ID, URL, текст, ID автора, имя пользователя и имя, видимые метрики, метаданные изображения или видео, created_at, collected_at и extra.highlight_id. Наличие полей зависит от публичного ответа источника.

results_limit не принимается, а сборщик делает один запрос к источнику на каждый ID подборки. При этом эндпоинт результатов задачи может постранично отдавать сохраненные записи с limit и results.next_cursor.

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

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