instagram/
similar-users

공개 프로필의 사용자 이름으로 Instagram이 함께 추천하는 계정을 찾고, 추천 계정별 사용자 이름, 표시 이름, 프로필 이미지, 인증 여부를 반환합니다.

Instagram Similar Accounts API

사용자 이름 입력
추천 계정
인증 여부
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Similar Accounts

유사 계정은 Instagram이 특정 계정 옆에 추천하는 프로필로, 계정마다 사용자 이름, 표시 이름, 프로필 이미지, 인증 여부가 함께 표시됩니다. 이를 하나로 묶어 보면 Instagram이 어떤 계정을 브랜드나 크리에이터의 동종 계정으로 보는지 알 수 있어, 특정 분야와 그 안의 경쟁 구도를 빠르게 파악하는 데 유용합니다.

Instagram Similar Accounts API 주요 기능

  • 사용자 이름 하나로 추천 계정 조회공개 사용자 이름 하나를 입력하면 Instagram이 함께 추천하는 계정을 반환하며, 기준 계정은 extra.source_username에 기록됩니다.
  • 각 계정의 기본 정보추천 계정마다 사용자 ID, 사용자 이름, 표시 이름, 프로필 링크, 프로필 이미지와 함께 인증 계정·비공개 계정 여부 플래그가 포함됩니다.
  • 원하는 개수 지정results_limit를 1~100 사이로 설정할 수 있으며, 지정하지 않으면 최대 50개의 추천 계정을 받습니다.

Instagram Similar Accounts API 매개변수

매개변수필수설명
username필수추천 계정을 알고 싶은 계정의 사용자 이름입니다. 앞의 @는 생략할 수 있습니다.
results_limit선택반환할 추천 계정 수로, 1~100 사이의 값입니다. 기본값은 50입니다.

Instagram Similar Accounts API 사용 방법

기준 계정을 고르고 사용자 이름을 보낸 뒤, 작업이 끝나면 추천 계정을 읽습니다.

  1. 이미 잘 알고 있는 브랜드나 크리에이터처럼 기준이 될 계정을 고릅니다.
  2. {"username": "instagram", "results_limit": 50}을 /v1/instagram/similar-users로 POST합니다.
  3. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 확인한 뒤 results.items를 읽습니다.
  4. 더 많은 목록이 필요하면 results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/similar-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"instagram","results_limit":50}'

# Keep the task_id from the response,
# then read the suggested accounts from GET /v1/tasks/{task_id}.

Instagram Similar Accounts API 추천 활용 사례

  • 경쟁사 매핑: 자사 브랜드 계정에서 시작해, 추천 계정을 바탕으로 Instagram이 내 계정과 나란히 보여 주는 프로필을 목록으로 만듭니다.
  • 인플루언서 발굴: 이미 성과가 좋은 크리에이터를 기준으로 검색해, 유사 계정을 다음 캠페인 후보로 검토합니다.
  • 니치 시장 리서치: 같은 카테고리의 여러 계정에서 추천 계정을 조회하고, 반복해서 등장하는 사용자 이름을 집계해 그 분야의 중심에 있는 프로필을 찾습니다.

Instagram Similar Accounts API 활용 팁

  • 후보를 추리기 전에 추천 계정의 사용자 이름을 Instagram Profiles로 보내 팔로워 수, 소개글, 게시물 수를 보강하세요.
  • 다음 단계에서 게시물이나 스토리를 수집할 계획이라면 is_private가 true인 계정은 따로 빼 두세요.
  • 여러 번 실행한 결과를 합칠 때는 extra.source_username을 보관해, 어떤 기준 계정에서 나온 추천인지 구분하세요.

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

  • Instagram Followers Count API — 공개 프로필 정보와 공개된 팔로워·팔로잉·게시물 수를 가져옵니다.
  • Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
  • Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
  • Instagram Followers List API — 출처 계정과 관계 맥락을 포함한 공개 팔로워 프로필 레코드를 수집합니다.
  • Instagram Following List API — Instagram 계정이 팔로우하는 공개 프로필을 수집하며, 계정 정보, 관계 맥락, 공개된 계정 수치를 포함합니다.
  • Instagram Stories API — 사용자 이름으로 공개 계정이 현재 게시 중인 스토리를 수집하며, 스토리 미디어, 게시 시각, 만료 시각을 포함합니다.

다른 플랫폼 둘러보기

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

Instagram Similar Accounts API — 자주 묻는 질문

Instagram Similar Accounts API는 공개 계정의 사용자 이름을 입력받아 Instagram이 함께 추천하는 계정을 가져오는 프로그래밍 인터페이스입니다. 추천 계정마다 사용자 ID, 사용자 이름, 표시 이름, 프로필 링크, 프로필 이미지, 인증·비공개 여부를 반환합니다.

경쟁사의 사용자 이름을 보내면, Instagram이 해당 프로필 옆에 추천하는 계정을 작업 결과로 반환합니다.

results_limit로 지정하며 최대 100개입니다. 기본값은 50개입니다.

추천 계정의 사용자 이름을 Instagram Profiles API로 보내면 계정별 팔로워·팔로잉·게시물 수를 반환합니다.

반환되는 추천 계정 1개당 0.5 크레딧이 차감되므로, results_limit가 요청 한 번의 최대 비용도 결정합니다.