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 задачи, затем читайте нормализованные подборки актуального с курсорной пагинацией результатов.
- Подготовьте одно или несколько публичных имен пользователей Instagram — именно имена, а не URL профилей.
- Отправьте usernames методом POST на /v1/instagram/story-highlights.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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 и метках времени.
Связанные API
Помимо 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 Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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