kwai/
user-posts

사용자 이름 또는 지원되는 프로필 URL로 공개 Kwai 게시물 한 페이지를 수집하고, 텍스트, 작성자, 미디어, 해시태그, 게시 시각, 공개된 참여 수치를 정규화된 레코드로 반환합니다.

Kwai User Posts API

사용자 이름 또는 프로필 URL
원본 한 페이지
정규화된 공개 게시물
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 식별 정보를 제출하고, 비동기 작업을 따라간 뒤, 완료되면 저장된 정규화 결과를 페이지 단위로 읽습니다.

  1. Kwai 사용자 이름 또는 kwai.com, kwai-video.com의 공개 프로필 URL을 준비합니다.
  2. url 또는 username을 /v1/kwai/user-posts로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 보고할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 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 true

Kwai 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으로 고정하세요.

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

  • Kwai Profile API — 사용자 이름 또는 지원되는 URL로 공개 Kwai 프로필 하나를 가져오며, 정규화된 계정 정보, 이미지, 계정 속성, 공개된 수치, 수집 맥락을 포함합니다.
  • Kwai Post API — 알고 있는 공개 Kwai 게시물 URL 하나를 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 엔티티, 공개된 참여도 필드로 변환합니다.

다른 플랫폼 둘러보기

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

Kwai User Posts API — 자주 묻는 질문

Kwai User Posts API는 Kwai 사용자 이름 또는 지원되는 프로필 URL로 공개 게시물 레코드 한 페이지를 수집합니다. 공개 필드가 있는 경우 정규화된 콘텐츠, 작성자 정보, 미디어, 게시 시각, 해시태그, 멘션, 공개된 참여 수치를 반환합니다.

url 또는 username 중 하나 이상을 제공하세요. 사용자 이름은 @로 시작할 수 있고 문자, 숫자, 마침표, 밑줄, 하이픈을 사용할 수 있으며, URL은 kwai.com, kwai-video.com 또는 그 하위 도메인이어야 합니다.

아니요. 제출 사양에는 results_limit나 원본 커서가 없으며, 제공처 요청은 한 번만 보냅니다. GET /v1/tasks/{task_id}의 커서는 완료된 작업에 이미 저장된 결과를 페이지로 나누어 읽을 때만 사용합니다.

게시물에는 ID와 URL, 텍스트, 공개 작성자 정보, 공개된 좋아요·댓글·공유·조회 수, 미디어, 해시태그, 멘션, published_at, collected_at이 포함될 수 있습니다. 선택 원본 필드는 null이거나 비어 있을 수 있습니다.

성공한 작업은 건당 0.19 SocQ 크레딧이 고정으로 차감됩니다. 한 페이지 요청으로 반환된 게시물 레코드 수가 달라져도 요금은 변하지 않습니다.