instagram/
comments

하나 이상의 게시물 URL에서 공개 Instagram 댓글을 수집하여, 정규화된 텍스트, 작성자 정보, 타임스탬프, 게시물 참조 정보, 공개된 좋아요 수와 답글 수를 반환합니다.

Instagram Comments API

댓글
공개 데이터
게시물 URL
결과당 0.3 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Instagram Comments

Instagram 댓글은 게시물과 릴스에 달린 공개 반응으로, 텍스트, 작성자 정보, 타임스탬프, 공개된 좋아요, 답글 수, 미디어, 원본 링크를 담고 있습니다. 이러한 대화 신호는 의견 분석, 모더레이션 검토, 커뮤니티 조사, 캠페인 리포트에 활용할 수 있습니다.

Instagram Comments API 주요 기능

  • 여러 게시물 댓글 수집공개 Instagram 게시물 URL을 하나 이상 한 번의 요청으로 제출해 댓글을 수집합니다.
  • 정규화된 댓글 레코드댓글 ID, 텍스트, 작성자 식별 정보, 게시 시각, 수집 시각, 원본 URL을 일관된 구조로 반환합니다.
  • 공개된 토론 지표공개된 좋아요 수와 답글 수를 정규화된 metrics 필드로 제공해 토론 활성도를 비교할 수 있습니다.
  • 추적 가능한 대화 맥락결합, 중복 제거, 대화 분석을 위해 게시물, 상위 댓글, 제출한 입력 값에 대한 참조 정보를 보존합니다.
  • 공개 데이터 범위비공개, 제한됨, 삭제됨, 로그인 전용 댓글은 결과 범위에서 제외합니다.

Instagram Comments API 매개변수

매개변수필수설명
urls필수쉼표나 줄바꿈으로 구분한 공개 Instagram 게시물 URL입니다.

Instagram Comments API 사용 방법

공개 Instagram 게시물 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 댓글 레코드를 커서 페이지네이션으로 읽습니다.

  1. 공개 Instagram 게시물 URL을 하나 이상 준비합니다.
  2. urls를 /v1/instagram/comments로 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /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를 함께 사용하세요.

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 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Instagram Comments API — 자주 묻는 질문

Instagram Comments API는 하나 이상의 Instagram 게시물 URL에서 공개적으로 볼 수 있는 댓글을 수집합니다. 정규화된 텍스트, 작성자 정보, 타임스탬프, 게시물 참조 정보, 미디어, 공개된 좋아요 수와 답글 수를 반환합니다.

urls 배열에 정식 Instagram 게시물 URL을 하나 이상 제출합니다. URL마다 줄을 바꾸거나 쉼표로 구분하세요.

정규화된 레코드마다 id, text, author, url, metrics, media, created_at, collected_at과 함께 post_id, post_url, parent_comment_id, input_url 같은 원본 참조 정보가 제공됩니다.

네. 같은 요청의 urls 배열에 공개 게시물 URL을 여러 개 전달하면 됩니다.

replies_count로 토론 활성도를 비교하고, parent_comment_id로 댓글을 상위 맥락과 연결하세요.

댓글 텍스트, 작성자 정보, 타임스탬프, 좋아요, 답글 수, 게시물 참조 정보를 활용해 반응 모니터링, 트렌드 발굴, 캠페인 분석, 오디언스 조사, 리포팅에 사용할 수 있습니다.

아니요. 계정 연동은 필요 없습니다. API 키로 요청을 인증하고, 수집하려는 Instagram 게시물 URL을 제출하면 됩니다.

작업 엔드포인트에서 정규화된 JSON 결과를 읽은 뒤, 분석 도구, 대시보드, 데이터베이스, 텍스트 처리 작업, 리포팅 파이프라인으로 전달하세요.

작업이 성공한 뒤 /v1/tasks/{task_id}?limit=50을 읽고, has_more가 false가 될 때까지 results.next_cursor로 이어서 가져옵니다.

반환된 댓글 결과 1건당 0.3 크레딧이 차감되며, 결과가 비어 있으면 요금이 부과되지 않습니다. 실제 결과 수에 따른 최종 요금은 작업 상세에서 확인할 수 있습니다.