Instagram Post Info
Записи Instagram Post Info описывают отдельные публичные публикации, ролики Reels или устаревшие элементы IGTV через подпись, данные автора, ссылки на медиафайлы, время публикации, видимую вовлеченность и тип продукта в источнике. Эти поля помогают обогащать данные по известным URL, каталогизировать контент, делать снимки вовлеченности и сравнивать форматы.
Возможности Instagram Post Info API
- Запрос по прямому URL контентаОбрабатывает известные публичные URL Instagram вида /p/, /reel/ и /tv/ без сбора профиля или поиска.
- Подпись и контекст автораВозвращает публичный текст подписи с доступными ID автора, именем пользователя, отображаемым именем и ссылкой на аватар.
- Медиа и вовлеченностьНормализует публичные ссылки на изображения или видео вместе с видимым числом лайков, комментариев, просмотров и воспроизведений.
- Прослеживаемые нормализованные записиСохраняет отправленный URL и доступный тип продукта источника в каждой стандартизированной записи публикации.
Параметры Instagram Post Info API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательные URL контента Instagram, разделенные запятыми или переводами строки. Допустимые хосты — instagram.com и www.instagram.com; путь должен начинаться с /p/, /reel/ или /tv/. |
Как использовать Instagram Post Info API
Отправьте URL публичного контента как асинхронную задачу, опрашивайте ее по ID задачи, затем читайте нормализованные записи с курсорной пагинацией.
- Подготовьте один или несколько публичных URL instagram.com, путь которых начинается с /p/, /reel/ или /tv/ и содержит шорткод контента.
- Отправьте urls методом POST на /v1/instagram/post-info.
- Опрашивайте /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/post-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.items.Сценарии использования Instagram Post Info API
- Обогащение известных публикаций: Добавляйте подпись, данные автора, медиафайлы, время публикации и видимую вовлеченность к сохраненному списку URL контента Instagram.
- Нормализация каталога контента: Превращайте смешанные ссылки на публикации, Reels и устаревшие элементы IGTV в единообразные записи со стабильными идентификаторами и контекстом источника.
- Снимки публичной вовлеченности: Фиксируйте видимые счетчики лайков, комментариев, просмотров и воспроизведений выбранного контента на момент сбора.
- Сравнение форматов контента: Используйте поля медиа и тип продукта источника, чтобы сравнивать доступные метаданные известных публикаций ленты, Reels и устаревших элементов IGTV.
Практические советы по Instagram Post Info API
- Указывайте реальный шорткод после /p/, /reel/ или /tv/: путь только с префиксом может пройти проверку формата, но не вернуть записи.
- Сохраняйте extra.input_url, чтобы сопоставлять результаты задачи с несколькими URL с входными данными; повторяющиеся URL объединяются, и каждый уникальный URL дает не больше одной записи.
- Будьте готовы к тому, что записей окажется меньше, чем отправленных URL, и считайте поля автора, метрик, медиа, времени и типа продукта необязательными, если контент недоступен или не опубликован открыто.
Связанные API
Помимо Instagram Post Info API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Reels API — Собирайте публичные Reels, медиа, аудио, хештеги, упоминания и вовлеченность по имени пользователя.
- Instagram Comments API — Собирайте публичные комментарии, авторов, метки времени, лайки и ответы по URL публикаций.
- Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
- Instagram Transcript API — Извлекайте текст расшифровки, язык, формат, URL источника и shortcode по URL публичных публикаций или Reels.
- Instagram Post Likers API — Получайте аккаунты из видимого списка лайкнувших публикацию по ее URL: имена пользователей, имена, аватары и статус верификации.
- Instagram Followers Count API
- Instagram Search API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Tagged 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 Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API