kwai/
post

알고 있는 kwai.com 또는 kwai-video.com URL로 공개 Kwai 게시물 하나를 조회하고, 정규화된 텍스트, 작성자, 미디어, 게시 시각, 공개된 참여 수치를 반환합니다.

Kwai Post API

알고 있는 게시물 URL
게시물·작성자 정보
작업당 고정 요금
요청당 0.19 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 하나를 제출하고, 비동기 작업을 추적한 뒤, 완료되면 정규화된 게시물 레코드를 읽습니다.

  1. URL에 kwai.com, kwai-video.com 또는 허용되는 하위 도메인의 호스트 이름이 파싱 가능한 형태로 포함되어 있는지 확인합니다.
  2. url 문자열을 /v1/kwai/post로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. 성공하면 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.items

Kwai Post API 추천 활용 사례

  • 알고 있는 게시물 카탈로그 정보 보강: 저장해 둔 Kwai 링크를 정규화된 게시물 ID, 텍스트, 작성자 정보, 게시 시각, 원본 필드로 대체합니다.
  • 선택한 게시물 콘텐츠 검토: 텍스트, 미디어 참조, 해시태그, 멘션, 작성자 정보를 활용해 승인된 개별 게시물 세트를 살펴봅니다.
  • 참여 수치 스냅샷 비교: 정해 둔 시점마다 조회를 반복하고 공개된 좋아요, 댓글, 공유, 조회 수를 collected_at과 짝지어 특정 시점끼리 비교합니다.

Kwai Post API 활용 팁

  • 호스트 이름을 파싱할 수 있도록 URL 스킴을 포함하고, 계정 이름만 쓰지 말고 정확한 공개 게시물 링크를 사용하세요.
  • 이 상세 조회 엔드포인트는 url 필드를 하나만 받고 results_limit나 일괄 입력이 없으므로, 작업당 URL 하나만 제출하세요.
  • 허용된 호스트 이름이라고 해서 제공처가 해당 리소스를 확인할 수 있다는 보장은 없으므로, 작업이 성공했는데 항목이 없으면 제출한 URL을 그대로 보관하세요.
  • 공개 게시물이 정규화된 필드를 모두 노출하지 않을 수 있으니, 선택 필드인 작성자·미디어·요소·참여 수치는 방어적으로 저장하세요.
  • 지표를 비교할 때는 항상 collected_at을 함께 쓰고, 공개된 카운터를 실시간 피드로 취급하지 마세요.

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

  • Kwai Profile API — 사용자 이름 또는 지원되는 URL로 공개 Kwai 프로필 하나를 가져오며, 정규화된 계정 정보, 이미지, 계정 속성, 공개된 수치, 수집 맥락을 포함합니다.
  • Kwai User Posts API — 사용자 이름 또는 지원되는 프로필 URL로 공개 Kwai 게시물 한 페이지를 수집하며, 정규화된 콘텐츠, 작성자, 미디어, 타임스탬프, 해시태그, 멘션, 공개된 참여도를 포함합니다.

다른 플랫폼 둘러보기

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

Kwai Post API — 자주 묻는 질문

Kwai Post API는 허용되는 Kwai 호스트의 알고 있는 URL로 공개 Kwai 게시물 하나를 조회하는 프로그래밍 인터페이스입니다. 정규화된 게시물 식별 정보, 텍스트, 작성자, 미디어, 해시태그, 멘션, 게시 시각, 공개된 참여 수치 필드를 반환합니다.

파싱한 호스트 이름이 kwai.com, kwai-video.com 또는 그 하위 도메인 중 하나인, 비어 있지 않은 URL을 제출합니다. 호스트 이름을 파싱하려면 스킴이 필요합니다.

현재 런타임 검증기는 경로 패턴을 강제하지 않습니다. 다만 다른 리소스 경로도 호스트 이름 검증은 통과하되 게시물 레코드는 생성되지 않을 수 있으므로, 실제 공개 게시물 URL을 사용하세요.

레코드에는 게시물 식별 정보, URL, 텍스트, 게시 시각과 수집 시각, 작성자 정보, 미디어, 해시태그, 멘션, 공개된 좋아요·댓글·공유·조회 수가 포함될 수 있습니다. 선택 공개 필드는 null일 수 있습니다.

results_limit는 받지 않으며, 제공처 요청 한 번으로 게시물은 최대 하나만 저장됩니다. 공용 작업 결과 경로에는 limit, next_cursor, has_more가 그대로 노출되지만, 이 상세 결과는 보통 첫 페이지에 모두 담깁니다.

성공한 작업은 건당 0.19 SocQ 크레딧이 고정으로 차감됩니다. 예상 금액은 결과 수에 따라 달라지지 않으며, 성공했지만 레코드를 찾지 못한 작업에도 고정 작업 요금이 적용됩니다.