instagram/
reels-search

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

Instagram Reels Search API

Поиск по текстовому запросу
Записи Reels
Период публикации
0,5 кредита за результат
Готово
Готово

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

README

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

Instagram Reels Search

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

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

  • Поиск Reels по текстовому запросуНаходите публичные ролики Reels по одной содержательной поисковой фразе, не начиная с известного профиля, хештега, ID аудио или URL контента.
  • Управление периодом публикацииОграничивайте поиск последним часом, днем, неделей, месяцем или годом, когда задаче нужен заданный диапазон свежести.
  • Записи о контенте и авторахПолучайте идентификаторы Reels, канонические URL, подписи, данные автора, ссылки на медиа, время публикации и видимую вовлеченность в единой структуре.
  • Ограниченный сбор без дублейЗадавайте для каждой задачи от 20 до 2 000 записей: стабильные идентификаторы Reels убирают дубли, а каждая сохраненная запись хранит исходный запрос.

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

ПараметрыОбязательныйОписание
queryОбязательныйОбязательный непустой текст для поиска в текущей публичной выдаче Reels Instagram.
results_limitНеобязательныйМаксимальное число записей по запросу; по умолчанию 100, допускаются целые числа от 20 до 2 000.
published_withinНеобязательныйНеобязательный период публикации: hour, day, week, month или year.

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

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

  1. Подготовьте непустой текстовый запрос и при необходимости выберите период публикации; задайте results_limit от 20 до 2 000.
  2. Отправьте query с необязательными полями results_limit и published_within методом POST на /v1/instagram/reels-search.
  3. Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
  4. Читайте data.results.items из /v1/tasks/{task_id}?limit=50 и переходите по results.next_cursor, пока results.has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/reels-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

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

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

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

  • Используйте точную поисковую фразу, не состоящую из одних пробелов, чтобы после обрезки входных данных задача начиналась с осмысленного запроса.
  • Оставляйте query, published_within и results_limit неизменными при сравнении регулярных запусков, потому что текущая публичная выдача может меняться.
  • Сохраняйте extra.search_query и стабильные ID роликов Reels при объединении страниц результатов или нескольких задач, чтобы происхождение запроса и дедупликация оставались явными.
  • Обрабатывайте подписи, поля автора, медиа, метки времени, типы продукта и видимые счетчики как поля, допускающие null, в последующем коде.

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

  • Instagram Search API — Ищите публичные профили по ключевому слову или имени пользователя: данные аккаунта и видимые признаки.
  • Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
  • Instagram Hashtag Posts API — Находите публичные публикации по хештегу: контекст исходного тега, медиа, авторы, метки времени и видимая вовлеченность.
  • Instagram Transcript API — Извлекайте текст расшифровки, язык, формат, URL источника и shortcode по URL публичных публикаций или Reels.
  • Instagram Post Info API — Получайте данные по известным URL публичных публикаций, Reels или старых IGTV: подписи, данные автора, медиа, метки времени, видимая вовлеченность и контекст входных данных.
  • Instagram Location Info API — Получайте данные об одном месте по ID или URL страницы места: название, категория, телефон, координаты и число публикаций с отметкой.

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

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

Instagram Reels Search API — FAQ

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

Поле query обязательно и должно содержать текст, а не только пробелы. results_limit принимает значения от 20 до 2 000 и по умолчанию равен 100; published_within принимает hour, day, week, month или year.

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

results_limit — это максимум, а не гарантия. Доступная публичная выдача может меняться между запусками, а дубли роликов Reels с одинаковым стабильным идентификатором удаляются в рамках задачи.

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