snapchat/
spotlight

알고 있는 snapchat.com URL로 Snapchat 공개 Spotlight 하나를 조회하고, 제공되는 경우 정규화된 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 공개된 참여 필드를 받아 보세요.

Snapchat Spotlight API

Spotlight URL 하나
크리에이터 맥락
동영상 스냅샷
요청당 0.19 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Snapchat Spotlight

Snapchat 공개 Spotlight 레코드에는 원본 링크, 캡션, 크리에이터 정보, 미디어 참조, 게시 시각, 길이, 오디오 정보, 공개된 참여 수치가 담길 수 있습니다. 정규화된 결과는 제공되는 필드를 수집 타임스탬프와 함께 보존하므로, 선택한 동영상 검토, 카탈로그 정보 보강, 특정 시점 비교에 활용할 수 있습니다.

Snapchat Spotlight API 주요 기능

  • 알고 있는 Spotlight 조회공개 snapchat.com URL 하나를 제출하면 피드를 펼치지 않고, 일치하는 상세 응답을 표준 레코드 최대 하나로 변환합니다.
  • 크리에이터와 동영상 맥락원본 URL과 함께 제공되는 캡션, 작성자 정보, 미디어, 길이, 오디오, 해시태그, 멘션, 게시 시각을 고정된 결과 형식 하나에 담아 보존합니다.
  • 공개된 참여 스냅샷제공되는 좋아요, 댓글, 공유, 재생, 조회 수를 collected_at과 함께 반환하므로 후속 분석에서도 관측 시점이 유지됩니다.

Snapchat Spotlight API 매개변수

매개변수필수설명
url필수호스트가 snapchat.com 또는 그 서브도메인인 비어 있지 않은 http 또는 https URL로, 필수 값입니다. 런타임은 경로 규칙을 강제하지 않으며, /@username/spotlight/{spotlight_id} 같은 공개 Spotlight 링크를 사용하세요.

Snapchat Spotlight API 사용 방법

공개 Snapchat Spotlight URL 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 결과를 읽습니다.

  1. snapchat.com 또는 그 서브도메인의 공개 Snapchat Spotlight URL을 복사합니다.
  2. URL을 url로 /v1/snapchat/spotlight에 전송하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. 저장된 결과 응답에 has_more가 있으면 해당 next_cursor로 이어서 가져옵니다.
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; next_cursor paginates stored results only

Snapchat Spotlight API 추천 활용 사례

  • 선택한 Spotlight 검토: 알고 있는 공개 링크를 출처, 캡션, 작성자, 미디어, 시각, 제공되는 참여 필드를 갖춘 추적 가능한 레코드로 바꿉니다.
  • 콘텐츠 카탈로그 정보 보강: 기존 URL 목록에 정규화된 동영상 식별 정보, 크리에이터 맥락, 길이, 오디오, 해시태그, 멘션, 수집 시각을 추가합니다.
  • 수집한 참여 수치 비교: 별도로 수집한 관측값을 비교할 때, 공개된 수치를 collected_at과 짝지어 두고 그 값을 실시간이거나 완전한 값으로 취급하지 않습니다.

Snapchat Spotlight API 활용 팁

  • url에는 URL을 정확히 하나만 제출하세요. 배열, results_limit, usernames, callback_url은 이 엔드포인트에서 허용되지 않습니다.
  • 검증은 경로가 아니라 Snapchat 호스트만 확인하지만, 공개 Spotlight 링크를 사용하세요. 관련 없는 Snapchat 경로는 제공처에서 실패할 수 있습니다.
  • 제공처 조회는 레코드 최대 하나를 반환하는 단일 상세 요청이므로, 작업 결과의 next_cursor를 원본 피드 페이지네이션으로 취급하지 마세요.
  • 공개 응답에 없으면 ID, 캡션, 작성자 필드, 미디어, 타임스탬프, 오디오, 개별 수치가 null일 수 있다고 가정하세요.
  • 모든 측정값이 수집 시점과 연결되도록 참여 수치 옆에 collected_at을 함께 저장하세요.
  • 성공한 작업마다 0.19 크레딧을 예산에 반영하세요. 고정 요금은 반환된 필드나 결과 수에 따라 달라지지 않습니다.

Snapchat Spotlight API 외에 Snapchat의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Snapchat 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Snapchat Spotlight API — 자주 묻는 질문

Snapchat Spotlight API는 알고 있는 Snapchat URL의 공개 Spotlight 하나를 정규화된 동영상 레코드로 가져오는 프로그래밍 인터페이스입니다.

호스트가 snapchat.com이거나 www.snapchat.com 같은 서브도메인인, 비어 있지 않은 http 또는 https URL을 제출합니다. 런타임은 특정 경로를 강제하지 않지만, 제공처는 공개 Spotlight 링크를 기대합니다.

아니요. 입력은 url만 받고 상세 조회를 한 번 수행하므로, 피드를 탐색하지 않으며 results_limit도 받지 않습니다.

공용 작업 리더가 저장된 레코드에 대해 limit, next_cursor, has_more를 노출할 뿐이며, 이 필드들 때문에 Spotlight 조회가 원본 페이지네이션 요청이 되지는 않습니다.

아니요. 지원되는 공개 데이터를 가져올 뿐, 로그인, 게시, 수정, 삭제, 중재, 계정 관리, Snapchat 광고 운영은 하지 않습니다.

성공한 작업은 필드 제공 여부나 결과 수와 관계없이 고정 0.19 SocQ 크레딧이 차감됩니다.