Social Fetch

Social Fetch란?

Social Fetch는 여러 플랫폼의 공개 소셜 데이터를 한 번에 조회할 수 있는 통합 소셜 미디어 스크래퍼 API입니다. 각 사이트별 스크래퍼를 별도로 구축하고 유지보수할 필요 없이 프로필, 게시물/미디어, 댓글, 비디오/트랜스크립트, 관련 메트릭에 프로그래밍 방식으로 접근해야 하는 개발자와 팀을 위해 설계되었습니다.

단일 엔드포인트(플랫폼별 라우트 포함)를 통해 접근하며 정규화된 JSON 응답을 반환합니다. CRM 강화, 콘텐츠 파이프라인, 모니터링/조회 도구, 일관된 데이터 형태로 구축된 분석 대시보드 등의 워크플로를 구동하는 데 사용할 수 있습니다.

주요 기능

• 다양한 플랫폼 통합 API: 개별 플랫폼별 커스텀 파서 대신 단일 API로 프로필, 게시물/미디어, 댓글, 비디오, 트랜스크립트를 조회합니다.
• 정규화된 프로필 및 게시물 데이터: 응답에 공통 필드(예: 사용자명/핸들, 팔로워/구독자 수, 인증 상태, 아바타; 미디어 항목의 경우 캡션, 썸네일, 참여 메트릭, 타임스탬프)를 포함해 후속 처리의 일관성을 유지합니다.
• 실시간/라이브 업데이트: 현재 공개 데이터를 가져오는 데 초점을 맞춘 서비스로, 페이지에 “~1s avg” 라이브 데이터 지표가 표시됩니다.
• 검색 및 발견 기능: “Search & discovery”에 설명된 대로 네트워크 전반의 키워드/해시태그 및 사용자 발견을 지원합니다.
• 개발자 친화적 통합: x-api-key 헤더를 사용한 HTTP 요청으로 /v1/tiktok/... 및 /v1/instagram/... 같은 플랫폼 라우트에 접근합니다.
• 팀의 스크래핑 유지보수 불필요: 페이지에 “No scraping. No maintenance”라고 명시되어 있으며, 자체 스크래핑 로직 실행 대신 API 호출로 통합합니다.

Social Fetch 사용 방법

1. API 키 발급 후 x-api-key 헤더에 포함해 요청합니다.
2. 필요한 리소스에 맞는 플랫폼 엔드포인트 호출: 예를 들어 핸들로 TikTok 프로필, Instagram 프로필, 핸들로 YouTube 채널, Twitter/X 프로필 등을 호출합니다.
3. JSON 응답 처리: 반환 객체에는 엔드포인트에 따라 프로필 식별자, 수치, 미디어/트랜스크립트 관련 항목 등의 필드가 포함됩니다.

페이지의 예시 사용법:

• GET https://api.socialfetch.dev/v1/tiktok/profile?handle=charlidamelio
• GET https://api.socialfetch.dev/v1/instagram/profile?handle=instagram
• GET https://api.socialfetch.dev/v1/youtube/channel?handle=MrBeast
• GET https://api.socialfetch.dev/v1/twitter/profile?handle=elonmusk

사용 사례

• 크리에이터 및 인플루언서 조회: 핸들/채널명을 입력받아 정규화된 프로필 필드(표시 이름, 바이오/설명, 팔로워/구독자 수, 인증, 아바타 URL)를 반환하는 조회 도구 구축.
• 경쟁 콘텐츠 추적: 대상 계정의 게시물 및 미디어를 주기적으로 가져와 캡션/썸네일, 참여 메트릭, 게시 타임스탬프를 저장해 비교.
• 계정 건강 대시보드: 프로필 및 메트릭 데이터를 사용해 팔로워/구독자 수, 인증 상태, 관련 계정 메타데이터를 시간에 따라 추적하는 대시보드 채우기.
• 공개 콘텐츠 신호 모니터링 및 알림: 업데이트된 공개 게시물/미디어를 가져와 콘텐츠나 참여 메트릭 변경을 감지해 알림을 트리거하는 보고 워크플로 생성.
• 트랜스크립트 포함 콘텐츠 파이프라인: 비디오 관련 콘텐츠의 경우 비디오 및 트랜스크립트 데이터를 가져와 후속 인덱싱, 요약, 검색 지원.

자주 묻는 질문

Social Fetch가 지원하는 플랫폼은?

페이지에 TikTok, Instagram, YouTube, X (Twitter)가 나열되며, LinkedIn, Reddit, Facebook, Google Threads, Bluesky, Pinterest, Snapchat, Twitch, Kick, Linktree, Truth Social 등 추가 플랫폼도 언급됩니다.

어떤 종류의 데이터를 조회할 수 있나요?

페이지에 따르면 Profiles, Posts & media, Comments, Videos, Transcripts와 함께 metrics 및 검색/발견(키워드, 해시태그, 사용자 발견)을 액세스할 수 있습니다.

스크래핑 로직을 구현해야 하나요?

아니요. 페이지에 “No scraping. No maintenance”라고 명시되어 있으며, 실행하는 스크래퍼가 아닌 호출하는 API로 위치짓습니다.

요청 인증 방법은?

x-api-key 헤더를 통한 API 키 사용(페이지에 예시 표시).

API가 반환하는 것은?

페이지에 표시된 샘플 JSON 응답에는 프로필 필드(예: 수치, 인증, 바이오, 아바타 URL)와 채널/비디오 관련 필드(예: 구독자/비디오 수, 설명, 엔드포인트에 따른 미디어/트랜스크립트 필드)가 포함됩니다.

대안

• 지원되는 플랫폼별 API: 지원되는 엔드포인트에 대해 공식 또는 준공식 플랫폼 API를 사용하세요. 일반적으로 플랫폼별 설정과 서로 다른 응답 형식을 필요로 합니다.
• 커스텀 스크래핑 서비스 또는 헤드리스 브라우저 스크래퍼: 공개 데이터를 직접 수집하기 위해 자체 스크래퍼를 실행하세요. 유지보수 노력과 취약성을 관리된 API 사용과 맞바꿉니다.
• 내보내기 또는 API 액세스를 제공하는 소셜 분석 플랫폼: 분석/인사이트를 목적으로 한 도구를 사용하세요. 대시보드를 간소화할 수 있지만, 여기에 설명된 저수준 정규화된 JSON 워크플로와 동일하지 않을 수 있습니다.
• 범용 데이터 추출 도구: ETL/데이터 크롤링 프레임워크를 사용해 웹 데이터를 데이터셋으로 가져오고 변환하세요. 하지만 플랫폼별 추출 및 정규화 로직을 여전히 구축해야 합니다.