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 사용 방법
게시물 링크를 붙여 넣고 작업을 실행한 뒤, 결과에서 좋아요를 누른 계정을 읽습니다.
- 공개 게시물, 릴스, IGTV 동영상의 URL을 복사합니다.
- url과 선택 값인 results_limit를 /v1/instagram/post-likers로 POST합니다.
- GET /v1/tasks/{task_id}가 status succeeded를 반환할 때까지 기다립니다.
- 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로 보내세요.
관련 API
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 Posts API
- Instagram Reels API
- Instagram Search API
- Instagram Hashtag Posts API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts 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