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를 폴링한 뒤, 정규화된 팔로잉 프로필을 커서 페이지네이션으로 읽습니다.
- 앞의 @ 없이 공개 Instagram 사용자 이름을 하나 이상 준비합니다.
- usernames와 선택 항목인 1~2,000 사이의 results_limit을 /v1/instagram/following-list로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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_cursorInstagram Following List API 추천 활용 사례
- 크리에이터 네트워크 매핑: 선택한 계정이 어떤 공개 크리에이터, 퍼블리셔, 조직을 팔로우하는지 검토할 수 있는 지도를 만듭니다.
- 브랜드 계정 조사: 브랜드, 캠페인, 지역, 경쟁사 계정 간에 공개된 팔로잉 관계를 비교합니다.
- 파트너십 후보 발굴: 파트너십 프로그램과 관련된 계정의 팔로잉 목록에 나타나는 공개 프로필을 찾아냅니다.
- 프로필 디렉터리 정보 보강: 정식 URL, 표시 이름, 아바타, 계정 신호, 관계 출처 정보를 내부 디렉터리에 추가합니다.
- 관계 변화 추적: 타임스탬프가 있는 스냅샷을 저장하고 실행 간에 안정적인 프로필 ID를 비교해 추가·제거된 항목을 검토합니다.
Instagram Following List API 활용 팁
- 제출하기 전에 모든 사용자 이름의 앞 @를 제거하세요. 제공처 입력은 일반 사용자 이름으로 정규화됩니다.
- 처음에는 results_limit을 작게 잡고, 워크플로에 더 큰 공개 관계 집합이 필요할 때만 늘리세요.
- 같은 팔로우 대상 프로필이 여러 출처 계정에서 나타날 수 있으므로 프로필 ID를 extra.source_username과 함께 저장하세요.
- 아바타, 계정 수치, 인증 신호, position이 없는 경우는 공개 결과에서 흔한 변동으로 취급하세요.
- 비공개, 제한됨, 삭제됨, 로그인 전용 관계는 지원 범위 밖이므로, 결과가 비어 있거나 일부만 반환되는 경우를 염두에 두고 설계하세요.
관련 API
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 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