Kwai Post
Kwai 게시물은 텍스트와 미디어에 작성자 정보, 해시태그, 멘션, 게시 시각, 공개된 참여 수치를 더할 수 있는 공개 콘텐츠 레코드입니다. 이러한 필드는 URL 카탈로그 정보 보강, 콘텐츠 검토, 선택한 게시물의 특정 시점 비교에 활용할 수 있습니다.
Kwai Post API 주요 기능
- 알고 있는 URL 하나로 조회확인되지 않은 경로 규칙을 덧붙이지 않고, kwai.com, kwai-video.com 또는 그 하위 도메인의 공개 URL 하나를 조회합니다.
- 게시물·작성자 정보게시물 식별 정보, 원본 URL, 텍스트, 게시 시각과 함께 확인 가능한 작성자 ID, 사용자 이름, 표시 이름, 프로필 URL, 프로필 이미지, 계정 플래그를 반환합니다.
- 미디어와 콘텐츠 요소확인 가능한 미디어 참조, 미리보기, 크기, 길이, 해시태그, 멘션을 게시물 레코드에 함께 담아 둡니다.
- 공개 참여 수치 스냅샷확인 가능한 좋아요, 댓글, 공유, 조회 수를 collected_at과 함께 정규화해, 레코드의 관측 시각이 분명하게 남도록 합니다.
Kwai Post API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
url | 필수 | 필수 값으로, 비어 있지 않아야 하며 지원하는 하위 도메인을 포함해 kwai.com 또는 kwai-video.com 호스트 이름이 파싱 가능한 URL입니다. 런타임은 특정 경로 패턴을 요구하지 않습니다. |
Kwai Post API 사용 방법
허용되는 Kwai URL 하나를 제출하고, 비동기 작업을 추적한 뒤, 완료되면 정규화된 게시물 레코드를 읽습니다.
- URL에 kwai.com, kwai-video.com 또는 허용되는 하위 도메인의 호스트 이름이 파싱 가능한 형태로 포함되어 있는지 확인합니다.
- url 문자열을 /v1/kwai/post로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 성공하면 data.results.items를 읽습니다. 상세 조회 제공처는 게시물을 최대 하나만 저장하므로, 작업 결과 경로에 next_cursor가 있더라도 has_more는 보통 false입니다.
curl -X POST "https://api.socq.ai/v1/kwai/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'
# Poll GET /v1/tasks/{task_id}
# Read the normalized post from data.results.itemsKwai Post API 추천 활용 사례
- 알고 있는 게시물 카탈로그 정보 보강: 저장해 둔 Kwai 링크를 정규화된 게시물 ID, 텍스트, 작성자 정보, 게시 시각, 원본 필드로 대체합니다.
- 선택한 게시물 콘텐츠 검토: 텍스트, 미디어 참조, 해시태그, 멘션, 작성자 정보를 활용해 승인된 개별 게시물 세트를 살펴봅니다.
- 참여 수치 스냅샷 비교: 정해 둔 시점마다 조회를 반복하고 공개된 좋아요, 댓글, 공유, 조회 수를 collected_at과 짝지어 특정 시점끼리 비교합니다.
Kwai Post API 활용 팁
- 호스트 이름을 파싱할 수 있도록 URL 스킴을 포함하고, 계정 이름만 쓰지 말고 정확한 공개 게시물 링크를 사용하세요.
- 이 상세 조회 엔드포인트는 url 필드를 하나만 받고 results_limit나 일괄 입력이 없으므로, 작업당 URL 하나만 제출하세요.
- 허용된 호스트 이름이라고 해서 제공처가 해당 리소스를 확인할 수 있다는 보장은 없으므로, 작업이 성공했는데 항목이 없으면 제출한 URL을 그대로 보관하세요.
- 공개 게시물이 정규화된 필드를 모두 노출하지 않을 수 있으니, 선택 필드인 작성자·미디어·요소·참여 수치는 방어적으로 저장하세요.
- 지표를 비교할 때는 항상 collected_at을 함께 쓰고, 공개된 카운터를 실시간 피드로 취급하지 마세요.
관련 API
Kwai Post API 외에 Kwai의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Kwai Profile API — 사용자 이름 또는 지원되는 URL로 공개 Kwai 프로필 하나를 가져오며, 정규화된 계정 정보, 이미지, 계정 속성, 공개된 수치, 수집 맥락을 포함합니다.
- Kwai User Posts API — 사용자 이름 또는 지원되는 프로필 URL로 공개 Kwai 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여도를 포함합니다.