facebook/
reels

프로필 또는 페이지 URL에서 공개 Facebook 릴스를 수집하고, 캡션, 작성자 정보, 참여도, 동영상 메타데이터, 원본 링크를 정규화된 레코드로 반환합니다.

Facebook Reels API

프로필 릴스
동영상 메타데이터
공개 데이터
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Reels

Facebook 릴스는 프로필 또는 페이지 피드에 올라오는 숏폼 공개 동영상으로, 캡션, 작성자 정보, 재생 메타데이터, 타임스탬프, 공개된 참여도를 담고 있습니다. 이러한 레코드는 콘텐츠 인벤토리, 숏폼 동영상 조사, 피드 모니터링, 비교 분석에 활용할 수 있습니다.

Facebook Reels API 주요 기능

  • 여러 프로필의 릴스 피드Facebook 프로필 또는 페이지 URL을 하나 이상 받아 공개 릴스 레코드를 수집하며, 요청한 제한을 입력마다 적용하고 출처 표기를 위해 extra.input_url을 유지합니다.
  • 정규화된 동영상 미디어릴스 ID, 공개 원본 링크와 함께 동영상 URL, 썸네일, 크기, 재생 시간 메타데이터를 반환합니다.
  • 크리에이터·참여도 정보정규화된 릴스마다 캡션, 공개된 작성자 원본 정보, 공개된 좋아요·댓글·조회·재생·공유 수, 게시 시각을 보존합니다.
  • 안정적인 피드 탐색프로필별 커서를 따라가며, 입력별 제한에 닿기 전에 ID, 게시물 ID 또는 URL이 같은 릴스를 중복 제거합니다.

Facebook Reels API 매개변수

매개변수필수설명
urls필수공개 Facebook 프로필 또는 페이지 URL로, 쉼표 또는 줄바꿈으로 구분합니다.
results_limit선택입력 URL마다 수집할 릴스의 최대 개수로, 20에서 2,000 사이입니다. 기본값은 100입니다.

Facebook Reels API 사용 방법

공개 프로필 또는 페이지 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 릴스 레코드를 결과 커서 페이지네이션으로 읽습니다.

  1. 릴스 피드가 노출되는 공개 Facebook 프로필 또는 페이지 URL을 하나 이상 준비합니다.
  2. urls 배열과 선택 값인 results_limit 값을 /v1/facebook/reels로 POST합니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50을 읽고, 저장된 릴스가 더 있으면 results.next_cursor를 전달합니다.
curl -X POST "https://api.socq.ai/v1/facebook/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Facebook Reels API 추천 활용 사례

  • 프로필 릴스 인벤토리: 릴스 ID, 원본 링크, 캡션, 동영상 참조, 타임스탬프, extra.input_url을 프로필별 콘텐츠 색인으로 정리합니다.
  • 숏폼 동영상 포맷 조사: 재생 시간, 크기, 썸네일, 캡션, 공개된 참여도를 비교해 공개 릴스가 어떻게 구성되고 어떤 반응을 얻는지 살펴봅니다.
  • 릴스 피드 모니터링: 선택한 프로필 또는 페이지 URL을 반복 수집하고, 안정적인 릴스 식별자와 게시 시각으로 새로 노출된 레코드를 찾아냅니다.

Facebook Reels API 활용 팁

  • 공개 릴스 피드가 노출되는 facebook.com, www.facebook.com, m.facebook.com의 프로필·페이지 URL을 사용하세요. 호스트 검증만으로는 대상 리소스가 적합하다고 보장되지 않습니다.
  • 20에서 2,000 사이의 제한은 모든 URL에 각각 적용되므로, 입력 URL 수를 감안해 results_limit 값을 정하세요.
  • 반복 실행한 결과를 합칠 때는 릴스 ID, 게시물 ID 또는 URL을 extra.input_url과 함께 기준으로 중복을 제거해 올바른 출처 프로필을 유지하세요.
  • 캡션, 작성자 필드, 지표, 타임스탬프, 미디어 메타데이터는 선택 값으로 취급하고, 렌더링하거나 다운로드하기 전에 media에 동영상 URL이 들어 있는지 확인하세요.
  • 음성 텍스트가 필요하면 릴스 레코드에 스크립트가 들어 있기를 기대하지 말고, 알고 있는 릴스 URL을 Facebook Video Transcript API에 제출하세요.

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

  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
  • Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
  • Facebook Group Posts API — Facebook 그룹 URL에서 공개 게시물을 수집하며, 정렬 방식과 그룹별 제한을 선택할 수 있고 작성자 맥락, 동영상 미디어, 공개된 참여도를 포함합니다.
  • Facebook Ad Transcript API — Facebook 광고 라이브러리 URL에서 제공되는 음성 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
  • Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.

다른 플랫폼 둘러보기

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

Facebook Reels API — 자주 묻는 질문

Facebook Reels API는 지정한 Facebook 프로필 또는 페이지의 공개 릴스 피드에서 숏폼 동영상 레코드를 수집해 대량 인벤토리 작성과 지속적인 관찰을 쉽게 해 주는 API입니다. 콘텐츠 팀은 이 레코드를 계정 모니터링과 비교 조사에 활용할 수 있지만, 대상의 공개 피드로 접근 가능한 릴스만 대상입니다.

facebook.com, www.facebook.com, m.facebook.com의 공개 프로필 또는 페이지 대상을 사용하세요. 검증은 호스트만 확인하므로, 다른 종류의 Facebook 리소스는 적절한 릴스 피드가 반환되지 않을 수 있습니다.

레코드에는 릴스 ID, 정식 URL, 캡션 텍스트, 공개된 작성자 원본 정보, 공개된 지표, 동영상 URL, 썸네일, 크기, 재생 시간, created_at, collected_at, extra.input_url이 포함될 수 있습니다.

아니요. 릴스 레코드에는 캡션과 동영상 메타데이터가 담기며, 확인 가능한 음성 텍스트는 지원되는 릴스 URL에 대해 전용 Facebook Video Transcript API가 처리합니다.

아니요. 이 엔드포인트는 알고 있는 공개 프로필 또는 페이지 URL의 릴스 피드를 읽으며, 키워드 검색, 트렌드 탐색, 오디오 기반 탐색은 제공하지 않습니다.

results_limit 값을 20에서 2,000 사이로 지정하며, 기본값은 100입니다. 이 제한은 제출한 URL마다 따로 적용됩니다.

아니요. 수집은 URL별 제한, 확인 가능한 피드의 끝, 피드 100페이지 중 먼저 닿는 지점에서 멈추며, 비공개, 제한, 삭제, 로그인 전용이거나 그 밖의 이유로 확인할 수 없는 릴스는 빠질 수 있습니다.

저장된 릴스 레코드 1건마다 0.7 크레딧이 차감되며, 기본 작업 요금은 없습니다. 예상 요금은 URL당 결과 수 제한에 제출한 URL 수를 곱해 계산합니다.