Instagram Posts
Публикации Instagram — это записи в ленте с подписями, контекстом автора, изображениями или видео, метками времени, хештегами, упоминаниями и видимой вовлеченностью. Эти сигналы контента помогают исследовать авторов, анализировать кампании и медиа и готовить исторические отчеты.
Возможности Instagram Posts API
- Сбор публикаций по имени пользователяСобирайте публичные публикации Instagram по одному или нескольким именам пользователей в единой нормализованной структуре ответа.
- Ссылки на медиа и размерыВозвращает публичные ссылки на медиафайлы и миниатюры, размеры и длительность видео в нормализованных полях медиа.
- Записи фото и видеоПриводит публичные фото- и видеопубликации к одной структуре ответа.
- Поля контента и вовлеченностиДобавляет к каждой записи публикации текст подписи, данные автора, время публикации, видимые метрики, хештеги и упоминания.
- Только публичные данныеЗакрытый, удаленный, ограниченный или доступный только после входа контент в ответ не попадает.
Параметры Instagram Posts API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Публичные имена пользователей Instagram без @, разделенные запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число записей, которое должна запросить задача сбора. Должно быть положительным целым числом. |
Как использовать Instagram Posts API
Отправьте публичные имена пользователей как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные записи публикаций с курсорной пагинацией.
- Подготовьте одно или несколько публичных имен пользователей Instagram без @.
- Отправьте usernames и необязательный results_limit методом POST на /v1/instagram/posts.
- Опрашивайте /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/posts" \
-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 Posts API
- Сбор публикаций профилей: Собирайте публичные публикации выбранных имен пользователей Instagram в нормализованные записи со ссылками на медиафайлы и стабильными идентификаторами.
- Исследование контента: Собирайте публичные подписи, метки времени, хештеги и видимые счетчики вовлеченности публикаций, которые изучают исследовательские или аналитические команды.
- Архивирование: Храните метаданные публичных публикаций, ссылки на медиафайлы, контекст автора, исходные URL и время сбора для очередей проверки, систем отчетности или внутренних записей.
- Контроль качества кампаний: Проверяйте публичные публикации, возвращенные для имен пользователей авторов или брендов, прежде чем объединять выбранные записи с данными кампании.
- Обогащение контента профилей: Объединяйте ID публикаций, данные авторов, подписи, ссылки на медиафайлы и видимые метрики с существующими записями профилей или кампаний.
Практические советы по Instagram Posts API
- Отправляйте имена пользователей без префикса @ и используйте небольшие пакеты, пока проверяете новый рабочий процесс.
- Учитывайте, что в некоторых публичных записях может не быть ссылок на медиафайлы, счетчиков или меток времени — это зависит от доступности источника.
- При ответах 429, проверках (challenge) или временных блокировках применяйте умеренные повторные попытки с задержкой, а не повторяйте запросы агрессивно.
- Используйте Reels API для сбора роликов Reels профиля, Search API для поиска и Comments API, когда важны публичные ветки комментариев.
- Не стройте рабочие процессы на закрытых аккаунтах, историях, актуальном или полях, доступных только после входа.
Связанные API
Помимо Instagram Posts API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
- Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
- Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
- 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 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 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