instagram/
profiles

하나 이상의 사용자 이름으로 공개 Instagram 프로필을 조회하고, 정규화된 계정 정보, 소개글, 링크, 계정 속성, 공개된 팔로워·팔로잉·게시물 수를 반환합니다.

Instagram Profiles API

알고 있는 사용자 이름으로 조회
프로필 메타데이터
계정 스냅샷
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Profiles

Instagram 프로필은 사용자 이름, 표시 이름, 소개글, 프로필 이미지, 외부 링크, 계정 카테고리, 인증·비공개 상태, 공개된 팔로워·팔로잉·게시물 수를 담은 공개 계정 페이지입니다. 이러한 식별 정보, 분류, 오디언스 지표는 프로필 정보 보강, 계정 비교, 목록 관리, 특정 시점 모니터링에 활용할 수 있습니다.

Instagram Profiles API 주요 기능

  • 알고 있는 사용자 이름으로 조회지정한 하나 이상의 공개 사용자 이름을 조회하여, 찾은 계정마다 정규화된 프로필 레코드를 최대 1건씩 반환합니다.
  • 계정 정보와 프로필 링크계정 ID, 사용자 이름, 표시 이름, 정식 프로필 URL, 프로필 이미지, 소개글, 외부 URL, 소개글에 포함된 공개 링크를 반환합니다.
  • 계정 분류와 상태공개된 인증·비공개 상태와 함께 공개 카테고리, 비즈니스 계정, 프로페셔널 계정 여부를 그대로 보존합니다.
  • 공개된 프로필 수치팔로워·팔로잉·게시물 수를 metrics 아래에 묶고, 정규화된 레코드에 collected_at 타임스탬프를 기록합니다.

Instagram Profiles API 매개변수

매개변수필수설명
usernames필수공개 Instagram 사용자 이름의 목록으로, 비어 있지 않아야 하는 필수 값입니다. 앞에 붙은 @는 허용되며 조회 전에 제거됩니다.

Instagram Profiles API 사용 방법

알고 있는 사용자 이름을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 조회된 공개 프로필 레코드를 커서 페이지네이션으로 읽습니다.

  1. 이미 알고 있는 공개 계정을 담은, 비어 있지 않은 usernames 배열을 준비합니다.
  2. usernames 배열을 /v1/instagram/profiles로 POST하고, 반환된 task_id를 저장합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 읽고, results.has_more가 true이면 results.next_cursor를 전달해 다음 결과를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram","@natgeo"]}'

# Poll GET /v1/tasks/{task_id}?limit=50
# Read data.results.items and continue with results.next_cursor while results.has_more is true

Instagram Profiles API 추천 활용 사례

  • 알고 있는 계정 정보 보강: Instagram 사용자 이름이 이미 들어 있는 레코드에 고유 ID, 표시 이름, 소개글, 프로필 이미지, 정식 URL, 공개 링크를 추가합니다.
  • 선택한 계정 비교: 정해 둔 사용자 이름 그룹을 대상으로 공개된 인증 상태, 카테고리, 계정 유형 신호, 팔로워·팔로잉·게시물 수를 비교합니다.
  • 프로필 스냅샷 모니터링: 반복 수집한 공개 계정 수치를 collected_at과 함께 저장해, 특정 시점의 프로필 레코드를 서로 비교합니다.

Instagram Profiles API 활용 팁

  • 이 엔드포인트는 usernames 배열만 받으므로, 프로필 URL이나 검색어가 아니라 사용자 이름을 제출하세요.
  • name과 @name이 별개의 조회로 처리되지 않도록, 제출 전에 앞의 @를 제거하고 중복된 핸들을 정리하세요.
  • 사용할 수 없거나 이름이 바뀌었거나 접근할 수 없는 계정은 프로필 레코드가 생성되지 않을 수 있으므로, 반환된 사용자 이름을 입력 목록과 대조하세요.
  • 누락된 수치와 계정 속성은 0이나 false로 바꾸지 말고 알 수 없는 값으로 보존하세요.
  • 반복 수집한 프로필 스냅샷을 비교할 때는 metrics 옆에 collected_at을 함께 저장하세요.

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

  • Instagram Followers Count API — 공개 프로필 정보와 공개된 팔로워·팔로잉·게시물 수를 가져옵니다.
  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
  • Instagram Followers List API — 출처 계정과 관계 맥락을 포함한 공개 팔로워 프로필 레코드를 수집합니다.
  • Instagram Following List API — Instagram 계정이 팔로우하는 공개 프로필을 수집하며, 계정 정보, 관계 맥락, 공개된 계정 수치를 포함합니다.
  • Instagram Account Age Checker API — 계정이 Instagram에 가입한 시기, 기반 국가, 인증 시기, 사용자 이름 변경 횟수를 확인합니다.

다른 플랫폼 둘러보기

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

Instagram Profiles API — 자주 묻는 질문

Instagram Profiles API는 필수 usernames 배열에서 조회 가능한 사용자 이름마다 정규화된 공개 프로필을 하나씩 가져오는 프로그래밍 인터페이스입니다. 계정 정보, 소개글과 링크, 인증·비공개 여부, 계정 카테고리, 공개된 팔로워·팔로잉·게시물 수를 반환합니다.

usernames에 비어 있지 않은 문자열을 하나 이상 제출합니다. 앞에 @가 붙은 값도 사용할 수 있습니다. 프로필 URL, 키워드 검색어, results_limit, 게시물 필터는 지원하지 않습니다.

레코드에는 계정 ID, 사용자 이름, 표시 이름, 프로필 URL과 이미지, 소개글, 외부 링크와 소개글 링크, 인증·비공개 여부, 카테고리, 비즈니스·프로페셔널 계정 신호, 공개된 수치, collected_at이 포함될 수 있습니다.

존재하지 않거나, 이름이 바뀌었거나, 사용할 수 없거나, 접근할 수 없는 계정은 레코드가 생성되지 않을 수 있고, 공개된 원본에서 제공되지 않는 필드는 비어 있을 수 있습니다. 같은 작업에 포함된 다른 유효한 사용자 이름은 정상적으로 프로필 레코드를 반환합니다.

아니요. 이미 알고 있는 사용자 이름의 프로필 레코드를 조회하는 엔드포인트입니다. 계정 탐색에는 Instagram Search를, 관계 구성원 목록에는 Followers 또는 Following 엔드포인트를 사용하세요.

정규화된 프로필 결과 1건이 반환될 때마다 0.6 크레딧이 차감됩니다. 결과가 생성되지 않은 미확인 사용자 이름에는 설정된 빈 결과 정책이 적용됩니다.