snapchat/
profile

사용자 이름으로 Snapchat 공개 프로필 하나를 조회해 정규화된 계정 정보, 소개, 프로필 미디어, 웹사이트, 계정 속성, 위치, 제공되는 프로필 수치를 받아 보세요.

Snapchat Profile API

사용자 이름 조회
공개 프로필
정규화된 계정
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Snapchat Profile

Snapchat 공개 프로필에는 사용자 이름, 표시 이름, 소개, 아바타, 커버, 웹사이트, 계정 속성, 위치, 공개된 프로필 수치가 노출될 수 있습니다. 알고 있는 사용자 이름 하나를 정규화된 계정 스냅샷으로 바꿔 주는 이 조회 기능은 정보 보강, 검토, 이후 비교에 활용할 수 있습니다.

Snapchat Profile API 주요 기능

  • 정확한 사용자 이름 조회계정을 검색하는 대신, 알고 있는 Snapchat 사용자 이름을 작업당 하나씩 조회합니다. 앞에 @ 하나가 붙어 있어도 됩니다.
  • 정규화된 프로필 정보제공되는 사용자 이름, 표시 이름, 소개, 공개 URL, 고유 원본 식별자를 AccountItem 레코드로 반환합니다.
  • 프로필 미디어와 맥락제공되는 아바타, 커버, 웹사이트, 위치 필드를 따로 보존하므로 화면 표시, 인덱싱, 정보 보강 워크플로에 활용할 수 있습니다.
  • 공개된 계정 신호제공되는 인증·비공개 속성과 수집 시점의 팔로워·팔로잉·게시물 수를 기록합니다.

Snapchat Profile API 매개변수

매개변수필수설명
username필수Snapchat 사용자 이름으로, 필수 값입니다. 앞에 @를 선택적으로 하나 붙일 수 있고, 이어서 1~64자의 ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈을 입력합니다. 공백, 프로필 URL, 그 밖의 문자는 거부됩니다.

Snapchat Profile API 사용 방법

허용되는 사용자 이름 하나를 제출하고, 비동기 작업이 끝나기를 기다린 뒤 정규화된 프로필 결과를 읽습니다.

  1. 알고 있는 Snapchat 사용자 이름 하나를 정합니다. 영문자, 숫자, 마침표, 밑줄, 하이픈을 쓸 수 있고 앞의 @ 하나는 선택 사항입니다.
  2. username을 /v1/snapchat/profile로 전송하고, 반환된 task_id를 보관합니다.
  3. 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 data.results.items를 읽습니다. 이 상세 조회는 보통 프로필 하나 또는 빈 목록을 반환합니다.
curl -X POST "https://api.socq.ai/v1/snapchat/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"zane"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after the task succeeds

Snapchat Profile API 추천 활용 사례

  • 알고 있는 계정 정보 보강: Snapchat 사용자 이름이 이미 들어 있는 레코드에 공개 계정 정보, 소개, 프로필 미디어, 웹사이트, 제공되는 수치를 추가합니다.
  • 선택한 프로필 검토: 스토리, Spotlight, 계정 관리 작업은 섞지 않고, 공개 계정 하나를 일관된 프로필 카드나 검토 대기열에 표시합니다.
  • 공개 스냅샷 비교: 결과를 collected_at과 함께 차례로 저장해, 공개 프로필 텍스트, 계정 속성, 미디어, 공개된 수치가 시간에 따라 어떻게 달라지는지 비교합니다.

Snapchat Profile API 활용 팁

  • 요청은 앞의 @ 하나를 허용하지만, 자체 레코드에는 항상 같은 표준 사용자 이름 형식을 사용하세요.
  • 작업당 사용자 이름은 정확히 하나만 제출하세요. 일괄 요청, 프로필 URL, results_limit은 이 엔드포인트 사양에 포함되지 않습니다.
  • 허용되는 문법은 입력값 검증일 뿐, 그 사용자 이름이 접근 가능한 공개 프로필로 확인된다는 뜻은 아닙니다.
  • 웹사이트, 위치, 프로필 미디어, 계정 속성, 개별 수치는 선택 필드로 처리하세요.
  • 프로필 텍스트와 공개된 수치는 특정 시점의 값이므로, 저장하는 모든 결과에 collected_at을 함께 보관하세요.

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

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

다른 플랫폼 둘러보기

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

Snapchat Profile API — 자주 묻는 질문

Snapchat Profile API는 사용자 이름으로 Snapchat 공개 프로필 하나를 조회하고, 제공되는 필드를 정규화된 계정 레코드로 반환하는 프로그래밍 인터페이스입니다.

선택 사항인 @ 하나 뒤에 1~64자의 ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈을 입력합니다. 공백, 프로필 URL, 그 밖의 문장 부호는 요청 검증을 통과하지 못합니다.

AccountItem 스키마에는 계정 정보, 공개 URL, 소개 텍스트, 아바타, 커버, 웹사이트, 인증·비공개 속성, 위치, 수집 시각, 제공되는 팔로워·팔로잉·게시물 수가 포함됩니다.

네. 사용자 이름의 문법이 올바르더라도 공개적으로 접근 가능한 제공처 결과가 있다는 보장은 없으므로, 성공한 작업에 저장된 항목이 0개일 수 있습니다.

아니요. 제공처에 프로필 상세 요청을 한 번 보내 프로필 레코드를 최대 하나만 반환합니다. 공용 작업 결과 경로는 커서 페이지네이션을 지원하지만, 이 엔드포인트에는 results_limit이 없고 보통 첫 페이지에 모두 담깁니다.

성공한 작업은 저장된 결과가 1개이든 0개이든 관계없이 고정 0.19 SocQ 크레딧이 차감됩니다. 실패한 작업은 플랫폼의 작업 환불 정책을 따릅니다.