instagram/
story-highlights

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

Instagram Story Highlights API

Поиск по имени пользователя
Подборки актуального
ID подборок для повторного использования
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Story Highlights

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

Возможности Instagram Story Highlights API

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

Параметры Instagram Story Highlights API

ПараметрыОбязательныйОписание
usernamesОбязательныйОдно или несколько публичных имен пользователей Instagram в виде непустых строк; начальный символ @ допускается и удаляется перед сбором.

Как использовать Instagram Story Highlights API

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

  1. Подготовьте одно или несколько публичных имен пользователей Instagram — именно имена, а не URL профилей.
  2. Отправьте usernames методом POST на /v1/instagram/story-highlights.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"]}'

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

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

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

Практические советы по Instagram Story Highlights API

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

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

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

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

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

Instagram Story Highlights API — FAQ

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

Передайте непустой массив имен пользователей Instagram. Начальный символ @ удаляется, но URL профилей не преобразуются в имена пользователей, поэтому нормализуйте имена и убирайте дубли перед отправкой.

Нет. Он возвращает подборки; если нужны отдельные истории подборки, используйте присутствующий числовой extra.highlight_id с instagram/highlight-items.

Запись может содержать ID подборки, URL, название, ID владельца, имя пользователя и имя, напрямую доступные медиа, общие публичные счетчики, created_at, collected_at, extra.highlight_id и extra.media_count.

Управляемый вызывающей стороной results_limit и продолжение у источника не реализованы. Каждое имя пользователя запрашивается один раз, а cursor и limit на эндпоинте задач только разбивают на страницы уже сохраненные нормализованные записи.

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

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