Snapchat Profile
Snapchat 공개 프로필에는 사용자 이름, 표시 이름, 소개, 아바타, 커버, 웹사이트, 계정 속성, 위치, 공개된 프로필 수치가 노출될 수 있습니다. 알고 있는 사용자 이름 하나를 정규화된 계정 스냅샷으로 바꿔 주는 이 조회 기능은 정보 보강, 검토, 이후 비교에 활용할 수 있습니다.
Snapchat Profile API 주요 기능
- 정확한 사용자 이름 조회계정을 검색하는 대신, 알고 있는 Snapchat 사용자 이름을 작업당 하나씩 조회합니다. 앞에 @ 하나가 붙어 있어도 됩니다.
- 정규화된 프로필 정보제공되는 사용자 이름, 표시 이름, 소개, 공개 URL, 고유 원본 식별자를 AccountItem 레코드로 반환합니다.
- 프로필 미디어와 맥락제공되는 아바타, 커버, 웹사이트, 위치 필드를 따로 보존하므로 화면 표시, 인덱싱, 정보 보강 워크플로에 활용할 수 있습니다.
- 공개된 계정 신호제공되는 인증·비공개 속성과 수집 시점의 팔로워·팔로잉·게시물 수를 기록합니다.
Snapchat Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수 | Snapchat 사용자 이름으로, 필수 값입니다. 앞에 @를 선택적으로 하나 붙일 수 있고, 이어서 1~64자의 ASCII 영문자, 숫자, 마침표, 밑줄, 하이픈을 입력합니다. 공백, 프로필 URL, 그 밖의 문자는 거부됩니다. |
Snapchat Profile API 사용 방법
허용되는 사용자 이름 하나를 제출하고, 비동기 작업이 끝나기를 기다린 뒤 정규화된 프로필 결과를 읽습니다.
- 알고 있는 Snapchat 사용자 이름 하나를 정합니다. 영문자, 숫자, 마침표, 밑줄, 하이픈을 쓸 수 있고 앞의 @ 하나는 선택 사항입니다.
- username을 /v1/snapchat/profile로 전송하고, 반환된 task_id를 보관합니다.
- 작업이 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 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 succeedsSnapchat Profile API 추천 활용 사례
- 알고 있는 계정 정보 보강: Snapchat 사용자 이름이 이미 들어 있는 레코드에 공개 계정 정보, 소개, 프로필 미디어, 웹사이트, 제공되는 수치를 추가합니다.
- 선택한 프로필 검토: 스토리, Spotlight, 계정 관리 작업은 섞지 않고, 공개 계정 하나를 일관된 프로필 카드나 검토 대기열에 표시합니다.
- 공개 스냅샷 비교: 결과를 collected_at과 함께 차례로 저장해, 공개 프로필 텍스트, 계정 속성, 미디어, 공개된 수치가 시간에 따라 어떻게 달라지는지 비교합니다.
Snapchat Profile API 활용 팁
- 요청은 앞의 @ 하나를 허용하지만, 자체 레코드에는 항상 같은 표준 사용자 이름 형식을 사용하세요.
- 작업당 사용자 이름은 정확히 하나만 제출하세요. 일괄 요청, 프로필 URL, results_limit은 이 엔드포인트 사양에 포함되지 않습니다.
- 허용되는 문법은 입력값 검증일 뿐, 그 사용자 이름이 접근 가능한 공개 프로필로 확인된다는 뜻은 아닙니다.
- 웹사이트, 위치, 프로필 미디어, 계정 속성, 개별 수치는 선택 필드로 처리하세요.
- 프로필 텍스트와 공개된 수치는 특정 시점의 값이므로, 저장하는 모든 결과에 collected_at을 함께 보관하세요.
관련 API
Snapchat Profile API 외에 Snapchat의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Snapchat Spotlight API — 알고 있는 공개 Snapchat Spotlight 하나를 가져오며, 확인 가능한 경우 정규화된 크리에이터, 캡션, 미디어, 오디오, 타임스탬프, 길이, 공개된 참여도 필드를 포함합니다.
- Snapchat Spotlight Comments API