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 하나를 제출하고, 비동기 작업을 따라가며, 저장된 정규화 결과를 읽습니다.
- snapchat.com 또는 그 서브도메인의 공개 Snapchat Spotlight URL을 복사합니다.
- URL을 url로 /v1/snapchat/spotlight에 전송하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 onlySnapchat 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 크레딧을 예산에 반영하세요. 고정 요금은 반환된 필드나 결과 수에 따라 달라지지 않습니다.
관련 API
Snapchat Spotlight API 외에 Snapchat의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.