facebook/
pages

하나 이상의 페이지 URL에서 공개 Facebook 페이지 프로필을 수집하고, 정규화된 식별 정보, 연락처, 이미지, 팔로워·좋아요 수, 리뷰, 평점을 반환합니다.

Facebook Pages API

페이지
프로필
공개 데이터
결과당 2.4 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Pages

Facebook 페이지는 기업, 단체, 크리에이터, 공인의 공개 프로필로, 식별 정보, 카테고리, 소개, 이미지, 연락처, 오디언스 신호를 담고 있습니다. 이러한 프로필과 오디언스 필드는 브랜드 발굴, 디렉터리 정보 보강, 시장 조사, 계정 비교에 활용할 수 있습니다.

Facebook Pages API 주요 기능

  • 페이지 일괄 수집페이지 URL로 공개 Facebook 페이지를 하나 이상 수집합니다.
  • 페이지 식별 정보와 이미지페이지 이름, 카테고리, 소개 텍스트, 정식 URL, 프로필 이미지, 커버 이미지를 정규화된 프로필 필드로 반환합니다.
  • 공개된 오디언스 지표공개된 팔로워, 페이지 좋아요, 리뷰, 평점 지표를 일관된 metrics 객체에 담아 제공합니다.
  • 공개 연락처 정보연락처 확인과 디렉터리 정보 보강에 쓸 수 있도록 공개된 웹사이트, 이메일, 전화번호, 주소 필드를 반환합니다.
  • 공개 데이터 범위결과는 공개적으로 접근 가능한 페이지 데이터로 한정되며, 비공개, 제한, 로그인 전용 콘텐츠는 응답 범위에서 제외됩니다.

Facebook Pages API 매개변수

매개변수필수설명
urls필수공개 Facebook 페이지 URL로, 쉼표 또는 줄바꿈으로 구분합니다.
results_limit선택수집 작업이 요청할 레코드의 최대 개수입니다. 양의 정수여야 합니다.

Facebook Pages API 사용 방법

수집 작업을 제출하고, 처리가 끝날 때까지 작업 ID를 폴링한 뒤, 정규화된 페이지 레코드를 커서 페이지네이션으로 읽습니다.

  1. 공개 Facebook 페이지 URL을 하나 이상 준비합니다.
  2. urls 배열과 선택 값인 results_limit 값을 /v1/facebook/pages로 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/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}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Pages API 추천 활용 사례

  • 브랜드 페이지 모니터링: 자사 또는 경쟁사 페이지 추적을 위해 공개 페이지의 식별 정보, 카테고리, 연락처, 오디언스 지표를 수집합니다.
  • 페이지 벤치마크 데이터셋: 선택한 페이지들의 카테고리, 소개, 연락처 확보 여부, 팔로워 수, 평점 등 공개된 오디언스 신호를 비교합니다.
  • 리포팅·BI 파이프라인: 정규화된 공개 페이지 레코드를 대시보드, 스프레드시트, 데이터 웨어하우스, 내부 검토 도구로 보냅니다.
  • 미디어 아카이브 워크플로: 나중에 검토하거나 보고할 수 있도록 페이지 URL, 이미지, 소개, 연락처 필드, 공개된 지표를 저장합니다.
  • 공개 소셜 리스닝: 공개 페이지의 식별 정보와 오디언스 신호로 소셜 계정 카탈로그와 브랜드 데이터셋을 보강합니다.

Facebook Pages API 활용 팁

  • 대규모 배치를 시작하기 전에 제출하는 모든 URL이 공개 Facebook 페이지로 연결되는지 확인하세요.
  • 결과 제공 여부에 따라 일부 공개 페이지는 연락처 필드, 이미지, 평점, 오디언스 카운터가 빠질 수 있다고 예상하세요.
  • 작업을 재시도, 감사, 중복 제거할 수 있도록 안정적인 페이지 ID와 정식 URL을 보관하세요.
  • 워크플로에 페이지나 그 밖의 지원되는 URL의 공개 게시물 레코드가 필요하다면 Facebook Posts API를 사용하세요.
  • 별도로 게시된 문서가 명시적으로 지원하지 않는 한, 비공개 페이지, 제한된 게시물, 로그인이 필요한 화면, 계정 소유 데이터를 전제로 워크플로를 설계하지 마세요.

Facebook Pages API 외에 Facebook의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
  • Facebook Profile Events API — 프로필 또는 페이지 URL과 연결된 공개 이벤트를 이름, 일정, 위치, 미디어, 공개된 지표, 출처 맥락과 함께 수집합니다.
  • Facebook Profile Photos API — 프로필 또는 페이지 URL에서 공개 사진을 캡션, 작성자 맥락, 참여도, 이미지 메타데이터, 출처 참조와 함께 수집합니다.
  • Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.
  • Facebook Reels API — 프로필 또는 페이지 URL에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.

다른 플랫폼 둘러보기

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

Facebook Pages API — 자주 묻는 질문

Facebook Pages API는 하나 이상의 Facebook 페이지 URL에서 공개적으로 접근 가능한 페이지 프로필을 가져오는 API입니다. 정규화된 식별 정보, 카테고리, 소개, 이미지, 연락처, 팔로워·좋아요 수, 리뷰, 평점을 반환합니다.

기본적인 공개 페이지 수집에는 Facebook 앱 자격 증명이나 Facebook 로그인이 필요하지 않습니다. 비공개, 제한, 로그인 전용 콘텐츠에 접근할 수 있다고 가정하고 이 API를 사용해서는 안 됩니다.

일반적으로 페이지 ID, 이름, 정식 URL, 카테고리, 소개 텍스트, 프로필 이미지, 커버 이미지, 팔로워·좋아요 수, 리뷰, 평점, 웹사이트, 이메일, 전화번호, 주소를 반환합니다.

네. 공개 페이지 결과에 프로필 및 커버 이미지 URL이 노출되는 경우에 가능합니다. 클라이언트는 이미지 필드 중 하나 또는 둘 다 없는 페이지를 처리할 수 있어야 합니다.

공개 결과에 노출되는 경우, 정규화된 metrics 객체에 공개된 팔로워 수, 페이지 좋아요 수, 리뷰 수, 평점이 포함될 수 있습니다.

Facebook 콘텐츠는 동적이고 공개 결과의 구조가 바뀔 수 있습니다. 빈 필드, 타임아웃, 누락된 연락처 데이터, 차단된 요청은 정상적인 제공 여부 및 속도 제한 상황으로 처리해야 합니다.

제한 값을 작게 두고, 요청 속도를 보수적으로 유지하며, 실패 후에는 백오프를 적용하고, 큰 페이지에는 더 긴 처리 타임아웃을 사용하세요. 같은 페이지를 대량으로 반복 수집하는 것은 피하세요.