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을 /v1/instagram/followers-list로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.
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 trueInstagram 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 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- 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