facebook/
comments

하나 이상의 게시물 URL에서 공개 Facebook 댓글을 수집하고, 정규화된 텍스트, 작성자 정보, 타임스탬프, 공개된 참여도, 미디어, 원본 링크를 반환합니다.

Facebook Comments API

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

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

README

SocQ 작성 · 업데이트

Facebook Comments

Facebook 댓글은 게시물에 달린 공개 응답으로, 텍스트, 작성자 정보, 게시 시각, 공개된 좋아요 수, 답글 수, 미디어, 원본과의 관계를 담고 있습니다. 이러한 토론 신호는 오디언스 피드백 분석, 반복되는 질문 조사, 커뮤니티 모니터링, 콘텐츠 보고에 활용할 수 있습니다.

Facebook Comments API 주요 기능

  • 여러 게시물의 댓글 수집한 번의 요청으로 하나 이상의 Facebook 게시물 URL에서 공개 댓글을 수집합니다.
  • 정규화된 댓글 레코드댓글 ID, 텍스트, 작성자 정보, 타임스탬프, 공개된 참여도, 미디어, 원본 링크를 일관된 구조로 반환합니다.
  • 추적 가능한 대화 맥락조인, 중복 제거, 감사 추적에 쓸 수 있도록 게시물, 상위 댓글, 제출한 입력에 대한 참조를 보존합니다.
  • 공개 데이터 범위비공개, 제한, 삭제, 로그인 전용 콘텐츠는 결과 범위에 포함하지 않습니다.

Facebook Comments API 매개변수

매개변수필수설명
urls필수공개 Facebook 게시물 URL로, 쉼표 또는 줄바꿈으로 구분합니다.

Facebook Comments API 사용 방법

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

  1. 공개 Facebook 게시물 URL을 하나 이상 준비합니다.
  2. urls 배열을 /v1/facebook/comments로 POST합니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, 레코드가 더 있으면 results.next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/facebook/comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/facebook/posts/POST_ID"]}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Comments API 추천 활용 사례

  • 고객 피드백·감성 분석: 공개 댓글 텍스트를 분석해 의견, 제품 피드백, 질문, 반복되는 주제를 파악합니다.
  • 캠페인 콘텐츠 최적화: 캠페인 게시물 전반의 댓글 감성과 공개된 참여도를 비교해 메시지와 소재 결정을 다듬습니다.
  • 브랜드 대화 모니터링: 선택한 브랜드 게시물의 공개 댓글을 주제, 시간, 작성자, 참여 신호별로 정리합니다.
  • 경쟁사 오디언스 조사: 경쟁사 게시물에 달린 공개 반응을 살펴보고 오디언스의 관심사, 질문, 참여 패턴을 비교합니다.
  • 오디언스 주제 발굴: 댓글 텍스트와 타임스탬프로 데이터셋을 만들어 주제 클러스터링, 트렌드 발굴, 언어 분석에 사용합니다.
  • 활발한 댓글 작성자 발굴: 작성자 정보, 좋아요 수, 답글 수를 이용해 꾸준히 토론을 이끄는 댓글 작성자를 찾아냅니다.
  • 분석 및 데이터 보강: ID와 원본 URL로 구조화된 댓글 레코드를 캠페인, 게시물, 분석 데이터셋과 연결합니다.

Facebook Comments API 활용 팁

  • 각 입력이 원본 게시물과 정확히 대응되도록 표준 형태의 공개 Facebook 게시물 URL을 사용하세요.
  • 관련된 공개 게시물 URL을 한 요청에 묶어, 캠페인이나 주제별로 수집 작업을 구성하세요.
  • 애플리케이션이 폴링하고 수집 워크플로를 이어 갈 수 있도록 제출 직후 작업 ID를 저장하세요.
  • 작업이 반환한 결과 페이지를 모두 읽으려면 results.next_cursor가 비어 있을 때까지 따라가세요.
  • 모든 레코드와 함께 댓글 ID, 게시물 ID, 상위 댓글 ID, 입력 URL, 원본 URL을 저장하세요.
  • 같은 데이터셋에서 반복된 레코드를 식별하고 병합할 때는 댓글 ID를 사용하세요.
  • 댓글 이력과 증분 분석을 정리하려면 created_at과 collected_at을 사용하세요.
  • 필드 매핑을 검증하거나 결과를 새 데이터 파이프라인에 연결할 때는 Raw JSON을 확인하세요.

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

  • Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
  • Facebook Comment Replies API — 피드백 ID와 확장 토큰으로 특정 댓글의 공개 답글을 가져오며, 텍스트, 작성자 정보, 참여도, 상위 댓글 맥락을 포함합니다.
  • Facebook Company Reviews API — 리뷰 본문, 리뷰어 링크, 평점, 좋아요, 타임스탬프, 회사 맥락과 함께 공개 페이지 리뷰를 수집합니다.
  • Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Facebook Comments API — 자주 묻는 질문

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

누구나 접근할 수 있는 공개 Facebook 게시물 URL을 사용하세요. 수집 작업마다 urls 배열에 URL을 하나 이상 추가합니다.

레코드마다 댓글 ID, 텍스트, 작성자 정보, 원본 URL, 좋아요 수, 답글 수, 미디어, created_at, collected_at, 게시물 ID, 게시물 URL, 상위 댓글 ID, 입력 URL이 포함될 수 있습니다.

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

게시물 URL을 /v1/facebook/comments로 제출하고, 반환된 작업 ID를 저장한 뒤, 작업이 성공할 때까지 /v1/tasks/{task_id}를 폴링합니다. 완료된 작업에는 구조화된 댓글 결과가 담겨 있습니다.

작업이 완료되면 /v1/tasks/{task_id}?limit=50을 읽고, 응답에 더 이상 커서가 없을 때까지 results.next_cursor로 이어서 읽습니다.

작업 제출과 결과 조회 모두 Authorization 헤더에 SocQ API 키를 Bearer 토큰으로 담아 보냅니다.

정규화된 댓글, 작성자, 참여도, 타임스탬프, 원본 필드를 분석 테이블, 보고서, 애플리케이션에 매핑하세요. 조인과 중복 제거를 위해 댓글과 게시물 식별자를 보존하세요.

반환된 댓글 레코드 1건마다 0.3 크레딧이 차감됩니다. 기본 작업 요금은 없습니다.