facebook/
company-reviews

/reviews URL에서 공개 Facebook 페이지 리뷰를 수집하고, 리뷰 텍스트, 리뷰어 링크, 평점, 좋아요 수, 타임스탬프, 회사 정보를 정규화된 레코드로 반환합니다.

Facebook Company Reviews API

페이지 리뷰
리뷰어 정보
회사 평점
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Company Reviews

Facebook 회사 리뷰는 서면 의견, 리뷰어 정보, 게시 시각, 공개된 좋아요 수, 회사 단위 리뷰 신호를 담은 공개 페이지 추천 또는 평점입니다. 이러한 레코드는 피드백 조사, 평판 스냅샷, 리뷰어 맥락 분석, 알고 있는 페이지 간 비교에 활용할 수 있습니다.

Facebook Company Reviews API 주요 기능

  • 페이지 리뷰 URL 수집지원되는 Facebook 페이지 /reviews URL을 하나 이상 받아, 입력마다 확인되는 공개 리뷰 행을 수집합니다.
  • 리뷰·리뷰어 레코드리뷰 ID, 원본 URL, 텍스트, 리뷰어 이름과 프로필 링크, 공개된 좋아요 수, 평점 값, 게시 시각을 정규화된 구조로 반환합니다.
  • 회사 단위 정보개별 리뷰와 함께 회사 이름, 페이지 URL, 종합 평점, 전체 리뷰 수를 보존해 출처 단위로 비교할 수 있습니다.

Facebook Company Reviews API 매개변수

매개변수필수설명
urls필수facebook.com, www.facebook.com, m.facebook.com의 Facebook 페이지 리뷰 URL로, 경로에 /reviews가 포함되어야 하며 쉼표 또는 줄바꿈으로 구분합니다.
results_limit선택입력 URL마다 요청할 리뷰의 최대 개수로, 20에서 2,000 사이입니다. 기본값은 100이며 실제 공개 결과는 이보다 적을 수 있습니다.

Facebook Company Reviews API 사용 방법

Facebook 페이지 /reviews URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 리뷰 레코드를 커서 페이지네이션으로 읽습니다.

  1. 경로에 /reviews가 포함된 공개 Facebook 페이지 URL을 하나 이상 준비합니다.
  2. urls 배열과 선택 값인 results_limit 값을 /v1/facebook/company-reviews로 POST합니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true인 동안에는 results.next_cursor를 cursor로 전달합니다.
curl -X POST "https://api.socq.ai/v1/facebook/company-reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/PepsiCo/reviews/"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.

Facebook Company Reviews API 추천 활용 사례

  • 피드백 데이터셋 준비: 리뷰 텍스트, 평점 값, 게시 시각, 원본 URL로 후속 주제·감성 분석에 쓸 공개 피드백 데이터셋을 준비합니다.
  • 평판 스냅샷 보고: 개별 리뷰 평점을 회사 단위 평점, 전체 리뷰 수와 결합해 선택한 페이지의 공개 상태를 기록합니다.
  • 리뷰어 참여 조사: 리뷰어 이름, 프로필 링크, 공개된 좋아요 수로 누가 공개 피드백을 남겼고 어떤 리뷰가 호응을 얻었는지 살펴봅니다.

Facebook Company Reviews API 활용 팁

  • 회사 이름이나 일반 페이지 URL이 아니라, 조회할 수 있는 Facebook 페이지 /reviews URL을 사용하세요.
  • 필요한 깊이에 맞춰 입력 URL마다 results_limit 값을 지정하세요. Facebook이 공개하는 리뷰 이력이 적으면 행 수도 그만큼 적어집니다.
  • 중복된 입력 URL은 수집 전에 제거되므로 페이지 URL은 한 번만 제출하세요.
  • Facebook이 값을 공개하지 않을 때를 대비해 리뷰어 링크, 평점, 좋아요 수, 타임스탬프, 회사 집계 값은 null일 수 있는 값으로 처리하세요.
  • 큰 규모의 완료된 작업에서 저장된 레코드를 빠짐없이 읽으려면 results.has_more가 false가 될 때까지 results.next_cursor를 따라가세요.

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

  • Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
  • Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
  • Facebook Comment Replies API — 피드백 ID와 확장 토큰으로 특정 댓글의 공개 답글을 가져오며, 텍스트, 작성자 정보, 참여도, 상위 댓글 맥락을 포함합니다.
  • Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Facebook Company Reviews API — 자주 묻는 질문

Facebook Company Reviews API는 공개 Facebook 페이지 /reviews URL에서 리뷰와 추천을 모아 일관된 피드백 데이터로 만들어 주는 API입니다. 평판 관리 팀이 스냅샷, 주제 분석, 알고 있는 페이지 간 비교를 할 수 있는 기반을 제공하지만, 공개 리뷰 페이지에 보이는 콘텐츠로 범위가 한정됩니다.

facebook.com, www.facebook.com, m.facebook.com의 Facebook 페이지 URL 중 경로에 /reviews가 포함된 것을 하나 이상 제출하세요. 회사 이름이나 관련 없는 페이지 URL은 대신 사용할 수 없습니다.

레코드에는 리뷰 ID와 URL, 텍스트, 리뷰어 이름과 프로필 URL, 공개된 좋아요 수, 평점 값, created_at, collected_at, 회사 이름과 URL, 회사 평점, 전체 리뷰 수가 포함될 수 있습니다.

results_limit 값의 기본값은 100이며 입력 URL마다 20에서 2,000 사이의 정수를 받습니다. 상한값이므로 공개 범위와 출처의 제공 여부에 따라 리뷰가 더 적게 반환될 수 있습니다.

반환된 작업 ID를 status가 succeeded가 될 때까지 폴링한 다음, 작업 결과 엔드포인트에서 저장된 리뷰 레코드를 읽으면 됩니다.

실제로 저장된 리뷰 레코드 1건마다 0.5 크레딧이 차감되며, 기본 작업 요금은 없습니다. 따라서 결과가 비어 있으면 결과 요금이 발생하지 않습니다.