Kwai User Posts
Kwai 사용자 게시물은 캡션, 작성자 정보, 첨부 미디어, 해시태그, 멘션, 게시 시각, 공개된 참여 수치를 담은 공개 계정의 콘텐츠입니다. 이러한 콘텐츠·맥락 필드는 계정 리서치, 미디어 포맷 검토, 특정 시점의 참여 수치 비교에 활용할 수 있습니다.
Kwai User Posts API 주요 기능
- 두 가지 계정 식별 입력사용자 이름 또는 kwai.com, kwai-video.com의 공개 프로필 URL 중 하나로 시작하며, 식별 필드는 최소 하나가 있어야 합니다.
- 한 페이지 단위 공개 게시물 수집원본 커서나 호출자가 지정하는 결과 개수 제한 없이, 선택한 공개 계정에 대해 제공처의 한 페이지가 반환한 게시물을 수집합니다.
- 정규화된 콘텐츠·작성자 정보게시물 텍스트, 공개 작성자 필드, 원본 URL, 미디어 참조, 해시태그, 멘션, 게시 시각, 수집 시각을 일관된 게시물 형식으로 받습니다.
- 공개 참여 수치 스냅샷확인 가능한 좋아요, 댓글, 공유, 조회 수를 collected_at과 함께 보존해, 비교 결과가 관측 시각에 고정되도록 합니다.
Kwai User Posts API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수(하나 이상) | 비어 있지 않은 Kwai 프로필 참조로, 파싱한 호스트 이름이 kwai.com, kwai-video.com 또는 그 하위 도메인이어야 합니다. 권한 부분과 호스트 이름이 있으면 어떤 스킴이든 허용되며, 프로토콜 상대 참조도 허용됩니다. url 또는 username을 제공하며, 둘 다 보내도 됩니다. |
username | 필수(하나 이상) | 앞에 @를 하나 붙일 수 있는 Kwai 사용자 이름으로, 그 뒤에 ASCII 문자, 숫자, 마침표, 밑줄, 하이픈이 1~64자 이어지며 전체 길이는 최대 65자입니다. 제공처에는 이 값이 handle로 전달됩니다. |
Kwai User Posts API 사용 방법
지원되는 Kwai 식별 정보를 제출하고, 비동기 작업을 따라간 뒤, 완료되면 저장된 정규화 결과를 페이지 단위로 읽습니다.
- Kwai 사용자 이름 또는 kwai.com, kwai-video.com의 공개 프로필 URL을 준비합니다.
- url 또는 username을 /v1/kwai/user-posts로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 작업 결과의 next_cursor를 사용합니다. 이 커서는 Kwai 원본이 아니라 저장된 결과를 페이지로 나누어 읽는 용도입니다.
curl -X POST "https://api.socq.ai/v1/kwai/user-posts" \
-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 the stored-result next_cursor while has_more is trueKwai User Posts API 추천 활용 사례
- 공개 계정 콘텐츠 리서치: 선택한 계정 하나의 캡션, 작성자 표기, 공개 미디어 참조, 해시태그, 멘션, 게시 시각을 검토합니다.
- 미디어 포맷 검토: 원본 게시물과 작성자를 유지한 채, 반환된 게시물을 확인 가능한 미디어 유형, 길이, 썸네일, 크기별로 묶어 봅니다.
- 특정 시점 참여 수치 비교: 수집한 게시물들의 공개 좋아요, 댓글, 공유, 조회 수를 비교하되, collected_at으로 관측 기간을 구분합니다.
Kwai User Posts API 활용 팁
- 제출 전에 사용자 이름을 허용되는 형식(@ 선택)으로 정규화하고, 프로필 URL의 호스트가 kwai.com 또는 kwai-video.com인지 검증하세요.
- 원본 요청에 cursor나 results_limit를 추가하지 마세요. 작업마다 지원되는 식별 필드만 사용해 제공처에 한 페이지를 요청합니다.
- GET /v1/tasks/{task_id}의 cursor와 limit는 제출 후 저장된 작업 결과를 페이지로 나누어 읽을 때만 사용하세요. limit는 1~500을 받으며 기본값은 50입니다.
- 텍스트, 작성자 정보, 개별 지표, 미디어, 해시태그, 멘션, 게시 시각은 선택 값으로 취급하고, 스냅샷은 collected_at으로 고정하세요.
관련 API
Kwai User Posts API 외에 Kwai의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Kwai Profile API — 사용자 이름 또는 지원되는 URL로 공개 Kwai 프로필 하나를 가져오며, 정규화된 계정 정보, 이미지, 계정 속성, 공개된 수치, 수집 맥락을 포함합니다.
- Kwai Post API — 알고 있는 공개 Kwai 게시물 URL 하나를 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 엔티티, 공개된 참여도 필드로 변환합니다.