facebook/
posts

페이지, 프로필, 그룹 또는 게시물 URL에서 공개 Facebook 게시물을 수집하고, 정규화된 텍스트, 작성자 정보, 미디어, 반응, 댓글 수, 공유 수를 반환합니다.

Facebook Posts API

게시물
반응
공개 데이터
결과당 1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 공개 게시물 레코드를 커서 페이지네이션으로 읽습니다.

  1. 공개 Facebook 페이지, 프로필, 그룹 또는 게시물 URL을 하나 이상 준비합니다.
  2. urls 배열과 선택 값인 results_limit 값을 /v1/facebook/posts로 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/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 문서가 명시적으로 지원하지 않는 한, 비공개, 제한, 로그인 전용 또는 계정 소유 데이터를 연동의 전제로 삼지 마세요.

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에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Facebook Posts API — 자주 묻는 질문

Facebook Posts API는 Facebook 페이지, 프로필, 그룹 또는 게시물 URL에서 공개적으로 접근 가능한 게시물을 수집하는 API입니다. 정규화된 텍스트, 작성자 정보, 미디어 참조, 타임스탬프, 반응, 댓글 수, 공유 수를 반환합니다.

공개 Facebook 페이지, 프로필, 공개 그룹 또는 게시물 URL을 제출하세요. 비공개 그룹, 제한된 프로필, 삭제된 게시물, 로그인이 필요한 화면은 제한된 데이터만 반환되거나 레코드가 없을 수 있습니다.

일반적인 결과 필드는 id, url, message, author, metrics, reactions, media, created_at, collected_at, extra입니다. 작업 및 결과 페이지네이션 메타데이터는 이를 감싸는 API 응답에서 반환됩니다.

공개 게시물 수집에는 고객이 제공하는 Facebook 쿠키가 필요하지 않습니다. 로그인한 뒤에만 보이는 콘텐츠는 공개 데이터 범위에 포함되지 않습니다.

공개 게시물에 노출되는 경우 이미지, 동영상, 반응 세부 정보, 공개된 댓글 수가 반환됩니다. 개별 댓글 레코드가 필요하면 Facebook Comments API를 사용하고, 선택적인 미디어나 반응 필드는 null일 수 있는 값으로 처리하세요.

페이지 크기를 보수적으로 유지하고, 429 또는 이와 비슷한 부하 응답이 오면 백오프를 적용하며, 짧은 간격의 재시도 반복은 피하세요. 큰 작업은 작은 배치로 나눠 수집하고 저장해 둔 커서에서 이어 가세요.

대상에 공개적으로 접근할 수 있는지, 게시물이 삭제되거나 제한되지 않았는지, 요청한 선택 필드가 공개적으로 노출되는지 확인하세요. Facebook은 공개 페이지 구조를 자주 바꾸므로, 클라이언트는 누락된 필드를 정상적인 제공 여부의 한 경우로 취급해야 합니다.