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 задачи, затем читайте сохраненные нормализованные записи с курсорной пагинацией результатов.
- Подготовьте один или несколько актуальных числовых ID подборок; если ID неизвестен, сначала соберите Story Highlights по имени пользователя и возьмите extra.highlight_id из возвращенной записи-контейнера.
- Отправьте highlight_ids методом POST на /v1/instagram/highlight-items.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /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.
Связанные API
Помимо 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 Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Post Info API
- Instagram Reels Search 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