instagram/
stories

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

Instagram Stories API

Имя пользователя на входе
Активные истории
Стикеры-ссылки
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Stories

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

Возможности Instagram Stories API

  • Все активные истории аккаунтаОдно имя пользователя возвращает все истории, которые аккаунт показывает в момент отправки запроса.
  • Медиа, готовые к архивированиюКаждая история приходит с URL изображения или видео, шириной и высотой и обложкой, поэтому контент можно сохранить или просмотреть позже.
  • Когда история появилась и когда исчезнетВремя публикации приходит в published_at, а время истечения — в extra.expires_at, так что вы точно знаете, сколько времени осталось до следующего сбора.
  • Ссылки и упоминания остаются при историиАдреса стикеров-ссылок перечислены в extra.link_urls, а отмеченные аккаунты — в extra.mentions, и они привязаны к истории, в которой появились.

Параметры Instagram Stories API

ПараметрыОбязательныйОписание
usernameОбязательныйИмя пользователя публичного аккаунта Instagram, текущие истории которого вам нужны. Начальный символ @ необязателен.

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

Отправьте имя пользователя, дождитесь завершения задачи и прочитайте истории из ее результата.

  1. Выберите публичный аккаунт для проверки, например natgeo.
  2. Отправьте {"username": "natgeo"} методом POST на /v1/instagram/stories и сохраните task_id из ответа.
  3. Вызывайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
  4. Читайте истории в results.items; если results.has_more равно true, передайте results.next_cursor, чтобы получить следующую страницу.
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"natgeo"}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.

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

  • Ежедневный архив историй: Собирайте истории бренда один-два раза в день и сохраняйте медиа и время публикации, чтобы каждую историю можно было просмотреть и после ее истечения.
  • Отслеживание акций: Следите за URL стикеров-ссылок, которые конкуренты добавляют в истории, чтобы видеть, какие товары, распродажи и лендинги они продвигают на этой неделе.
  • Проверка кампаний с авторами: Сверяйте время истории автора, медиа и стикер-ссылку с брифом, чтобы убедиться, что согласованная история вышла.

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

  • Запускайте сбор с интервалом меньше 24 часов, чтобы каждая история попала в данные хотя бы раз, пока она активна.
  • Скачивайте нужные изображения и видео вскоре после сбора: ссылки на медиа историй — временные адреса CDN.
  • При повторном сборе того же аккаунта используйте id истории, чтобы пропускать уже сохраненные истории.
  • Для историй, которые аккаунт оставляет в профиле, используйте Instagram Story Highlights и Instagram Highlight Items.

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

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

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

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

Instagram Stories API — FAQ

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

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

Если в истории есть стикер-ссылка, URL назначения этого стикера возвращается в extra.link_urls для этой истории.

Истории доступны 24 часа, поэтому сбор один-два раза в день позволяет захватить каждую, пока она активна.

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

Вы платите 0,5 кредита за каждую возвращенную историю, а запрос, который не нашел активных историй, ничего не стоит.