Facebook Group Posts
Facebook 그룹 게시물은 메시지 텍스트, 작성자 정보, 게시 시각, 원본 링크, 공개된 반응·댓글·조회수, 동영상 미디어를 담은 공개 그룹 업데이트입니다. 이러한 레코드는 그룹 활동 모니터링, 토론 조사, 참여도 비교, 공개 콘텐츠 보고에 활용할 수 있습니다.
Facebook Group Posts API 주요 기능
- 공개 그룹 URL 일괄 처리공개 Facebook 그룹 URL을 하나 이상 받고, 정규화된 게시물 레코드마다 출처가 된 그룹 URL을 함께 보존합니다.
- 4가지 그룹 정렬 방식top_posts, recent_activity, chronological, chronological_listings 중에서 선택해 제출한 모든 그룹에 적용할 정렬 방식을 지정합니다.
- 그룹별 수집 깊이results_limit 값을 그룹 URL마다 따로 적용하며, 기본값은 100이고 3에서 2,000 사이의 값을 지정할 수 있습니다.
- 게시물·작성자 정보게시물 ID, 원본 URL, 메시지 텍스트, 작성자 ID와 이름, 게시 시각, 수집 시각을 일관된 구조로 반환합니다.
- 공개된 참여도와 동영상공개된 반응·댓글·동영상 조회수와 함께, 공개 게시물에 있는 경우 정규화된 동영상 및 썸네일 URL을 포함합니다.
Facebook Group Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Facebook 그룹 URL로, 쉼표 또는 줄바꿈으로 구분하는 필수 값입니다. |
results_limit | 선택 | 그룹 URL마다 요청할 게시물의 최대 개수입니다. 기본값은 100이며 3에서 2,000 사이의 정수를 지정할 수 있습니다. |
sort_by | 선택 | 제출한 모든 그룹에 적용되는 정렬 방식으로, 선택 값입니다. top_posts, recent_activity, chronological, chronological_listings 중에서 지정합니다. |
Facebook Group Posts API 사용 방법
공개 그룹 URL을 선택적인 정렬 방식과 그룹별 결과 수 제한과 함께 제출하고, 비동기 작업 결과를 커서 페이지네이션으로 읽습니다.
- 공개 Facebook 그룹 URL을 하나 이상 준비합니다.
- urls 배열과 선택 값인 results_limit, sort_by를 /v1/facebook/group-posts로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안에는 반환된 next_cursor를 전달해 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/facebook/group-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/groups/1270525996445602/"],"results_limit":30,"sort_by":"recent_activity"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueFacebook Group Posts API 추천 활용 사례
- 공개 그룹 활동 점검: recent_activity 또는 chronological 정렬을 message, author, created_at, group_url 필드와 함께 사용해 선택한 그룹의 공개 업데이트를 점검합니다.
- 그룹 토론 아카이브: 게시물 ID, 메시지 텍스트, 작성자 정보, 원본 URL, 게시 시각, 수집 시각을 출처를 알 수 있는 공개 그룹 레코드로 저장합니다.
- 동일 조건의 참여도 비교: 그룹 URL 전체에 같은 sort_by 값을 적용하고, 하나의 정렬 방식 아래에서 reactions_count, comments_count, views_count를 비교합니다.
Facebook Group Posts API 활용 팁
- 그룹 이름이 아니라 공개 그룹 URL을 직접 제출해, 모든 입력이 모호하지 않은 출처에 연결되도록 하세요.
- 제한은 그룹마다 따로 적용되므로, 요청되는 수집량은 urls 항목 수에 results_limit 값을 곱해 계산하세요.
- 한 요청 안에서는 sort_by 값 하나가 모든 그룹 URL에 적용되므로, 정렬 방식을 비교할 때는 작업을 따로 실행하세요.
- 후속 레코드의 출처를 알 수 있고 그룹 안에서 중복을 제거할 수 있도록 id와 extra.group_url을 함께 보존하세요.
- 공개 게시물에 노출되지 않을 수 있으므로 작성자, 메시지, 게시 시각, 동영상 미디어, 동영상 조회수는 선택 값으로 취급하세요.
- 완료된 작업의 결과가 한 페이지를 넘으면 has_more가 false가 될 때까지 results.next_cursor를 따라가세요.
관련 API
Facebook Group Posts API 외에 Facebook의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
- Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
- Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
- Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
- Facebook Ad Transcript API — Facebook 광고 라이브러리 URL에서 제공되는 음성 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- Facebook Profile Photos API — 프로필 또는 페이지 URL에서 공개 사진을 캡션, 작성자 맥락, 참여도, 이미지 메타데이터, 출처 참조와 함께 수집합니다.