Facebook Comments
Facebook 댓글은 게시물에 달린 공개 응답으로, 텍스트, 작성자 정보, 게시 시각, 공개된 좋아요 수, 답글 수, 미디어, 원본과의 관계를 담고 있습니다. 이러한 토론 신호는 오디언스 피드백 분석, 반복되는 질문 조사, 커뮤니티 모니터링, 콘텐츠 보고에 활용할 수 있습니다.
Facebook Comments API 주요 기능
- 여러 게시물의 댓글 수집한 번의 요청으로 하나 이상의 Facebook 게시물 URL에서 공개 댓글을 수집합니다.
- 정규화된 댓글 레코드댓글 ID, 텍스트, 작성자 정보, 타임스탬프, 공개된 참여도, 미디어, 원본 링크를 일관된 구조로 반환합니다.
- 추적 가능한 대화 맥락조인, 중복 제거, 감사 추적에 쓸 수 있도록 게시물, 상위 댓글, 제출한 입력에 대한 참조를 보존합니다.
- 공개 데이터 범위비공개, 제한, 삭제, 로그인 전용 콘텐츠는 결과 범위에 포함하지 않습니다.
Facebook Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Facebook 게시물 URL로, 쉼표 또는 줄바꿈으로 구분합니다. |
Facebook Comments API 사용 방법
공개 Facebook 게시물 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 댓글 레코드를 커서 페이지네이션으로 읽습니다.
- 공개 Facebook 게시물 URL을 하나 이상 준비합니다.
- urls 배열을 /v1/facebook/comments로 POST합니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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을 확인하세요.
관련 API
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에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.