Snapchat Spotlight Comments
Snapchat Spotlight 댓글은 지정한 Spotlight 항목 하나에 달린 공개 반응입니다. SocQ는 반환된 반응을 각각 CommentItem으로 저장하며, 원본 식별 정보, 댓글 텍스트, 제공되는 작성자 맥락, 부모와 게시물 참조, 게시·수집 시각, 공개된 좋아요·답글 수가 담깁니다.
Snapchat Spotlight Comments API 주요 기능
- 작업당 Spotlight URL 하나snapchat.com 또는 Snapchat 서브도메인의 비어 있지 않은 url 하나를 제출하면, 제공처가 해당 대상의 원본 페이지 한 쪽을 요청합니다.
- 정규화된 댓글 레코드댓글 ID, 텍스트, 원본 URL, 타임스탬프, 제공되는 작성자 정보를 안정적인 CommentItem 1.0 결과 형식으로 읽습니다.
- 스레드 및 참여 맥락원본에서 제공되는 경우 parent_id, post_id, likes_count, replies_count를 보존하며, 누락된 필드를 0이나 스레드 전체 수집으로 간주하지 않습니다.
Snapchat Spotlight Comments API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 비어 있지 않은 Snapchat URL로, 필수 값입니다. 런타임 검증은 snapchat.com과 그 서브도메인을 허용하므로, 제공처가 의도한 Spotlight 리소스를 받을 수 있도록 정식 공개 URL인 /@username/spotlight/{spotlight_id} 형식을 사용하세요. |
Snapchat Spotlight Comments API 사용 방법
공개 Snapchat Spotlight URL을 제출하고, 비동기 작업을 따라가며, 저장된 정규화 댓글을 작업 결과 페이지네이션으로 읽습니다.
- 확인하려는 정식 공개 Snapchat Spotlight URL을 복사합니다.
- url을 /v1/snapchat/spotlight-comments로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽습니다. 저장된 작업 결과가 API 응답 여러 페이지에 걸쳐 있으면 has_more가 true인 동안 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/snapchat/spotlight-comments" \
-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 and follow next_cursor while has_more is trueSnapchat Spotlight Comments API 추천 활용 사례
- 정성적 반응 검토: 반환된 공개 댓글 텍스트와 제공되는 작성자 맥락을 살펴, 선택한 Spotlight에 대한 질문, 반응, 반복되는 주제를 파악합니다.
- 원본 링크가 있는 댓글 아카이브: 댓글 ID, 원본 URL, post_id, parent_id, published_at, collected_at을 보존해 저장된 모든 반응이 제공되는 출처 정보를 유지하게 합니다.
- 공개된 참여 스냅샷: 반환된 댓글의 likes_count와 replies_count를 비교하되, 각 관측값을 collected_at 시점에 고정해 둡니다.
Snapchat Spotlight Comments API 활용 팁
- 런타임 검증은 정확한 경로가 아니라 Snapchat 호스트만 확인하지만, 항상 정식 공개 URL인 /@username/spotlight/{spotlight_id} 형식을 사용하세요.
- 제출 페이로드에 cursor나 results_limit을 보내지 마세요. 이 엔드포인트는 url만 다루며 제공처 페이지 한 쪽만 수집합니다.
- parent_id와 replies_count는 제공되는 맥락일 뿐, 반환된 레코드에 답글 트리 전체가 들어 있다는 뜻은 아닙니다.
- 원본이 제공하지 않으면 ID, URL, 텍스트, 작성자 필드, published_at, parent_id, post_id, metrics가 null일 수 있다고 가정하세요.
- 제공처 수집 깊이와 GET /v1/tasks/{task_id} 페이지네이션은 별개로 취급하세요. 이 커서는 완료된 작업이 이미 저장한 결과 안에서만 페이지를 넘깁니다.
관련 API
Snapchat Spotlight Comments API 외에 Snapchat의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Snapchat Profile API
- Snapchat Spotlight API — 알고 있는 공개 Snapchat Spotlight 하나를 가져오며, 확인 가능한 경우 정규화된 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 공개된 참여도 필드를 포함합니다.