API 목록으로 돌아가기
Facebook 공개 데이터

Facebook 공개 데이터 API

공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.

사용할 수 있는 Facebook API

공개 프로필 필드는 Pages, 일반 콘텐츠는 Posts, 그룹 URL 레코드는 Group Posts, 토론 내용은 Comments, 키워드에 일치하는 이벤트는 Events Search, 이미 알고 있는 동영상 게시물이나 릴스 URL의 음성 텍스트는 Video Transcripts로 가져옵니다. 6개 모두 같은 인증 방식과 작업 결과 방식을 사용합니다.

어떤 Facebook 데이터를 가져올 수 있나요?

SocQ는 지원하는 공개 Facebook 결과를 일관된 JSON 레코드로 변환해, 정보 보강·모니터링·리서치·리포팅 워크플로에 활용할 수 있게 합니다.

공개 페이지 프로필

공개된 경우 페이지 이름, 카테고리, 소개글, 정식 URL, 프로필 이미지, 커버 이미지를 수집합니다.

연락처와 오디언스 필드

노출된 경우 공개 웹사이트, 이메일 주소, 전화번호, 위치, 팔로워 수, 페이지 좋아요 수, 평점, 리뷰 수를 반환합니다.

공개 게시물 콘텐츠

게시물 텍스트, 작성자, 타임스탬프, 링크, 이미지, 동영상 참조, 정규화된 게시물 식별자를 수집합니다.

공개 댓글과 참여도

가져올 수 있는 경우 공개 댓글 텍스트, 작성자 필드, 타임스탬프, 좋아요 수, 답글 수, 공유 수, 반응 신호를 수집합니다.

공개 이벤트 탐색

키워드로 검색해 이벤트 이름, 일정, 장소, 참석 신호, 커버 이미지, 온라인 이벤트 여부와 종료된 이벤트 여부를 가져옵니다.

가져올 수 있는 동영상 스크립트

이미 알고 있는 공개 동영상 게시물이나 릴스 URL에서 출처가 연결된 스크립트 텍스트와 그 형식(일반 텍스트 또는 WebVTT)을 추출합니다.

SocQ vs Facebook Graph API

SocQ는 지원하는 공개 데이터 수집에 집중합니다. 사용자나 비즈니스가 명시적으로 권한을 부여한 자산을 관리할 때는 Meta의 Graph API가 알맞은 선택입니다.

기능SocQFacebook Graph API
주요 용도공개 페이지, 게시물, 그룹 게시물, 댓글, 이벤트, 스크립트 데이터 수집권한이 부여된 페이지, 앱, 자산 관리
고객 OAuthSocQ API 키만 사용하며 고객의 Facebook OAuth 불필요Meta 앱 검수, 권한, 액세스 토큰
게시물 작성·수정지원하지 않음해당 페이지 권한이 있으면 지원
비공개·제한 데이터지원하지 않음권한을 부여받은 데이터만 가능
응답 형식정규화된 SocQ 레코드Graph API 고유 객체

Facebook API 작동 방식

수집은 비동기로 실행되므로, 애플리케이션에서 작업 제출, 상태 확인, 결과 페이지 처리를 각각 독립적으로 진행할 수 있습니다.

  1. 1. 입력 제출

    선택한 엔드포인트 문서에 나온 필드를 사용해 지원하는 공개 페이지, 게시물, 그룹, 동영상 게시물, 릴스 URL을 POST하거나, 이벤트 검색용 키워드 쿼리를 제출합니다.

  2. 2. 작업 폴링

    반환된 작업 ID로 처리가 성공하거나 실패할 때까지 폴링합니다. 일시적인 부하 응답을 받으면 간격을 늘려 다시 시도하세요.

  3. 3. 결과 읽기와 페이지네이션

    정규화된 결과 항목을 가져오고, 작업에 레코드가 더 있으면 next_cursor를 따라갑니다.

