Facebook Profile Events
Facebook 프로필 이벤트는 프로필이나 페이지와 연결된 공개 이벤트 목록으로, 이름, 설명, 장소, 시작·종료 시각, 미디어, 공개된 지표를 담고 있습니다. 이러한 일정과 출처 정보는 주최자 캘린더 보강, 이벤트 인벤토리 조사, 페이지 간 비교에 활용할 수 있습니다.
Facebook Profile Events API 주요 기능
- 프로필·페이지 이벤트 피드제출한 Facebook 프로필 또는 페이지 URL과 연결된 공개 이벤트 목록을 하나 이상 수집합니다.
- 이벤트 식별 정보와 일정이벤트 ID, 공개 URL, 이름, 설명, 장소, 정규화된 시작 시각과 종료 시각을 반환합니다.
- 미디어와 공개 지표이벤트마다 제공되는 정규화된 공개 이미지·동영상 참조와 일반적인 공개 지표를 보존합니다.
- 정규화된 출처 정보정규화된 레코드마다 제출한 출처 URL을 붙이고, 해당 출처 피드 안에서는 ID나 URL이 같은 이벤트를 중복 제거합니다.
Facebook Profile Events API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | facebook.com, www.facebook.com, m.facebook.com의 Facebook 프로필 또는 페이지 URL을 하나 이상 지정합니다. |
results_limit | 선택 | 입력 URL마다 수집할 이벤트 레코드의 최대 개수로, 20에서 2,000 사이입니다. 기본값은 100입니다. |
Facebook Profile Events API 사용 방법
프로필 또는 페이지 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 이벤트 레코드를 커서 페이지네이션으로 읽습니다.
- Facebook 프로필 또는 페이지 URL을 하나 이상 준비하고, 필요하면 URL마다 적용할 20에서 2,000 사이의 results_limit 값을 선택합니다.
- urls 배열과 선택 값인 results_limit 값을 /v1/facebook/profile-events로 POST합니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, results.has_more가 true인 동안에는 results.next_cursor로 이어서 읽습니다.
curl -X POST "https://api.socq.ai/v1/facebook/profile-events" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.facebook.com/NASA"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Profile Events API 추천 활용 사례
- 주최자 캘린더 보강: 이벤트 이름, 설명, 장소, 시작·종료 시각으로, 알고 있는 공개 주최자 페이지를 바탕으로 만든 캘린더를 보강합니다.
- 페이지 간 이벤트 인벤토리: 정규화된 이벤트 ID와 URL을 input_url별로 묶어, 선택한 프로필이나 페이지의 공개 이벤트 목록을 비교합니다.
- 이벤트 상세 수집 큐: 반환된 이벤트 URL로 중복이 제거된 큐를 만들어 더 자세한 이벤트 상세 조회에 활용합니다.
- 공개 일정 보고: 일정 필드, 미디어 참조, 공개된 지표를 결합해 추적 중인 공개 출처와 연결된 이벤트에 대한 보고서를 만듭니다.
Facebook Profile Events API 활용 팁
- 이벤트 피드가 노출되는 프로필이나 페이지를 제출하세요. 호스트 검증만으로는 해당 Facebook URL이 적합한 출처라고 확인되지 않습니다.
- results_limit 값과 결과 기반 예상 비용은 URL마다 따로 적용되므로, 입력 URL 수를 감안해 값을 정하세요.
- 같은 이벤트가 제출한 여러 출처와 연결될 수 있다면, 합친 결과에서 이벤트 ID나 공개 URL로 중복을 제거하세요.
- 레코드를 애플리케이션에 매핑할 때 설명 텍스트, 장소, 종료 시각, 미디어, 개별 지표 값은 선택 값으로 취급하세요.
관련 API
Facebook Profile Events API 외에 Facebook의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
- Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
- Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
- Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
- Facebook Event Details API — 알고 있는 공개 이벤트 URL에서 정규화된 메타데이터, 일정, 위치, 미디어, 공개된 참여도를 수집합니다.
- Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.