Facebook Profile Photos
Facebook 프로필 사진은 프로필이나 페이지 피드에 첨부된 공개 이미지로, 캡션, 작성자 정보, 공개된 참여도, 크기, 원본 링크를 담고 있습니다. 이러한 레코드는 미디어 인벤토리, 시각 콘텐츠 조사, 프로필별 모니터링에 활용할 수 있습니다.
Facebook Profile Photos API 주요 기능
- 여러 프로필의 사진 피드Facebook 프로필 또는 페이지 URL을 하나 이상 받아 공개 사진 레코드를 수집하며, 요청한 제한은 입력마다 따로 적용됩니다.
- 정규화된 이미지 메타데이터사진 ID, 정식 링크와 함께 이미지 URL, 썸네일, 너비, 높이, 재생 시간(duration) 메타데이터를 반환합니다.
- 사진·출처 정보분석과 출처 표기를 위해 캡션, 공개된 작성자 데이터, 공개된 참여도, 타임스탬프, extra.input_url을 보존합니다.
- 커서 기반 피드 탐색공개 사진 피드의 커서를 따라가며, 입력별 제한에 닿기 전에 안정적인 ID, URL 또는 이미지 식별자가 같은 레코드를 중복 제거합니다.
Facebook Profile Photos API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | 공개 Facebook 프로필 또는 페이지 URL로, 쉼표 또는 줄바꿈으로 구분합니다. |
results_limit | 선택 | 입력 URL마다 수집할 사진의 최대 개수로, 20에서 2,000 사이입니다. 기본값은 100입니다. |
Facebook Profile Photos API 사용 방법
공개 프로필 또는 페이지 URL을 비동기 작업으로 제출하고, 작업 ID를 폴링한 뒤, 정규화된 사진 레코드를 결과 커서 페이지네이션으로 읽습니다.
- 공개 Facebook 프로필 또는 페이지 URL을 하나 이상 준비합니다.
- urls 배열과 선택 값인 results_limit 값을 /v1/facebook/profile-photos로 POST합니다.
- status가 succeeded가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- /v1/tasks/{task_id}?limit=50을 읽고, 저장된 사진이 더 있으면 results.next_cursor를 전달합니다.
curl -X POST "https://api.socq.ai/v1/facebook/profile-photos" \
-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 Profile Photos API 추천 활용 사례
- 공개 미디어 인벤토리: 사진 ID, 정식 링크, 이미지 URL, 크기, 캡션, 입력 출처를 프로필별 자산 색인으로 정리합니다.
- 시각 콘텐츠 조사: 캡션, 이미지 메타데이터, 타임스탬프, 공개된 참여도를 비교해 공개 사진 게시 패턴을 살펴봅니다.
- 프로필 사진 모니터링: 선택한 프로필 또는 페이지 URL을 반복 수집하고, 사진 식별자와 extra.input_url로 새로 노출된 레코드를 찾아냅니다.
Facebook Profile Photos API 활용 팁
- 공개 사진 피드가 노출되는 facebook.com, www.facebook.com, m.facebook.com의 프로필·페이지 URL을 사용하세요. 호스트 검증만으로는 대상 리소스가 적합하다고 보장되지 않습니다.
- 20에서 2,000 사이의 제한은 모든 URL에 각각 적용되므로, 입력 URL 수를 감안해 results_limit 값을 정하세요.
- 여러 번 수집한 결과를 합칠 때는 사진 id, URL 또는 이미지 식별자를 extra.input_url과 함께 기준으로 중복을 제거해 올바른 출처 프로필을 유지하세요.
- 캡션, 작성자 필드, 지표, 타임스탬프, 미디어 크기는 선택 값으로 취급하고, 렌더링하거나 다운로드하기 전에 media에 이미지 URL이 들어 있는지 확인하세요.
관련 API
Facebook Profile Photos API 외에 Facebook의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Facebook Posts API — 지원되는 Facebook URL에서 공개 게시물, 미디어, 반응, 댓글, 공유 수를 수집합니다.
- Facebook Video Transcript API — 공개 동영상 게시물 또는 릴스 URL에서 제공되는 스크립트 텍스트와 형식을 추출합니다.
- Facebook Group Posts API — Facebook 그룹 URL에서 공개 게시물을 수집하며, 정렬 방식과 그룹별 제한을 선택할 수 있고 작성자 맥락, 동영상 미디어, 공개된 참여도를 포함합니다.
- Facebook Ad Transcript API — Facebook 광고 라이브러리 URL에서 제공되는 음성 텍스트, 언어, 형식, 출처 맥락을 추출합니다.
- Facebook Profiles API — 알고 있는 Facebook URL에서 공개 프로필 또는 페이지를 조회하며, 계정 정보, 소개글, 프로필 이미지, 공개된 카운터, 입력 맥락을 포함합니다.
- Facebook Reels API — 프로필 또는 페이지 URL에서 공개 릴스를 캡션, 작성자 맥락, 동영상 메타데이터, 공개된 참여도, 출처 참조와 함께 수집합니다.