Facebook 공개 데이터 API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
사용할 수 있는 Facebook API
공개 프로필 필드는 Pages, 일반 콘텐츠는 Posts, 그룹 URL 레코드는 Group Posts, 토론 내용은 Comments, 키워드에 일치하는 이벤트는 Events Search, 이미 알고 있는 동영상 게시물이나 릴스 URL의 음성 텍스트는 Video Transcripts로 가져옵니다. 6개 모두 같은 인증 방식과 작업 결과 방식을 사용합니다.

facebook/pages
프로필결과당 2.4 크레딧

facebook/posts
게시물결과당 1 크레딧

facebook/group-posts
게시물결과당 1.2 크레딧

facebook/reels
게시물결과당 0.7 크레딧

facebook/comments
댓글결과당 0.3 크레딧

facebook/comment-replies
댓글결과당 0.3 크레딧

facebook/company-reviews
댓글결과당 0.5 크레딧

facebook/video-transcript
게시물결과당 0.7 크레딧

facebook/ad-transcript
게시물결과당 0.5 크레딧

facebook/events-search
검색결과당 0.6 크레딧

facebook/event-details
검색결과당 0.5 크레딧

facebook/profile-events
프로필결과당 0.6 크레딧

facebook/profile-photos
게시물결과당 0.5 크레딧

