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를 폴링한 뒤, 정규화된 프로필 레코드를 읽습니다.
- facebook.com, www.facebook.com, m.facebook.com의 공개 프로필 또는 페이지 URL을 하나 이상 준비합니다.
- urls 배열을 /v1/facebook/profiles로 POST합니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /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 콘텐츠 엔드포인트를 사용하세요.
관련 API
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에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.