Kwai Profile
Kwai 프로필은 사용자 이름, 표시 이름, 소개글, 프로필 이미지, 웹사이트, 계정 플래그, 공개된 팔로워·팔로잉·게시물 수를 담은 공개 계정 페이지입니다. 이러한 계정 정보와 특정 시점의 신호는 프로필 정보 보강, 계정 비교, 반복 스냅샷 모니터링에 활용할 수 있습니다.
Kwai Profile API 주요 기능
- 두 가지 식별자 지원유효한 사용자 이름, kwai.com 또는 kwai-video.com의 프로필 URL, 또는 두 식별자를 같은 작업에 함께 넣어 공개 프로필 하나를 조회합니다.
- 정규화된 공개 계정 정보프로필 ID, 원본 URL, 사용자 이름, 표시 이름, 소개글, 프로필 이미지, 커버 이미지, 웹사이트를 일관된 계정 레코드로 반환합니다.
- 관측 시각이 포함된 계정 신호확인 가능한 인증·비공개 플래그, 공개된 팔로워·팔로잉·게시물 수, collected_at을 한데 묶어 특정 시점의 프로필 스냅샷으로 유지합니다.
Kwai Profile API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
username | 필수(하나 이상) | username 또는 url 중 하나는 필수입니다. 사용자 이름은 @로 시작할 수 있으며, 그 뒤에 ASCII 문자, 숫자, 마침표, 밑줄, 하이픈이 1~64자 이어집니다. |
url | 필수(하나 이상) | url 또는 username 중 하나는 필수입니다. 비어 있지 않은 참조는 호스트 이름이 kwai.com, kwai-video.com 또는 그 하위 도메인으로 파싱되어야 합니다. 권한 부분과 호스트 이름이 있으면 어떤 스킴이든 허용되며, 프로토콜 상대 참조도 허용됩니다. |
Kwai Profile API 사용 방법
지원되는 식별자 하나를 제출하고, 비동기 작업을 따라간 뒤, 저장된 결과 페이지에서 정규화된 프로필 레코드를 읽습니다.
- 유효한 사용자 이름, 또는 파싱한 호스트 이름이 kwai.com, kwai-video.com 또는 그 하위 도메인인 Kwai 프로필 참조를 준비합니다.
- username, url 또는 둘 다를 /v1/kwai/profile로 제출하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items에서 프로필을 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueKwai Profile API 추천 활용 사례
- 프로필 레코드 정보 보강: 알고 있는 Kwai 계정에 연결된 레코드에 정규화된 공개 계정 정보, 프로필 이미지, 웹사이트, 계정 플래그, 원본 URL을 추가합니다.
- 공개 계정 수치 비교: 선택한 프로필의 팔로워, 팔로잉, 게시물 수를 비교하되, 이 값을 실시간 합계로 취급하지 않습니다.
- 프로필 스냅샷 모니터링: 반복 조회한 결과를 collected_at과 함께 저장해, 공개 계정 정보 필드, 계정 플래그, 공개된 수치의 시간에 따른 변화를 추적합니다.
Kwai Profile API 활용 팁
- 식별자를 최소 하나는 제공하세요. username과 url을 모두 보내면 백엔드가 하나를 대신 골라 주지 않고 둘 다 전달합니다.
- 제출 전에 사용자 이름은 ^@?[A-Za-z0-9._-]{1,64}$ 패턴으로 검증하고, URL은 파싱한 호스트 이름이 kwai.com, kwai-video.com 또는 그 하위 도메인인지 확인하세요.
- 공개 프로필이 스키마의 일부만 노출할 수 있으므로, 소개글, 프로필 이미지, 커버 이미지, 웹사이트, 계정 플래그, 개별 지표는 선택 값으로 취급하세요.
- 중복 제거에는 id를 기본 키로 쓰고 필요하면 url로 대체하며, 특정 시점의 지표 스냅샷마다 collected_at을 함께 보관하세요.
관련 API
Kwai Profile API 외에 Kwai의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Kwai User Posts API — 사용자 이름 또는 지원되는 프로필 URL로 공개 Kwai 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여도를 포함합니다.
- Kwai Post API — 알고 있는 공개 Kwai 게시물 URL 하나를 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 엔티티, 공개된 참여도 필드로 변환합니다.