instagram/
post-likers

공개 Instagram 게시물 URL로 좋아요 목록의 계정을 수집하고, 계정별 사용자 이름, 표시 이름, 프로필 이미지, 인증·비공개 상태를 반환합니다.

Instagram Post Likers API

게시물 URL 입력
좋아요 누른 계정
최대 1,000개 계정
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Post Likers

좋아요 목록은 게시물의 좋아요 수를 눌렀을 때 Instagram이 보여 주는 계정의 모음으로, 사진·릴스·동영상에 누가 반응했는지 직접 확인할 수 있습니다. 이 계정들을 분석하면 게시물이 실제로 어떤 오디언스에게 도달했는지, 반응한 계정 중 눈에 띄는 프로필은 무엇인지, 게시물이나 캠페인마다 반응층이 어떻게 다른지 파악할 수 있습니다.

Instagram Post Likers API 주요 기능

  • 게시물 링크로 좋아요 계정 수집게시물, 릴스, IGTV URL을 붙여 넣으면 Instagram이 좋아요를 누른 것으로 표시하는 계정을 가져옵니다.
  • 계정별 기본 프로필 정보계정마다 사용자 ID, 사용자 이름, 표시 이름, 프로필 링크, 프로필 이미지, 인증·비공개 여부가 related_actor 안에 담겨 있습니다.
  • 좋아요로 표시된 레코드모든 레코드에 relationship = liker가 들어 있어, 별도 매핑 없이 팔로워·팔로잉 데이터와 같은 파이프라인에서 함께 다룰 수 있습니다.

Instagram Post Likers API 매개변수

매개변수필수설명
url필수공개 게시물, 릴스, IGTV 동영상의 링크입니다.
results_limit선택반환할 좋아요 계정 수로, 1~1000 사이의 값입니다. 기본값은 100입니다.

Instagram Post Likers API 사용 방법

게시물 링크를 붙여 넣고 작업을 실행한 뒤, 결과에서 좋아요를 누른 계정을 읽습니다.

  1. 공개 게시물, 릴스, IGTV 동영상의 URL을 복사합니다.
  2. url과 선택 값인 results_limit를 /v1/instagram/post-likers로 POST합니다.
  3. GET /v1/tasks/{task_id}가 status succeeded를 반환할 때까지 기다립니다.
  4. results.items에서 좋아요를 누른 계정을 읽고, results.has_more가 true인 동안 results.next_cursor를 따라가며 가져옵니다.
curl -X POST "https://api.socq.ai/v1/instagram/post-likers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.instagram.com/p/DRhvwVLAHAG/","results_limit":100}'

# Each result is one liker, with the account details in related_actor.
# Read them from GET /v1/tasks/{task_id}.

Instagram Post Likers API 추천 활용 사례

  • 캠페인 오디언스 점검: 협찬 게시물에 좋아요를 누른 계정을 가져와 게시물이 실제로 어떤 유형의 계정에 도달했는지 확인합니다.
  • 단골 팬 찾기: 여러 게시물의 좋아요 계정을 수집하고 사용자 ID를 대조해, 반복해서 좋아요를 누르는 사람을 찾아냅니다.
  • 주목할 만한 반응 계정 발굴: is_verified로 좋아요 계정을 필터링해, 게시물에 좋아요를 누른 크리에이터·브랜드·공인을 골라냅니다.

Instagram Post Likers API 활용 팁

  • 게시물 간 좋아요 계정을 대조할 때는 related_actor.id를 사용하세요. 사용자 이름이 바뀌어도 이 값은 그대로 유지됩니다.
  • 게시물의 전체 좋아요 수는 Instagram Post Info에서 가져오고, 좋아요 목록은 Instagram이 표시하기로 한 계정의 목록으로 보세요.
  • 팔로워 수와 소개글도 함께 필요하면 좋아요 계정의 사용자 이름을 Instagram Profiles로 보내세요.

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

  • Instagram Followers Count API — 공개 프로필 정보와 공개된 팔로워·팔로잉·게시물 수를 가져옵니다.
  • Instagram Comments API — 게시물 URL에서 공개 댓글, 작성자, 타임스탬프, 좋아요, 답글을 수집합니다.
  • Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
  • Instagram Followers List API — 출처 계정과 관계 맥락을 포함한 공개 팔로워 프로필 레코드를 수집합니다.
  • Instagram Following List API — Instagram 계정이 팔로우하는 공개 프로필을 수집하며, 계정 정보, 관계 맥락, 공개된 계정 수치를 포함합니다.
  • Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Instagram Post Likers API — 자주 묻는 질문

Instagram Post Likers API는 공개 Instagram 게시물, 릴스, IGTV 동영상의 URL을 입력받아 좋아요 목록의 계정을 수집하는 프로그래밍 인터페이스입니다. 계정마다 사용자 ID, 사용자 이름, 표시 이름, 프로필 링크, 프로필 이미지, 인증·비공개 여부를 반환합니다.

네. 게시물 URL을 보내면 좋아요 목록의 계정을 작업 결과로 반환하며, 각 계정에는 사용자 이름, 표시 이름, 프로필 이미지가 포함됩니다.

네. 공개 게시물, 릴스, IGTV 링크라면 모두 사용할 수 있으며, /p/나 /reel/ 앞에 계정 이름이 붙은 링크도 지원합니다.

related_actor.username에 있으며, 레코드의 url 필드는 해당 계정의 프로필로 바로 연결됩니다.

반환되는 좋아요 계정 1개당 0.3 크레딧이 차감됩니다.