Instagram Following List
Записи Instagram Following List — это публичные профили, на которые подписано исходное имя пользователя, с нормализованными данными профиля, URL профилей, признаками видимости и контекстом связи. Повторные сборы позволяют делать снимки связей, а collected_at, source_username и position фиксируют, когда и где была замечена каждая запись.
Возможности Instagram Following List API
- Пакет исходных имен пользователейОтправляйте одно или несколько публичных имен пользователей Instagram в одной задаче, без начального символа @.
- Происхождение связиСохраняет source_username, relationship и position в extra, чтобы каждый профиль можно было отследить до исходного аккаунта.
- Нормализованные данные профиляПолучайте ID профиля, имя пользователя, отображаемое имя, канонический URL профиля, аватар и публичные признаки верификации или приватности, если они доступны.
- Видимые метрики аккаунтаИспользуйте возвращенное число подписчиков, подписок и публикаций, если эти публичные значения есть в собранной записи.
- Асинхронная постраничная выдачаОтправляйте сбор вне потока запроса, опрашивайте статус задачи и листайте нормализованные результаты с помощью next_cursor.
Параметры Instagram Following List API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Одно или несколько публичных имен пользователей Instagram без @, разделенных запятыми или переводами строки. |
results_limit | Необязательный | Максимальное число профилей подписок, запрашиваемых для каждого исходного имени пользователя; целое число от 1 до 2 000, по умолчанию 100. |
Как использовать Instagram Following List API
Отправьте публичные имена пользователей как асинхронную задачу, опрашивайте ее по возвращенному ID задачи, затем читайте нормализованные профили подписок с курсорной пагинацией.
- Подготовьте одно или несколько публичных имен пользователей Instagram без начального символа @.
- Отправьте usernames и необязательный results_limit от 1 до 2 000 методом POST на /v1/instagram/following-list.
- Опрашивайте /v1/tasks/{task_id}, пока status не станет succeeded или failed.
- Читайте /v1/tasks/{task_id}?limit=50 и продолжайте с results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursorСценарии использования Instagram Following List API
- Карта сети авторов: Стройте удобные для проверки карты того, на каких публичных авторов, издателей и организации подписаны выбранные аккаунты.
- Исследование аккаунтов брендов: Сравнивайте видимые подписки аккаунтов бренда, кампаний, региональных представительств или конкурентов.
- Поиск партнеров: Находите публичные профили, которые встречаются в списках подписок аккаунтов, важных для партнерской программы.
- Обогащение каталога профилей: Добавляйте канонические URL, отображаемые имена, аватары, признаки аккаунтов и происхождение связей во внутренние каталоги.
- Отслеживание изменений связей: Храните снимки с метками времени и сравнивайте стабильные ID профилей между запусками, чтобы видеть добавления и удаления.
Практические советы по Instagram Following List API
- Удаляйте начальный @ из каждого имени пользователя перед отправкой; входные данные провайдера нормализуются до простых имен пользователей.
- Начинайте с небольшого results_limit и увеличивайте его, только если сценарию нужен больший набор видимых связей.
- Храните ID профиля вместе с extra.source_username: один и тот же профиль может встречаться у нескольких исходных аккаунтов.
- Считайте отсутствие аватаров, метрик аккаунта, признаков верификации или позиций обычной изменчивостью публичных результатов.
- Закладывайте обработку пустых или частичных результатов: закрытые, ограниченные, удаленные или доступные только после входа связи не поддерживаются.
Связанные API
Помимо Instagram Following List API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Followers Count API — Получайте публичные данные профиля и видимое число подписчиков, подписок и публикаций.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
- Instagram Followers List API — Собирайте публичные записи профилей подписчиков с контекстом исходного аккаунта и связи.
- Instagram Similar Accounts API — Получайте список аккаунтов, которые Instagram предлагает как похожие на заданный: имена пользователей, имена, аватары и статус верификации.
- Instagram Post Likers API — Получайте аккаунты из видимого списка лайкнувших публикацию по ее URL: имена пользователей, имена, аватары и статус верификации.
- Instagram Reels API
- Instagram Search API
- Instagram Comments API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories 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