facebook/
events-search

키워드로 공개 Facebook 이벤트를 검색하고, 이벤트 식별 정보, 일정, 장소, 참석 현황, 커버 미디어, 상태 필드를 정규화된 레코드로 반환합니다.

Facebook Events Search API

이벤트 검색
키워드 검색어
공개 이벤트
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 폴링한 뒤, 정규화된 이벤트 레코드를 커서 페이지네이션으로 읽습니다.

  1. 비어 있지 않은 키워드 검색어를 준비하고, 필요하면 7에서 2,000 사이의 results_limit 값을 선택합니다.
  2. query와 results_limit 값을 /v1/facebook/events-search로 POST합니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /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을 기준으로 삼아 같은 이벤트가 두 번 집계되지 않게 하세요.
  • 레코드를 애플리케이션에 매핑할 때 장소, 커버 미디어, 참석 현황 수, 이벤트 상태 필드는 선택 값으로 취급하세요.

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과 연결된 공개 이벤트를 이름, 일정, 위치, 미디어, 공개된 지표, 출처 맥락과 함께 수집합니다.

다른 플랫폼 둘러보기

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

Facebook Events Search API — 자주 묻는 질문

Facebook Events Search API는 필수 키워드 검색어로 공개 Facebook 이벤트를 검색하는 API입니다. 이벤트 식별 정보, 일정, 장소, 공개된 참석 현황 신호, 커버 미디어, 이벤트 상태 필드를 반환합니다.

비어 있지 않은 query 문자열을 입력하세요. results_limit 값은 선택이며, 기본값은 100이고 7에서 2,000 사이의 정수를 받습니다.

레코드에는 이벤트 ID, 제목, 공개 URL, 일정 텍스트, 시작 시각, 장소 ID와 이름, 관심 있음·참석 예정·참석 완료 수, 커버 이미지, 온라인 또는 지난 이벤트 여부가 포함될 수 있습니다.

검색은 제출한 키워드와 일치하는 공개 이벤트를 대상으로 합니다. 지원되는 공개 결과가 일치하지 않으면 완료된 작업은 비어 있는 items 목록을 반환합니다.

반환된 이벤트 레코드 1건마다 0.6 크레딧이 차감되며, 기본 작업 요금은 없습니다.