API 목록으로 돌아가기
Snapchat 공개 데이터

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의 앱과 크리에이터·비즈니스 도구는 권한이 부여된 게시, 계정, 오디언스, 광고 워크플로를 위한 것입니다.

기능SocQSnapchat 제품 도구
주요 용도알고 있는 공개 Spotlight 상세 정보 하나 조회권한이 부여된 콘텐츠 제작·게시·관리·분석·홍보
인증SocQ API 키Snapchat 계정, 앱, 토큰 또는 제품별 권한 부여
시작 입력공개 snapchat.com URL 하나권한이 부여된 계정 또는 제품 컨텍스트
콘텐츠 게시·관리지원하지 않음해당 Snapchat 제품에서 사용 가능
응답 형식정규화된 ReelVideoItem 레코드제품별 Snapchat 고유 객체와 인터페이스

Snapchat API 작동 방식

Snapchat Spotlight는 비동기 작업을 실행한 뒤 저장된 결과를 읽는 방식으로 동작합니다.

  1. 1. 공개 URL 제출

    snapchat.com Spotlight URL 하나를 보내고 반환된 task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 성공하거나 실패로 보고될 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 저장된 결과 읽기

    data.results.items를 읽고, 공통 작업 리더가 저장된 레코드가 더 있다고 알려 줄 때만 next_cursor를 사용합니다.

Snapchat Spotlight 하나 가져오기

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.items

Snapchat 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 크레딧의 고정 요금이 부과됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.