Instagram Comments
Instagram 댓글은 게시물과 릴스에 달린 공개 반응으로, 텍스트, 작성자 정보, 타임스탬프, 공개된 좋아요, 답글 수, 미디어, 원본 링크를 담고 있습니다. 이러한 대화 신호는 의견 분석, 모더레이션 검토, 커뮤니티 조사, 캠페인 리포트에 활용할 수 있습니다.
Instagram Comments API 주요 기능
- 여러 게시물 댓글 수집공개 Instagram 게시물 URL을 하나 이상 한 번의 요청으로 제출해 댓글을 수집합니다.
- 정규화된 댓글 레코드댓글 ID, 텍스트, 작성자 식별 정보, 게시 시각, 수집 시각, 원본 URL을 일관된 구조로 반환합니다.
- 공개된 토론 지표공개된 좋아요 수와 답글 수를 정규화된 metrics 필드로 제공해 토론 활성도를 비교할 수 있습니다.
- 추적 가능한 대화 맥락결합, 중복 제거, 대화 분석을 위해 게시물, 상위 댓글, 제출한 입력 값에 대한 참조 정보를 보존합니다.
- 공개 데이터 범위비공개, 제한됨, 삭제됨, 로그인 전용 댓글은 결과 범위에서 제외합니다.
Instagram Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 쉼표나 줄바꿈으로 구분한 공개 Instagram 게시물 URL입니다. |
Instagram Comments API 사용 방법
공개 Instagram 게시물 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 댓글 레코드를 커서 페이지네이션으로 읽습니다.
- 공개 Instagram 게시물 URL을 하나 이상 준비합니다.
- urls를 /v1/instagram/comments로 POST합니다.
- status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, 레코드가 더 있으면 results.next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/instagram/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.instagram.com/p/POST_CODE/"]}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Instagram Comments API 추천 활용 사례
- 소비자 반응 모니터링: 공개 댓글의 텍스트, 이모지, 공개된 참여 신호를 분석해 선택한 게시물에 대한 오디언스 반응을 추적합니다.
- 트렌드와 기회 발굴: 공개 토론에서 떠오르는 주제, 제품 피드백, 기능 요청, 반복되는 질문, 초기 수요 신호를 찾아냅니다.
- 캠페인 반응 분석: 일관된 댓글 레코드로 캠페인 게시물, 크리에이티브, 출시, 공지에 대한 공개 반응을 비교합니다.
- 브랜드·평판 모니터링: 선택한 공개 게시물을 둘러싼 칭찬, 불만, 반복되는 우려, 오디언스 반응의 변화를 추적합니다.
- 경쟁사·크리에이터 조사: 경쟁사와 크리에이터 게시물의 공개 토론을 살펴 주제, 질문, 공개된 참여 지표를 비교합니다.
- 참여도 높은 오디언스 발굴: 공개된 작성자 정보, 댓글 좋아요, 답글 수로 토론을 이끄는 댓글과 참여자를 파악합니다.
- 분석 및 데이터 파이프라인: 정규화된 댓글 레코드를 텍스트 분석, 리포팅, 대시보드, 웨어하우스 워크플로에 적재합니다.
Instagram Comments API 활용 팁
- 분석하려는 게시물은 정식(canonical) Instagram 게시물 URL로 제출하세요.
- 제출하는 게시물 수를 늘리기 전에 소량의 URL 묶음으로 먼저 수집 범위를 확인하세요.
- 로그인이나 네트워크 중단이 생기면 다시 제출하지 말고, 받아 둔 task_id로 같은 작업의 폴링을 이어가세요.
- 작업이 성공한 뒤에는 첫 결과 페이지가 전부라고 가정하지 말고, has_more가 false가 될 때까지 results.next_cursor를 따라가세요.
- 안정적인 결합과 중복 제거를 위해 댓글 id를 post_id, post_url, parent_comment_id, input_url과 함께 저장하세요.
- 다운스트림 스키마는 댓글 id, text, author, created_at, collected_at, 원본 참조 정보를 중심으로 설계하고, media와 metrics는 보강용 필드로 활용하세요.
- 활발한 토론의 순위를 매길 때는 replies_count를, 댓글 간 관계를 유지할 때는 parent_comment_id를 사용하세요.
- 일시적인 오류에는 횟수 제한이 있는 지수 백오프를 적용하고, 429 응답에 retry-after가 있으면 그 값을 따르세요.
- 댓글 텍스트를 화면에 표시하거나 자동 분석 워크플로로 보내기 전에 검증하고 이스케이프 처리하세요.
- 원 게시물의 텍스트, 미디어, 게시 시각, 게시물 단위 참여 정보도 필요하면 Posts API를 함께 사용하세요.
관련 API
Instagram Comments API 외에 Instagram의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Instagram Followers Count API — 공개 프로필 정보와 공개된 팔로워·팔로잉·게시물 수를 가져옵니다.
- Instagram Posts API — 사용자 이름으로 공개 게시물, 미디어, 해시태그, 멘션, 타임스탬프, 참여도를 수집합니다.
- Instagram Reels API — 사용자 이름으로 공개 릴스, 미디어, 오디오, 해시태그, 멘션, 참여도를 수집합니다.
- Instagram Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 링크, 계정 속성, 카테고리, 공개된 수치를 가져옵니다.
- Instagram Post Info API — 알고 있는 공개 게시물, 릴스, 레거시 IGTV URL을 조회하며, 캡션, 작성자 정보, 미디어, 타임스탬프, 공개된 참여도, 입력 맥락을 포함합니다.
- Instagram Comment Replies API — 게시물 URL과 댓글 ID로 특정 댓글의 답글을 수집하며, 답글 텍스트, 작성자, 좋아요, 타임스탬프를 포함합니다.
- Instagram Search API
- Instagram Followers List API
- Instagram Following List 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 Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API