Instagram Trending Reels
Instagram Trending Reels — это публичные короткие видео, которые сейчас показываются в рекомендательной ленте, с подписями, данными автора, медиа, метками времени и видимыми сигналами вовлеченности. Такие записи-снимки помогают анализировать креативы, отслеживать рекомендательную выдачу, сравнивать контент и продолжать исследование роликов Reels.
Возможности Instagram Trending Reels API
- Снимок ленты без параметров отбораФиксируйте текущую подборку роликов Reels из ленты трендов, не передавая запрос, аккаунт, хештег, регион или фильтр по дате.
- Нормализованные записи роликовПолучайте идентификаторы Reels, публичные URL, подписи, контекст автора, метаданные медиа, метки времени и видимое число лайков, комментариев, просмотров и воспроизведений в единой структуре.
- Подавление дублейПовторяющиеся строки ленты объединяются по ID ролика Reels, первичному ключу или шорткоду до сохранения нормализованных записей.
Параметры Instagram Trending Reels API
Можно отправлять
Этому эндпоинту не нужны параметры запроса. Отправьте пустой JSON-объект как есть.
{}Как использовать Instagram Trending Reels API
Отправьте пустой JSON-объект как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте сохраненные записи снимка с курсорной пагинацией результатов.
- Подготовьте пустой JSON-объект.
- Отправьте тело запроса методом POST на /v1/instagram/trending-reels.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Instagram Trending Reels API
- Опись текущей рекомендательной выдачи: Сохраняйте ID роликов Reels, публичные URL, подписи, данные авторов и время сбора как проверяемую запись текущего снимка ленты.
- Анализ креативов коротких видео: Изучайте текст подписей, контекст автора, миниатюры, ссылки на видео, размеры и длительность, чтобы оценить креативы, попавшие в один снимок.
- Сравнение вовлеченности внутри снимка: Сравнивайте видимые лайки, комментарии, просмотры, воспроизведения и время создания роликов Reels, полученных одной задачей сбора.
Практические советы по Instagram Trending Reels API
- Отправляйте только пустой объект: поля query, region, username, hashtag, date и results_limit отклоняются.
- Рассматривайте каждый ответ как снимок ленты в том виде, в каком его определил источник на момент сбора, а не как официальную формулу ранжирования или заявление о глобальном или региональном охвате.
- Не запрашивайте следующую страницу у источника: results.next_cursor лишь продолжает чтение записей, уже сохраненных для завершенной задачи.
- При хранении повторных снимков убирайте дубли между задачами по стабильным ID роликов Reels или URL, потому что подавление дублей работает только внутри одного ответа ленты.
- Сохраняйте collected_at с каждым результатом, если строите собственный временной ряд: этот эндпоинт не дает исторических снимков и не планирует сборы.
- Обрабатывайте подписи, поля автора, счетчики, медиа, URL и время создания как публичные поля, допускающие null.
Связанные API
Помимо Instagram Trending Reels API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
- Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
- Instagram Tagged Posts API — Собирайте публичные публикации с отметкой выбранных профилей: авторы, медиа, упоминания, контекст отмеченного пользователя и вовлеченность.
- Instagram Transcript API — Извлекайте текст расшифровки, язык, формат, URL источника и shortcode по URL публичных публикаций или Reels.
- Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.
- Instagram Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights 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