Facebook Events Search
Facebook 이벤트는 이름, 일정 텍스트, 시작 시각, 장소, 참석 현황 신호, 커버 이미지, 온라인 또는 지난 이벤트 여부를 담은 공개 이벤트 목록입니다. 이러한 레코드는 이벤트 탐색, 일정 모니터링, 장소 조사, 참석 현황 비교에 활용할 수 있습니다.
Facebook Events Search API 주요 기능
- 키워드 기반 이벤트 탐색텍스트 검색어로 특정 주제, 활동, 단체, 장소와 관련된 공개 Facebook 이벤트 레코드를 찾습니다.
- 이벤트 식별 정보와 일정일치하는 레코드의 이벤트 ID, 이름, 공개 URL, 일정 텍스트, 정규화된 시작 시각을 반환합니다.
- 장소·이벤트 상태 정보장소 ID, 장소 이름, 온라인 여부, 지난 이벤트 여부를 보존해 장소와 시기 맥락을 구분할 수 있습니다.
- 참석 현황과 커버 필드공개된 관심 있음·참석 예정·참석 완료 수와 함께, 있는 경우 공개 커버 이미지 참조를 포함합니다.
Facebook Events Search API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 필수 | 공개 Facebook 이벤트를 검색하는 데 사용하는 키워드 검색어로, 비어 있지 않아야 합니다. |
results_limit | 선택 | 수집할 이벤트 레코드의 최대 개수로, 7에서 2,000 사이입니다. 기본값은 100입니다. |
Facebook Events Search API 사용 방법
키워드를 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 이벤트 레코드를 커서 페이지네이션으로 읽습니다.
- 비어 있지 않은 키워드 검색어를 준비하고, 필요하면 7에서 2,000 사이의 results_limit 값을 선택합니다.
- query와 results_limit 값을 /v1/facebook/events-search로 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/events-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"technology conference","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.Facebook Events Search API 추천 활용 사례
- 주제별 이벤트 탐색: 구체적인 검색어로 이벤트 이름, 공개 URL, 일정 텍스트를 모아 관련 공개 이벤트 목록을 구성합니다.
- 일정 모니터링: 수집 시점별로 정규화된 시작 시각, 일정 텍스트, 이벤트 ID, 지난 이벤트 여부를 비교합니다.
- 장소·형식 조사: 일치한 이벤트를 장소 ID, 장소 이름, 온라인 여부별로 정리해 이벤트가 어디에서 어떤 방식으로 게시되는지 파악합니다.
- 공개된 참석 현황 비교: 이벤트 레코드 전반의 관심 있음·참석 예정·참석 완료 수를 이름, 시작 시각과 함께 비교합니다.
Facebook Events Search API 활용 팁
- 넓은 검색어에서 관련 없는 이벤트 레코드가 나오면 구체적인 주제, 활동, 단체 또는 장소 표현을 사용하세요.
- 필요한 범위에 맞춰 results_limit 값을 7에서 2,000 사이로 지정하세요. 생략하면 기본값인 100건을 요청합니다.
- 반복 검색한 결과를 합칠 때는 이벤트 ID나 공개 URL을 기준으로 삼아 같은 이벤트가 두 번 집계되지 않게 하세요.
- 레코드를 애플리케이션에 매핑할 때 장소, 커버 미디어, 참석 현황 수, 이벤트 상태 필드는 선택 값으로 취급하세요.
관련 API
Facebook Events Search 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 Profile Events API — 프로필 또는 페이지 URL과 연결된 공개 이벤트를 이름, 일정, 위치, 미디어, 공개된 지표, 출처 맥락과 함께 수집합니다.