facebook/
profiles

알고 있는 URL에서 공개 Facebook 프로필과 페이지 정보를 수집하고, 식별 정보, 이름, 소개, 프로필 이미지, 공개된 카운터를 입력당 최대 1건의 정규화된 레코드로 반환합니다.

Facebook Profiles API

프로필 조회
페이지 조회
알고 있는 URL
결과당 1.2 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Profiles

Facebook 프로필과 페이지는 이름, 소개 또는 about 텍스트, 프로필 이미지, 정식 링크, 공개된 오디언스·활동 카운터를 갖춘 공개 신원 화면입니다. 이러한 식별 필드와 공개 신호는 URL 정보 보강, 엔티티 매칭, 메타데이터 스냅샷, 비교 조사에 활용할 수 있습니다.

Facebook Profiles API 주요 기능

  • 알고 있는 URL 직접 조회공개 Facebook 프로필 또는 페이지 URL을 여러 개 제출하면, 입력마다 정규화된 프로필 레코드를 최대 1건씩 받습니다.
  • 정규화된 식별 필드Facebook ID, 정식 URL, 표시 이름, 레코드 유형, 원래 입력 URL을 일관된 구조로 반환합니다.
  • 공개 프로필 소개공개된 소개, 인트로, 설명 또는 about 텍스트를 확인 가능한 프로필·페이지 프로필 이미지와 함께 가져옵니다.
  • 공개된 프로필 카운터대상이 공개하는 팔로워, 팔로잉, 게시물, 좋아요, 댓글, 조회, 재생, 공유 카운터를 일반적인 형태로 정규화합니다.

Facebook Profiles API 매개변수

매개변수필수설명
urls필수공개 Facebook 프로필 또는 페이지 URL로, 필수 값입니다. 허용되는 호스트는 facebook.com, www.facebook.com, m.facebook.com이며, 여러 값은 쉼표 또는 줄바꿈으로 구분합니다.

Facebook Profiles API 사용 방법

프로필 또는 페이지 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 프로필 레코드를 읽습니다.

  1. facebook.com, www.facebook.com, m.facebook.com의 공개 프로필 또는 페이지 URL을 하나 이상 준비합니다.
  2. urls 배열을 /v1/facebook/profiles로 POST합니다.
  3. status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽고, results.has_more가 true인 동안에는 results.next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/facebook/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.facebook.com/NASA"]}'

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

Facebook Profiles API 추천 활용 사례

  • 프로필·페이지 카탈로그 정보 보강: 알고 있는 Facebook URL 카탈로그에 정규화된 ID, 이름, 정식 링크, 소개 텍스트, 프로필 이미지, 공개된 카운터를 추가합니다.
  • 알고 있는 URL의 신원 매칭: 반환된 ID, 정식 URL, 이름, extra.input_url로 제출한 링크를 기존 엔티티 레코드와 연결합니다.
  • 공개 메타데이터 스냅샷: 확인 가능한 프로필 텍스트, 프로필 이미지, 카운터와 함께 collected_at을 저장해 수집 시점별 공개 메타데이터를 비교합니다.

Facebook Profiles API 활용 팁

  • 요청 검증은 Facebook 호스트만 확인하고 리소스 경로는 확인하지 않으므로, 각 URL이 의도한 프로필이나 페이지를 가리키는지 확인하세요.
  • 중복되거나 조회할 수 없는 입력 때문에 제출한 URL보다 레코드가 적을 수 있으므로, 여러 URL을 제출한 작업의 결과를 대조할 때는 extra.input_url을 보존하세요.
  • 개인 프로필과 페이지가 공개하는 필드가 서로 다르므로 이름, 프로필 텍스트, 프로필 이미지, 개별 지표 값은 null일 수 있는 값으로 취급하세요.
  • 프로필 수준의 메타데이터가 아니라 게시물, 사진, 릴스, 이벤트, 리뷰가 필요하다면 해당하는 Facebook 콘텐츠 엔드포인트를 사용하세요.

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

  • Facebook Pages API — 공개 페이지 프로필, 연락처, 이미지, 공개된 오디언스 평점을 가져옵니다.
  • Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
  • Facebook Comments API — 게시물 URL에서 공개 댓글, 작성자, 참여도, 미디어, 출처 링크를 수집합니다.
  • Facebook Profile Events API — 프로필 또는 페이지 URL과 연결된 공개 이벤트를 이름, 일정, 위치, 미디어, 공개된 지표, 출처 맥락과 함께 수집합니다.
  • Facebook Profile Photos API — 프로필 또는 페이지 URL에서 공개 사진을 캡션, 작성자 맥락, 참여도, 이미지 메타데이터, 출처 참조와 함께 수집합니다.
  • Facebook Reels API — 프로필 또는 페이지 URL에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.

다른 플랫폼 둘러보기

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

Facebook Profiles API — 자주 묻는 질문

Facebook Profiles API는 알고 있는 Facebook 프로필 또는 페이지 URL에서 공개 식별 정보를 가져와 레코드를 보강하고 매칭하기 쉽게 해 주는 API입니다. URL 정보 보강, 엔티티 매칭, 프로필 스냅샷을 지원하며, 입력 하나당 공개 레코드는 최대 1건이고 키워드 기반 프로필 검색은 하지 않습니다.

facebook.com, www.facebook.com, m.facebook.com의 비어 있지 않은 URL을 제출하세요. 검증은 호스트만 확인하고 경로가 프로필이나 페이지를 가리키는지는 확인하지 않으므로, 이 엔드포인트는 프로필 검색이 아니라 직접 조회를 수행합니다.

정규화된 레코드에는 id, platform, resource, type, url, name, text, avatar_url, metrics, created_at, collected_at, extra.input_url이 들어 있습니다. created_at은 현재 null로 반환됩니다.

네. 공개 프로필 또는 페이지 URL을 대상으로 하는 조회입니다. 공개되는 필드가 서로 다르므로, 모든 레코드에 같은 소개, 프로필 이미지, 카운터가 있다고 가정해서는 안 됩니다.

URL 하나에서는 레코드가 최대 1건 생성되며, 중복되었거나 비공개이거나 로그인이 필요하거나 삭제되었거나 오타가 있거나 조회할 수 없는 대상은 레코드가 없을 수 있습니다. extra.input_url로 반환된 레코드를 원래 요청과 대조하세요.

저장된 프로필 레코드 1건마다 1.2 크레딧이 차감되며, 기본 작업 요금은 없습니다. 결과가 비어 있으면 결과 요금이 발생하지 않습니다.