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