Snapchat 공개 데이터 API
알고 있는 공개 Snapchat Spotlight 하나를 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 참여도 필드가 포함된 정규화된 레코드로 가져옵니다.
사용할 수 있는 Snapchat API
공개 snapchat.com Spotlight URL이 하나 있고 제공되는 상세 정보를 표준 결과 형식으로 받고 싶을 때 Snapchat Spotlight를 사용합니다.
어떤 Snapchat 데이터를 가져올 수 있나요?
SocQ는 알고 있는 공개 Spotlight 하나를 고정된 ReelVideoItem 레코드로 변환하며, 원본 응답에서 제공되는 필드만 보존합니다.
Spotlight 식별 정보와 출처
제공되는 항목 ID, 원본 공개 URL, 리소스 유형, 게시 시각, 수집 시각을 보존합니다.
캡션과 크리에이터 정보
제공되는 텍스트와 함께 크리에이터 ID, 사용자 이름, 표시 이름, 프로필 URL, 프로필 사진, 인증 여부, 비공개 여부 플래그를 반환합니다.
동영상, 오디오, 분류 정보
제공되는 미디어 참조, 길이, 오디오 메타데이터, 숏코드, 해시태그, 멘션을 정규화된 레코드에 보존합니다.
공개된 참여도
제공되는 좋아요, 댓글, 공유, 재생, 조회 수를 특정 시점의 공개 값으로 수집합니다.
SocQ vs Snapchat 제품 도구
SocQ는 지원하는 공개 Spotlight 상세 조회에 집중합니다. Snapchat의 앱과 크리에이터·비즈니스 도구는 권한이 부여된 게시, 계정, 오디언스, 광고 워크플로를 위한 것입니다.
| 기능 | SocQ | Snapchat 제품 도구 |
|---|---|---|
| 주요 용도 | 알고 있는 공개 Spotlight 상세 정보 하나 조회 | 권한이 부여된 콘텐츠 제작·게시·관리·분석·홍보 |
| 인증 | SocQ API 키 | Snapchat 계정, 앱, 토큰 또는 제품별 권한 부여 |
| 시작 입력 | 공개 snapchat.com URL 하나 | 권한이 부여된 계정 또는 제품 컨텍스트 |
| 콘텐츠 게시·관리 | 지원하지 않음 | 해당 Snapchat 제품에서 사용 가능 |
| 응답 형식 | 정규화된 ReelVideoItem 레코드 | 제품별 Snapchat 고유 객체와 인터페이스 |
Snapchat API 작동 방식
Snapchat Spotlight는 비동기 작업을 실행한 뒤 저장된 결과를 읽는 방식으로 동작합니다.
1. 공개 URL 제출
snapchat.com Spotlight URL 하나를 보내고 반환된 task_id를 저장합니다.
2. 작업 추적
처리가 성공하거나 실패로 보고될 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 저장된 결과 읽기
data.results.items를 읽고, 공통 작업 리더가 저장된 레코드가 더 있다고 알려 줄 때만 next_cursor를 사용합니다.
SocQ API 키로 인증하고 공개 Spotlight URL 하나를 제출합니다.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.snapchat.com/@queenhaley_13/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYY2pnZnF0bG52AZslQsUdAZslQoRQAAAAAQ"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.itemsSnapchat API 주요 활용 사례
선별한 콘텐츠 리서치
직접 고른 Spotlight URL을 추적 가능한 레코드로 변환해 검토와 주석 작업에 활용합니다.
카탈로그 정보 보강
기존 링크 모음에 제공되는 크리에이터, 캡션, 미디어, 오디오, 길이, 분류, 타임스탬프 필드를 추가합니다.
참여도 스냅샷
collected_at을 관측 시각으로 보관하면서, 별도로 수집한 결과 간 공개 지표를 비교합니다.
제한 사항과 공개 데이터 정책
Snapchat Spotlight 결과는 특정 시점의 공개 레코드이며, 권한이 필요한 Snapchat 계정 작업은 제공하지 않습니다.
- 페이로드는 필수 url을 정확히 하나만 받으며, results_limit이나 callback_url 같은 추가 필드는 거부합니다.
- 검증은 snapchat.com과 그 하위 도메인을 허용하지만 경로는 확인하지 않습니다. 관련 없는 경로는 데이터 제공자 단계에서 실패할 수 있으므로 공개 Spotlight 링크를 사용하세요.
- 데이터 제공자는 상세 조회를 한 번 수행하고 정규화된 항목을 최대 1건 반환하며, Spotlight 피드는 반환하지 않습니다.
- 저장된 결과의 페이지네이션은 공통 작업 리더의 기능이며 Snapchat 원본의 페이지네이션이 아닙니다.
- 선택 항목인 캡션, 크리에이터, 미디어, 게시, 오디오, 길이, 분류, 지표 필드는 null일 수 있습니다.
- 이 엔드포인트는 로그인, 게시, 수정, 삭제, 모더레이션, 계정 관리, 광고 운영을 하지 않습니다.
Snapchat API 자주 묻는 질문
Snapchat Spotlight API는 무엇을 가져오나요?
알고 있는 공개 Spotlight 하나를 가져와, 수집 시점에 제공되는 원본 필드가 담긴 정규화된 레코드를 최대 1건 반환합니다.
Snapchat API로 Spotlight 피드를 수집할 수 있나요?
아니요. 현재 엔드포인트는 단일 상세 조회이며, 원본 탐색용 프로필, 검색어, 커서, results_limit은 받지 않습니다.
반환되는 참여도 수치는 실시간인가요?
아니요. 제공되는 수치는 collected_at 시점에 캡처한 공개 스냅샷이며, 완전하거나 지속적으로 갱신되는 분석 데이터로 간주하지 마세요.
SocQ로 Snapchat에 게시할 수 있나요?
아니요. 이 공개 데이터 엔드포인트는 로그인, 게시, 계정 관리, 모더레이션, 광고 운영 기능을 제공하지 않습니다.
Snapchat Spotlight 요금은 어떻게 되나요?
성공한 작업은 반환된 필드 제공 여부나 결과 수와 관계없이 건당 0.19 SocQ 크레딧의 고정 요금이 부과됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Twitch API
알고 있는 공개 Twitch 사용자 이름을 정규화된 프로필로 확인하거나 공개 동영상 목록을 수집하고, 클립 하나를 내려받을 수 있는 동영상과 함께 가져와 크리에이터 리서치, 카탈로그 정보 보강, 비교, 스냅샷 모니터링에 활용합니다.
Rednote API
공개 프로필과 노트를 가져오고, 노트나 사용자를 검색하고, 댓글과 중첩 답글을 수집하고, 홈 추천 페이지 하나를 가져옵니다.
Kwai API
공개 Kwai 프로필, 계정 게시물 한 페이지, 이미 알고 있는 게시물 하나를 정규화된 식별 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여도와 함께 가져옵니다.
Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.
Google Ad Library API
공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.
Google Maps API
공개 장소를 찾고, 이미 알고 있는 Maps URL의 정규화된 상세 정보를 가져오고, 출처가 연결된 장소·작성자 정보와 함께 공개 리뷰를 수집합니다.