facebook/profiles
프로필결과당 1.2 크레딧
어떤 Facebook 데이터를 가져올 수 있나요?
SocQ는 지원하는 공개 Facebook 결과를 일관된 JSON 레코드로 변환해, 정보 보강·모니터링·리서치·리포팅 워크플로에 활용할 수 있게 합니다.
공개 페이지 프로필
공개된 경우 페이지 이름, 카테고리, 소개글, 정식 URL, 프로필 이미지, 커버 이미지를 수집합니다.
연락처와 오디언스 필드
노출된 경우 공개 웹사이트, 이메일 주소, 전화번호, 위치, 팔로워 수, 페이지 좋아요 수, 평점, 리뷰 수를 반환합니다.
공개 게시물 콘텐츠
게시물 텍스트, 작성자, 타임스탬프, 링크, 이미지, 동영상 참조, 정규화된 게시물 식별자를 수집합니다.
공개 댓글과 참여도
가져올 수 있는 경우 공개 댓글 텍스트, 작성자 필드, 타임스탬프, 좋아요 수, 답글 수, 공유 수, 반응 신호를 수집합니다.
공개 이벤트 탐색
키워드로 검색해 이벤트 이름, 일정, 장소, 참석 신호, 커버 이미지, 온라인 이벤트 여부와 종료된 이벤트 여부를 가져옵니다.
가져올 수 있는 동영상 스크립트
이미 알고 있는 공개 동영상 게시물이나 릴스 URL에서 출처가 연결된 스크립트 텍스트와 그 형식(일반 텍스트 또는 WebVTT)을 추출합니다.
SocQ vs Facebook Graph API
SocQ는 지원하는 공개 데이터 수집에 집중합니다. 사용자나 비즈니스가 명시적으로 권한을 부여한 자산을 관리할 때는 Meta의 Graph API가 알맞은 선택입니다.
| 기능 | SocQ | Facebook Graph API |
|---|---|---|
| 주요 용도 | 공개 페이지, 게시물, 그룹 게시물, 댓글, 이벤트, 스크립트 데이터 수집 | 권한이 부여된 페이지, 앱, 자산 관리 |
| 고객 OAuth | SocQ API 키만 사용하며 고객의 Facebook OAuth 불필요 | Meta 앱 검수, 권한, 액세스 토큰 |
| 게시물 작성·수정 | 지원하지 않음 | 해당 페이지 권한이 있으면 지원 |
| 비공개·제한 데이터 | 지원하지 않음 | 권한을 부여받은 데이터만 가능 |
| 응답 형식 | 정규화된 SocQ 레코드 | Graph API 고유 객체 |
Facebook API 작동 방식
수집은 비동기로 실행되므로, 애플리케이션에서 작업 제출, 상태 확인, 결과 페이지 처리를 각각 독립적으로 진행할 수 있습니다.
1. 입력 제출
선택한 엔드포인트 문서에 나온 필드를 사용해 지원하는 공개 페이지, 게시물, 그룹, 동영상 게시물, 릴스 URL을 POST하거나, 이벤트 검색용 키워드 쿼리를 제출합니다.
2. 작업 폴링
반환된 작업 ID로 처리가 성공하거나 실패할 때까지 폴링합니다. 일시적인 부하 응답을 받으면 간격을 늘려 다시 시도하세요.
3. 결과 읽기와 페이지네이션
정규화된 결과 항목을 가져오고, 작업에 레코드가 더 있으면 next_cursor를 따라갑니다.
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=50Facebook API 주요 활용 사례
브랜드 모니터링
자사 브랜드나 경쟁사의 공개 페이지 식별 정보, 연락처, 오디언스, 게시물 신호를 추적합니다.
콘텐츠·반응 리서치
공개 게시물, 댓글 텍스트, 작성자, 타임스탬프, 미디어, 노출된 참여도를 분석해 리포트나 콘텐츠 기획 리서치에 활용합니다.
페이지 정보 보강
CRM, 디렉터리, 계정 레코드에 공개 Facebook 식별 정보, 카테고리, 연락처, 오디언스 필드를 추가합니다.
이벤트 탐색과 모니터링
키워드에 일치하는 이벤트의 식별 정보, 일정, 장소, 참석, 커버, 상태 필드로 공개 이벤트 레코드를 정리합니다.
리포팅 파이프라인
정규화된 공개 페이지·게시물 레코드를 대시보드, 데이터 웨어하우스, 내부 검토 도구로 전달합니다.
음성 콘텐츠 색인
선택한 공개 동영상 게시물과 릴스의 스크립트 텍스트를 출처 URL, 형식과 함께 색인합니다.
제한 사항과 공개 데이터 정책
Facebook 공개 결과는 수시로 바뀝니다. 한 페이지, 게시물, 댓글, 이벤트, 스크립트 출처에서 보이는 필드가 다른 레코드에는 없거나 시간이 지나면서 달라질 수 있습니다.
- 비공개 그룹, 접근이 제한된 프로필, 삭제된 게시물, 로그인해야만 볼 수 있는 콘텐츠는 지원하지 않습니다.
- 공개 레코드에는 연락처 필드, 댓글 작성자, 미디어, 카운터, 타임스탬프, 답글, 반응 세부 내역이 없을 수 있습니다.
- 제출한 공개 동영상 URL에서 비어 있지 않은 스크립트 텍스트를 가져올 수 없으면 스크립트 레코드가 생성되지 않습니다.
- 일시 차단이나 속도 제한이 걸린 뒤에는 배치를 작게 나누고, 요청 속도를 보수적으로 유지하며, 간격을 늘려 다시 시도하세요.
- 이 엔드포인트는 Facebook 콘텐츠를 생성·수정·관리·삭제하지 않습니다.
Facebook API 자주 묻는 질문
공식 Facebook Graph API인가요?
아니요. SocQ는 지원하는 공개 Facebook 결과를 정규화합니다. 권한이 부여된 페이지 관리, 게시, 모더레이션에는 Meta의 Graph API를 사용하세요.
사용자가 Facebook 계정을 연결해야 하나요?
지원하는 공개 데이터 엔드포인트에는 고객의 Facebook OAuth가 필요하지 않습니다. 요청은 SocQ API 키로 인증합니다.
비공개 그룹이나 프로필도 수집할 수 있나요?
아니요. 비공개 콘텐츠, 접근이 제한된 콘텐츠, 로그인해야만 볼 수 있는 Facebook 콘텐츠는 지원 범위에 포함되지 않습니다.
요금은 어떻게 부과되나요?
각 엔드포인트 카드에 현재 결과 1건당 크레딧 요금이 표시됩니다. 작업이 반환한 정규화된 레코드를 기준으로 과금됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.
Threads API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.
Bluesky API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.