instagram/
followers-list

사용자 이름으로 공개 Instagram 팔로워 프로필을 수집하여, 정규화된 식별 정보, 프로필 이미지, 공개 범위 플래그, 출처 정보, 순서, 수집 시각을 반환합니다.

Instagram Followers List API

팔로워 프로필
출처 정보
공개 관계
결과당 0.3 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용자 이름을 제출하고, 비동기 작업을 추적한 뒤, 수집이 성공하면 정규화된 팔로워 프로필 레코드를 페이지 단위로 읽습니다.

  1. 공개 Instagram 사용자 이름을 하나 이상 준비합니다. 앞에 붙은 @는 허용되며 수집 전에 제거됩니다.
  2. usernames와 선택 항목인 results_limit을 /v1/instagram/followers-list로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 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 제한 때문에 결과가 줄어들 수 있습니다.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Followers List API — 자주 묻는 질문

Instagram Followers List API는 제출한 Instagram 사용자 이름의 팔로워 목록에 공개적으로 표시되는 프로필 레코드를 가져오는 프로그래밍 인터페이스입니다. 정규화된 식별 정보, 프로필 이미지, 공개 범위 플래그, 출처 계정 정보, 목록 순서, 수집 시각을 확인 가능한 범위에서 반환합니다.

usernames는 비어 있지 않은 문자열로 이루어진, 비어 있지 않은 배열이어야 하는 필수 값입니다. results_limit은 선택 값이며, 사용자 이름당 기본값은 100이고 1 이상 2,000 이하의 정수를 받습니다.

레코드에는 프로필 ID, 사용자 이름, 표시 이름, 파생된 프로필 URL, 프로필 이미지, 인증·비공개 플래그, 수집 시각과 함께 출처 사용자 이름, 관계, 관찰된 순서를 담은 extra 필드가 포함될 수 있습니다.

아니요. 공개 팔로워 프로필을 행 단위로 반환합니다. 프로필의 공개된 팔로워·팔로잉·게시물 총수가 필요하면 Instagram Followers Count API를 사용하세요.

아니요. 지원되는 공개 출처로 볼 수 있는 관계만 반환할 수 있으며, 비공개이거나 이용할 수 없거나 철자가 틀린 출처 계정은 행이 없을 수 있습니다.

results_limit은 요청한 최댓값이며 완전성을 보장하지 않습니다. 프로필 비공개 설정, 계정 가용성, Actor 제한, 원본 페이지네이션, 현재의 공개 팔로워 목록 범위 때문에 최종 개수가 줄어들 수 있습니다.

반환된 팔로워 프로필 1개당 0.3 SocQ 크레딧이 차감됩니다. 예상 요금은 사용자 이름 수에 results_limit을 곱해 계산하며, 결과가 비어 있으면 결과 요금이 없습니다.