instagram/
reels

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

Instagram Reels API

Reels
Публичные данные
Метаданные медиа
0,52 кредита за результат
Готово
Готово

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

README

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

Instagram Reels

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

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

  • Сбор Reels профиляСобирайте публичные ролики Reels по одному или нескольким именам пользователей Instagram в единой нормализованной структуре ответа.
  • Поля контента, медиа и вовлеченностиВозвращает подписи, метки времени, число воспроизведений, лайки, комментарии, репосты, длительность, миниатюры, ссылки на видео, хештеги, упоминания и метаданные аудио.
  • Лимит запрошенных результатовИспользуйте results_limit, чтобы ограничить число роликов Reels, запрашиваемых в каждом запросе.
  • Только публичные данныеЗакрытые, ограниченные, удаленные и доступные только после входа ролики Reels в результаты не попадают.

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

ПараметрыОбязательныйОписание
usernamesОбязательныйПубличные имена пользователей Instagram без @, разделенные запятыми или переводами строки.
results_limitНеобязательныйМаксимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом.

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

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

  1. Подготовьте одно или несколько публичных имен пользователей Instagram без @.
  2. Отправьте usernames и необязательный results_limit методом POST на /v1/instagram/reels.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, если есть еще записи.
curl -X POST "https://api.socq.ai/v1/instagram/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

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

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

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

  • Храните стабильные ID роликов Reels, шорткоды, URL и ID задач, чтобы задания сбора можно было повторять и проверять.
  • Используйте умеренные значения results_limit и логику задержек при сборе больших публичных списков Reels профилей.
  • Учитывайте, что у некоторых публичных роликов Reels может не быть счетчиков, ссылок на видео или сведений об аудио — это зависит от доступности источника.
  • Используйте Search API для поиска профилей, а Reels API — для публичных роликов Reels выбранных имен пользователей.
  • Не стройте рабочие процессы на закрытых аккаунтах, ограниченных роликах Reels или полях, доступных только после входа.

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

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

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

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

Instagram Reels API — FAQ

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

Типичные поля: ID ролика Reels, шорткод, URL, автор, подпись, метка времени, видимые метрики, ссылки на медиафайлы, длительность, хештеги, упоминания, метаданные аудио и время сбора.

Текущий эндпоинт принимает одно или несколько публичных имен пользователей Instagram. URL отдельного ролика Reels или шорткод в качестве входных данных запроса не принимаются.

Нет. Закрытые, ограниченные, удаленные или доступные только после входа ролики Reels могут вернуть ограниченные данные или ни одной записи, потому что эндпоинт собирает только общедоступные результаты.

Он может возвращать публичные ссылки на видео, если такие URL есть в публичных результатах Reels. У некоторых роликов Reels доступны только метаданные или миниатюры, поэтому клиентам следует обрабатывать отсутствующие поля медиа.

Используйте умеренную частоту запросов, меньшие размеры страниц, продолжение по курсору и задержку после ответов 429 или похожих сигналов перегрузки. Не парсите один и тот же профиль многократно в больших объемах.

Да, если публичные результаты содержат данные об аудио. Нормализованный объект audio может включать ID, название, исполнителя и URL.