instagram/
followers-count

사용자 이름 또는 프로필 URL로 공개 Instagram 프로필 정보를 조회하여, 정규화된 식별 정보, 인증 여부, 공개된 팔로워·팔로잉·게시물 수를 반환합니다.

Instagram Followers Count API

프로필 수치
공개 데이터
일괄 처리 지원
결과당 0.52 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Followers Count

Instagram Followers Count는 공개된 팔로워·팔로잉·게시물 총수와 공개 식별 정보, 인증 신호를 담은 특정 시점의 프로필 스냅샷입니다. 이러한 필드는 오디언스 규모 비교, 크리에이터 벤치마킹, 디렉터리 정보 보강, 반복 수집을 통한 성장 모니터링에 활용할 수 있습니다.

Instagram Followers Count API 주요 기능

  • 공개된 프로필 수치공개적으로 접근할 수 있는 Instagram 프로필에서 공개된 팔로워·팔로잉·게시물 수를 읽습니다.
  • 사용자 이름 및 URL 입력공개 사용자 이름이나 프로필 URL을 하나 이상 받으며, 두 입력 유형 중 하나를 사용한 일괄 처리도 지원합니다.
  • 수치 전용 결과전체 팔로워·팔로잉 목록이 아니라 수치에 초점을 맞춘 레코드를 반환합니다.
  • 프로필 식별 필드수치 레코드마다 공개 표시 이름, 프로필 URL, 아바타, 인증 상태, 비공개 여부를 함께 담습니다.
  • 공개 데이터 범위비공개, 삭제됨, 제한됨, 로그인 전용 프로필 데이터는 응답 범위에서 제외합니다.

Instagram Followers Count API 매개변수

매개변수필수설명
usernames선택@ 없는 공개 Instagram 사용자 이름을 쉼표나 줄바꿈으로 구분한 값입니다. usernames 또는 urls 중 하나를 지정하세요.
urls선택공개 Instagram 프로필 URL이며, 선택 값입니다. urls 또는 usernames 중 하나를 지정하세요.
results_limit선택수집 작업이 요청할 최대 레코드 수입니다. 양의 정수여야 합니다.

Instagram Followers Count API 사용 방법

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

  1. @ 없는 공개 Instagram 사용자 이름 또는 공개 프로필 URL을 하나 이상 준비합니다.
  2. usernames 또는 urls와 선택 항목인 results_limit을 /v1/instagram/followers-count로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, 레코드가 더 있으면 results.next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/instagram/followers-count" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo","instagram"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Instagram Followers Count API 추천 활용 사례

  • 크리에이터 성장 모니터링: 추적 중인 크리에이터의 공개 팔로워·팔로잉 수를 새로 가져와, 예약 실행 간의 변화를 비교합니다.
  • 브랜드·경쟁사 추적: 브랜드, 경쟁사, 캠페인, 파트너 계정의 공개 프로필 수치 변화를 모니터링합니다.
  • 오디언스 분석: 어떤 공개 프로필에 더 깊은 정보 보강이 필요한지 판단하기 전에, 수치 지표를 가벼운 신호로 활용합니다.
  • CRM·크리에이터 데이터베이스 정보 보강: 기존 계정 레코드에 공개 수치 지표, 프로필 URL, 표시 이름, 인증 상태를 추가합니다.
  • 리포트용 스냅샷: 결과마다 collected_at을 저장해 대시보드에서 각 수치 갱신의 날짜와 출처를 보여 줄 수 있습니다.

Instagram Followers Count API 활용 팁

  • 이 엔드포인트는 수치 중심으로 사용하세요. 공개 콘텐츠 레코드도 필요하면 Posts 또는 Reels API를 사용하세요.
  • 공개 수치는 갱신 사이에 바뀔 수 있으므로 모든 레코드의 collected_at을 저장하세요.
  • 배치 크기를 보수적으로 잡고, 공개 결과를 일시적으로 가져올 수 없으면 백오프를 두고 재시도하세요.
  • posts_count, 아바타, 인증 필드가 없는 경우는 공개 결과에서 흔한 변동으로 취급하세요.
  • 비공개 프로필, 전체 팔로워 목록, 로그인 전용 Instagram 데이터를 전제로 워크플로를 설계하지 마세요.

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

  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
  • Instagram Followers List API — 출처 계정과 관계 맥락을 포함한 공개 팔로워 프로필 레코드를 수집합니다.
  • Instagram Following List API — Instagram 계정이 팔로우하는 공개 프로필을 수집하며, 계정 정보, 관계 맥락, 공개된 계정 수치를 포함합니다.
  • Instagram Similar Accounts API — 사용자 이름과 비슷한 계정으로 Instagram이 추천하는 계정 목록을 가져오며, 사용자 이름, 이름, 프로필 이미지, 인증 상태를 포함합니다.
  • Instagram Post Likers API — 게시물 URL에서 공개된 좋아요 목록의 계정을 가져오며, 사용자 이름, 이름, 프로필 이미지, 인증 상태를 포함합니다.

다른 플랫폼 둘러보기

Instagram 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Followers Count API — 자주 묻는 질문

Instagram Followers Count API는 Instagram 사용자 이름 또는 프로필 URL로 공개적으로 볼 수 있는 프로필 정보를 조회합니다. 정규화된 식별 정보, 인증 상태, 팔로워·팔로잉·게시물 수를 반환합니다.

아니요. 이 API는 followers_count, following_count 같은 수치 지표를 위한 것이며, 개별 팔로워나 팔로잉 사용자를 내보내는 용도가 아닙니다.

일반적으로 profile ID, username, profile_url, display_name, avatar, followers_count, following_count, posts_count, verified, private, collected_at이 포함됩니다. 공개 프로필에서 노출하지 않는 선택 필드는 없을 수 있습니다.

아니요. 공개 프로필 수집에는 애플리케이션이 Instagram 계정 쿠키나 브라우저 세션을 제공할 필요가 없습니다.

아니요. 이 API는 공개 프로필 결과만 다루므로, 비공개, 삭제됨, 제한됨, 로그인 전용 프로필은 제한된 데이터만 반환하거나 레코드가 없을 수 있습니다.

수치는 요청 시점에 수집된 가장 최근의 공개 프로필 결과를 반영합니다. Instagram이 공개 카운터를 계속 갱신하고 캐시하므로 약간의 차이가 생길 수 있습니다.

배치 크기를 보수적으로 잡고, 일시적인 실패는 백오프를 두고 재시도하며, 같은 프로필을 높은 빈도로 반복해서 새로 가져오지 마세요. 공개 결과를 가져올 수 없는 상황은 워크플로가 처리해야 하는 정상적인 경우로 취급하세요.