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 задачи, затем читайте нормализованные записи с курсорной пагинацией.
- Подготовьте непустой текстовый запрос и при необходимости выберите период публикации; задайте results_limit от 20 до 2 000.
- Отправьте query с необязательными полями results_limit и published_within методом POST на /v1/instagram/reels-search.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте 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, в последующем коде.
Связанные API
Помимо 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 Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items 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 Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API