API 요청 한 번으로 시작

SocQ API 키로 인증합니다. 이 예시는 공개 Facebook 페이지 작업을 시작합니다. 일반 게시물은 /v1/facebook/posts, 그룹 게시물은 /v1/facebook/group-posts, 댓글은 /v1/facebook/comments, 이벤트 탐색은 /v1/facebook/events-search, 이미 알고 있는 동영상 게시물과 릴스 URL은 /v1/facebook/video-transcript를 사용하세요.

curl -X POST "https://api.socq.ai/v1/facebook/pages" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/Meta"],"results_limit":10}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50

Facebook API 주요 활용 사례

브랜드 모니터링

자사 브랜드나 경쟁사의 공개 페이지 식별 정보, 연락처, 오디언스, 게시물 신호를 추적합니다.

콘텐츠·반응 리서치

공개 게시물, 댓글 텍스트, 작성자, 타임스탬프, 미디어, 노출된 참여도를 분석해 리포트나 콘텐츠 기획 리서치에 활용합니다.

페이지 정보 보강

CRM, 디렉터리, 계정 레코드에 공개 Facebook 식별 정보, 카테고리, 연락처, 오디언스 필드를 추가합니다.

이벤트 탐색과 모니터링

키워드에 일치하는 이벤트의 식별 정보, 일정, 장소, 참석, 커버, 상태 필드로 공개 이벤트 레코드를 정리합니다.

리포팅 파이프라인

정규화된 공개 페이지·게시물 레코드를 대시보드, 데이터 웨어하우스, 내부 검토 도구로 전달합니다.

음성 콘텐츠 색인

선택한 공개 동영상 게시물과 릴스의 스크립트 텍스트를 출처 URL, 형식과 함께 색인합니다.

제한 사항과 공개 데이터 정책

Facebook 공개 결과는 수시로 바뀝니다. 한 페이지, 게시물, 댓글, 이벤트, 스크립트 출처에서 보이는 필드가 다른 레코드에는 없거나 시간이 지나면서 달라질 수 있습니다.

  • 비공개 그룹, 접근이 제한된 프로필, 삭제된 게시물, 로그인해야만 볼 수 있는 콘텐츠는 지원하지 않습니다.
  • 공개 레코드에는 연락처 필드, 댓글 작성자, 미디어, 카운터, 타임스탬프, 답글, 반응 세부 내역이 없을 수 있습니다.
  • 제출한 공개 동영상 URL에서 비어 있지 않은 스크립트 텍스트를 가져올 수 없으면 스크립트 레코드가 생성되지 않습니다.
  • 일시 차단이나 속도 제한이 걸린 뒤에는 배치를 작게 나누고, 요청 속도를 보수적으로 유지하며, 간격을 늘려 다시 시도하세요.
  • 이 엔드포인트는 Facebook 콘텐츠를 생성·수정·관리·삭제하지 않습니다.

Facebook API 자주 묻는 질문

공식 Facebook Graph API인가요?

아니요. SocQ는 지원하는 공개 Facebook 결과를 정규화합니다. 권한이 부여된 페이지 관리, 게시, 모더레이션에는 Meta의 Graph API를 사용하세요.

사용자가 Facebook 계정을 연결해야 하나요?

지원하는 공개 데이터 엔드포인트에는 고객의 Facebook OAuth가 필요하지 않습니다. 요청은 SocQ API 키로 인증합니다.

비공개 그룹이나 프로필도 수집할 수 있나요?

아니요. 비공개 콘텐츠, 접근이 제한된 콘텐츠, 로그인해야만 볼 수 있는 Facebook 콘텐츠는 지원 범위에 포함되지 않습니다.

요금은 어떻게 부과되나요?

각 엔드포인트 카드에 현재 결과 1건당 크레딧 요금이 표시됩니다. 작업이 반환한 정규화된 레코드를 기준으로 과금됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.