snapchat/
spotlight-comments

Snapchat Spotlight URL 하나의 공개 댓글을 원본 페이지 한 쪽 분량으로 수집하고, 정규화된 텍스트, 작성자, 스레드 참조, 타임스탬프, 공개된 참여 필드를 제공합니다.

Snapchat Spotlight Comments API

Spotlight URL 입력
원본 페이지 1개
정규화된 댓글
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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을 제출하고, 비동기 작업을 따라가며, 저장된 정규화 댓글을 작업 결과 페이지네이션으로 읽습니다.

  1. 확인하려는 정식 공개 Snapchat Spotlight URL을 복사합니다.
  2. url을 /v1/snapchat/spotlight-comments로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Snapchat 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} 페이지네이션은 별개로 취급하세요. 이 커서는 완료된 작업이 이미 저장한 결과 안에서만 페이지를 넘깁니다.

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

  • Snapchat Profile API
  • Snapchat Spotlight API — 알고 있는 공개 Snapchat Spotlight 하나를 가져오며, 확인 가능한 경우 정규화된 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 공개된 참여도 필드를 포함합니다.

다른 플랫폼 둘러보기

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

Snapchat Spotlight Comments API — 자주 묻는 질문

Snapchat Spotlight Comments API는 지정한 Snapchat Spotlight URL에 연결된 공개 댓글 레코드를 원본 페이지 한 쪽 분량으로 수집하는 프로그래밍 인터페이스입니다.

제출 사양은 필수 url 문자열 정확히 하나만 받습니다. 런타임 검증은 snapchat.com 호스트 또는 서브도메인을 요구하므로, 의도한 리소스에는 정식 공개 URL인 /@username/spotlight/{spotlight_id} 형식을 사용하세요.

아니요. 제출 사양에는 results_limit이나 cursor 필드가 없으며, 제공처 연동은 원본 요청을 한 번만 보냅니다.

이 커서는 GET /v1/tasks/{task_id}의 것입니다. 성공한 작업에 이미 저장된 댓글 레코드를 기본 응답 제한 50, 허용 범위 1~500으로 페이지 단위로 넘기며, 다른 Snapchat 원본 페이지를 가져오지는 않습니다.

CommentItem 1.0에는 id, platform, resource, type, url, published_at, collected_at, text, author, parent_id, post_id, 그리고 likes_count와 replies_count를 담은 metrics가 포함됩니다. null 허용 필드는 제공되지 않으면 null로 유지됩니다.

성공한 Snapchat Spotlight Comments 작업은 원본 페이지 한 쪽에서 반환된 댓글 수와 관계없이 고정 0.19 SocQ 크레딧이 차감됩니다.