Facebook Posts
Facebook 게시물은 페이지, 프로필, 그룹에서 올린 공개 업데이트로, 텍스트, 링크, 미디어, 작성자 정보, 타임스탬프, 공개된 참여도를 담고 있습니다. 이러한 콘텐츠와 참여도 신호는 캠페인 모니터링, 에디토리얼 조사, 오디언스 분석, 보고에 활용할 수 있습니다.
Facebook Posts API 주요 기능
- 지원되는 공개 URL공개 Facebook 페이지, 프로필, 그룹 또는 게시물 URL에서 게시물을 수집해 하나의 정규화된 응답 구조로 제공합니다.
- 콘텐츠·미디어 필드게시물 텍스트, 게시물 ID, 작성자 정보, 타임스탬프, 링크, 미디어, 공유 수, 댓글 수, 공개된 반응 수를 정규화된 필드로 반환합니다.
- 반응별 세부 수치like, love, wow, care, sad, angry, haha별로 공개된 반응 세부 수치를 제공합니다.
- 요청 결과 수 상한지원되는 URL을 하나 이상 받고, results_limit 값으로 요청할 게시물 레코드 수의 상한을 지정합니다.
- 공개 데이터 범위비공개, 제한, 로그인 전용 또는 삭제된 콘텐츠는 응답 범위에서 제외합니다.
Facebook Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Facebook 페이지, 프로필, 그룹 또는 게시물 URL로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 수집 작업이 요청할 레코드의 최대 개수입니다. 양의 정수여야 합니다. |
Facebook Posts API 사용 방법
비동기 수집 작업을 제출하고, 작업 ID를 폴링한 뒤, 정규화된 공개 게시물 레코드를 커서 페이지네이션으로 읽습니다.
- 공개 Facebook 페이지, 프로필, 그룹 또는 게시물 URL을 하나 이상 준비합니다.
- urls 배열과 선택 값인 results_limit 값을 /v1/facebook/posts로 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/facebook/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/cern"],"results_limit":25}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Posts API 추천 활용 사례
- 공개 페이지 모니터링: 제품에서 추적하는 Facebook 페이지의 공개 게시물, 타임스탬프, 링크, 미디어 참조, 공개된 카운터를 수집합니다.
- 캠페인·브랜드 보고: 캠페인 데이터를 대시보드나 BI 도구로 보내기 전에 게시물 텍스트, 반응, 댓글, 공유, 미디어 필드를 정규화합니다.
- 콘텐츠 조사: 브랜드, 이벤트 또는 주제와 관련된 공개 캡션, 게시물 주제, 링크, 이미지, 동영상, 참여 패턴을 분석합니다.
- 소셜 리스닝 워크플로: 깨지기 쉬운 페이지 파서를 직접 관리하지 않고도 공개 게시물 신호를 검토 큐, 알림 시스템, 내부 조사 도구로 전달합니다.
- 게시물 아카이브와 감사 추적: 정규화된 게시물 ID, 원본 URL, 타임스탬프, 공개된 카운터, 수집 시각을 저장해 재현 가능한 아카이브와 보고에 활용합니다.
Facebook Posts API 활용 팁
- 공개 페이지를 소규모 배치로 시작하고, 재시도와 백오프 동작이 안정적으로 작동하는 것을 확인한 뒤에 limit를 늘리세요.
- 실패 후에도 게시물 수집을 이어 갈 수 있도록 정규화된 게시물 ID, URL, 작업 ID, next_cursor를 저장하세요.
- 출처의 제공 여부에 따라 일부 공개 게시물에는 댓글, 미디어, 반응 세부 정보, 타임스탬프가 없을 수 있다고 예상하세요.
- 간단한 미리보기 필드 이상의 깊이 있는 공개 댓글 스레드가 필요하면 Comments API를 사용하세요.
- 게시된 API 문서가 명시적으로 지원하지 않는 한, 비공개, 제한, 로그인 전용 또는 계정 소유 데이터를 연동의 전제로 삼지 마세요.
관련 API
Facebook Posts API 외에 Facebook의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
- Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
- Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
- Facebook Group Posts API — Facebook 그룹 URL에서 공개 게시물을 수집하며, 정렬 방식과 그룹별 제한을 선택할 수 있고 작성자 맥락, 동영상 미디어, 공개된 참여도를 포함합니다.
- Facebook Ad Transcript API — Facebook 광고 라이브러리 URL에서 제공되는 음성 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.