instagram/
trending-reels

Собирайте текущую подборку роликов Reels из ленты трендов без параметров отбора и получайте подписи, авторов, медиа, метки времени и видимую вовлеченность.

Instagram Trending Reels API

Без параметров отбора
Снимок текущей ленты
Нормализованные записи Reels
0,5 кредита за результат
Готово
README

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

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 задачи, затем читайте сохраненные записи снимка с курсорной пагинацией результатов.

  1. Подготовьте пустой JSON-объект.
  2. Отправьте тело запроса методом POST на /v1/instagram/trending-reels.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте /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.

Помимо 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 с публичными данными других поддерживаемых соцсетей.

Instagram Trending Reels API — FAQ

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

Входные данные — пустой JSON-объект; поля query, region, username, hashtag, date и results_limit не принимаются.

«В тренде» означает текущую подборку роликов Reels, которую возвращает настроенная рекомендательная лента на момент сбора. Эндпоинт не раскрывает формулу ранжирования и не заявляет о глобальном охвате, региональной персонализации или стабильном порядке.

Нормализованная запись может содержать ID и URL ролика Reels, текст подписи, ID автора, имя пользователя, имя и аватар, видимое число лайков, комментариев, просмотров и воспроизведений, метаданные медиа, created_at, collected_at и тип продукта.

Параметры results_limit и продолжения у источника не принимаются, а сборщик выполняет один запрос к ленте. Эндпоинт результатов задачи при этом может разбивать уже сохраненные записи на страницы с помощью limit и results.next_cursor.

Нет. Каждая задача фиксирует ленту на момент сбора; сохраняйте результаты вместе с collected_at, если вашему приложению нужно сравнивать независимо собранные снимки.

Оплата составляет 0,5 кредита за каждую возвращенную нормализованную запись, базовой платы нет. При отправке используется оценка в 20 записей, а итоговый расход определяется фактически возвращенными записями.