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
Отправьте имя пользователя, дождитесь завершения задачи и прочитайте истории из ее результата.
- Выберите публичный аккаунт для проверки, например natgeo.
- Отправьте {"username": "natgeo"} методом POST на /v1/instagram/stories и сохраните task_id из ответа.
- Вызывайте GET /v1/tasks/{task_id} каждые несколько секунд, пока status не станет succeeded.
- Читайте истории в 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.
Связанные API
Помимо 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 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 Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels 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