instagram/
following-list

Instagram 계정이 팔로우하는 공개 프로필을 수집하여, 정규화된 사용자 이름, 프로필 링크, 공개 범위 신호, 관계 정보, 공개된 수치를 반환합니다.

Instagram Following List API

팔로잉 관계
공개 프로필
사용자 이름 일괄 처리
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Following List

Instagram 팔로잉 목록 레코드는 출처 사용자 이름이 팔로우하는 공개 프로필을 나타내며, 정규화된 식별 정보, 프로필 URL, 공개 범위 신호, 관계 정보를 담고 있습니다. 반복 수집으로 관계 스냅샷을 만들 수 있고, collected_at, source_username, position이 각 레코드를 언제 어디서 관찰했는지 보존합니다.

Instagram Following List API 주요 기능

  • 출처 사용자 이름 일괄 처리앞의 @ 없이 공개 Instagram 사용자 이름을 하나 이상 작업 하나로 제출합니다.
  • 관계 출처 정보extra에 source_username, relationship, position을 유지하므로 모든 프로필을 출처 계정까지 추적할 수 있습니다.
  • 정규화된 프로필 식별 정보프로필 ID, 사용자 이름, 표시 이름, 정식 프로필 URL, 아바타와 함께, 확인 가능한 경우 공개된 인증·비공개 신호를 받습니다.
  • 공개된 계정 수치수집된 레코드에 공개 값이 있으면 반환된 팔로워·팔로잉·게시물 수를 활용할 수 있습니다.
  • 비동기 결과 페이지 이동요청 스레드와 별개로 수집 작업을 제출하고, 작업 상태를 폴링하며, next_cursor로 정규화된 결과를 페이지 단위로 읽습니다.

Instagram Following List API 매개변수

매개변수필수설명
usernames필수@ 없는 공개 Instagram 사용자 이름을 쉼표나 줄바꿈으로 구분해 하나 이상 지정합니다.
results_limit선택출처 사용자 이름마다 요청하는 팔로잉 프로필의 최대 개수로, 1~2,000 사이의 정수이며 기본값은 100입니다.

Instagram Following List API 사용 방법

공개 사용자 이름을 비동기 작업으로 제출하고, 반환된 작업 ID를 폴링한 뒤, 정규화된 팔로잉 프로필을 커서 페이지네이션으로 읽습니다.

  1. 앞의 @ 없이 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
  2. usernames와 선택 항목인 1~2,000 사이의 results_limit을 /v1/instagram/following-list로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, has_more가 true이면 results.next_cursor로 이어서 가져옵니다.
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과 함께 저장하세요.
  • 아바타, 계정 수치, 인증 신호, position이 없는 경우는 공개 결과에서 흔한 변동으로 취급하세요.
  • 비공개, 제한됨, 삭제됨, 로그인 전용 관계는 지원 범위 밖이므로, 결과가 비어 있거나 일부만 반환되는 경우를 염두에 두고 설계하세요.

Instagram Following List API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

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

Instagram Following List API — 자주 묻는 질문

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

Following은 공개된 팔로잉 관계에서 개별 공개 프로필 레코드를 반환하고, Followers Count는 관계 목록 없이 프로필 단위의 오디언스 및 게시물 총수를 반환합니다.

레코드에는 ID, 사용자 이름, 표시 이름, 프로필 URL, 아바타 URL, 인증·비공개 신호, 공개된 수치, collected_at, source_username, relationship, position이 포함될 수 있습니다.

네. usernames 배열에 공개 사용자 이름을 하나 이상 제출하세요. 해당 필드가 있으면 source_username으로 어떤 입력 계정에서 각 관계 레코드가 나왔는지 알 수 있습니다.

공개 프로필에서 볼 수 있는 관계만 반환할 수 있습니다. 비공개, 제한됨, 삭제됨, 로그인 전용 관계 데이터는 일부만 반환되거나 결과가 비어 있을 수 있습니다.

완료된 작업을 페이지당 최대 500건의 limit으로 읽고, results.has_more가 true인 동안 다음 요청에 results.next_cursor를 전달하세요.

성공적으로 정규화된 결과는 레코드 1건당 0.3 크레딧이 청구되며 기본 요금은 없습니다. 결과가 비어 있으면 기본 요금만 적용하는 정책에 따라 0 크레딧입니다.