Instagram Followers List
Подписчики Instagram — это публичные записи о связях для профилей, видимых в списке подписчиков переданного имени пользователя, с данными профиля, фото профиля, признаками верификации и приватности, контекстом источника, позицией и временем сбора. Эти поля помогают формировать выборки аудитории, проверять пересечения между аккаунтами, отбирать профили и исследовать списки связей.
Возможности Instagram Followers List API
- Сбор подписчиков нескольких аккаунтовОтправьте одно или несколько имен пользователей Instagram и запросите профили подписчиков каждого исходного аккаунта в одной асинхронной задаче.
- Нормализованные данные подписчиковВозвращает доступные ID профиля, имя пользователя, отображаемое имя, производный URL профиля и публичное фото профиля для каждой строки подписчика.
- Признаки видимости и источникаСохраняет признаки верификации и закрытого аккаунта, а также исходное имя пользователя и тип связи, если эти значения доступны.
- Контекст наблюдаемого спискаСохраняет позицию в источнике и время парсинга Actor, если они доступны, а время сбора SocQ используется как резервная метка времени.
- Лимит результатов на имя пользователяresults_limit применяется к каждому отправленному имени пользователя отдельно; по умолчанию 100, допустимый диапазон — от 1 до 2 000.
Параметры Instagram Followers List API
| Параметры | Обязательный | Описание |
|---|---|---|
usernames | Обязательный | Обязательный непустой список имен пользователей Instagram. Каждый элемент должен быть непустой строкой; начальные символы @ удаляются перед сбором. |
results_limit | Необязательный | Максимальное число профилей подписчиков, запрашиваемых для каждого имени пользователя; по умолчанию 100, принимаются целые числа от 1 до 2 000. |
Как использовать Instagram Followers List API
Отправьте публичные имена пользователей Instagram, отслеживайте асинхронную задачу и после успешного сбора постранично читайте нормализованные записи профилей подписчиков.
- Подготовьте одно или несколько публичных имен пользователей Instagram; начальный символ @ допускается и удаляется перед сбором.
- Отправьте usernames и необязательный results_limit методом POST на /v1/instagram/followers-list и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте data.results.items и переходите по next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/instagram/followers-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 data.results.items and follow next_cursor while has_more is trueСценарии использования Instagram Followers List API
- Выборки публичной аудитории: Формируйте ограниченную выборку имен пользователей, отображаемых имен, ссылок на профили, признаков видимости и наблюдаемых позиций подписчиков выбранного публичного аккаунта.
- Проверка пересечений между аккаунтами: Группируйте строки по extra.source_username и сравнивайте ID или имена пользователей подписчиков, чтобы находить профили, которые встречаются у нескольких отправленных аккаунтов.
- Очереди обогащения профилей: Отбирайте возвращенные имена пользователей и передавайте их в Instagram Profiles, когда сценарию нужны описание профиля или видимые счетчики профиля.
- Снимки списков связей: Храните данные подписчика, исходное имя пользователя, наблюдаемую позицию и collected_at, чтобы последующие выборки публичного списка можно было различать.
Практические советы по Instagram Followers List API
- При отправке нескольких имен пользователей оценивайте запрошенный объем как число имен, умноженное на results_limit: лимит и оценка кредитов применяются к каждому исходному аккаунту.
- Если исходное имя пользователя начинается с @, его можно отправить без изменений: маппер провайдера удаляет начальные символы @ перед запуском Actor.
- При сравнении аккаунтов сохраняйте extra.source_username: один и тот же профиль подписчика может встречаться в нескольких исходных списках, а удаление дублей между источниками не гарантируется.
- Если position есть, считайте его наблюдаемым значением в списке, а не стабильным рейтингом или мерой силы связи.
- Если публичный источник вернул меньше строк, чем запрошено, сохраните частичный результат и зафиксируйте collected_at; приватность, доступность аккаунта, пагинация источника и лимиты Actor могут уменьшить выдачу.
Связанные API
Помимо Instagram Followers List API, используйте эти API, когда нужен другой тип публичных данных Instagram.
- Instagram Followers Count API — Получайте публичные данные профиля и видимое число подписчиков, подписок и публикаций.
- Instagram Posts API — Собирайте публичные публикации, медиа, хештеги, упоминания, метки времени и вовлеченность по имени пользователя.
- Instagram Profiles API — Получайте по имени пользователя публичные данные профиля, описание, ссылки, признаки аккаунта, категории и видимые счетчики.
- Instagram Following List API — Собирайте публичные профили, на которые подписаны аккаунты Instagram: данные аккаунта, контекст связи и видимые счетчики.
- 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