API 목록으로 돌아가기
Kwai 공개 데이터

Kwai API

공개 Kwai 프로필, 계정 게시물 한 페이지, 이미 알고 있는 게시물 하나를 정규화된 식별 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여도와 함께 가져옵니다.

사용할 수 있는 Kwai API

계정 레코드에는 Profiles, 계정의 원본 한 페이지에는 User Posts, 이미 알고 있는 공개 게시물 URL 하나에는 Posts를 사용합니다.

어떤 Kwai 데이터를 가져올 수 있나요?

SocQ는 선택한 리소스에서 제공되는 공개 필드를 그대로 보존하며, 없는 값을 0으로 처리하지 않습니다.

프로필 식별 정보

제공되는 프로필 식별 정보, 이미지, 웹사이트, 공개 계정 플래그를 가져옵니다.

게시물 콘텐츠

정규화된 게시물 텍스트, 작성자 정보, 게시 시각, 해시태그, 멘션을 가져옵니다.

미디어와 지표

제공되는 미디어 필드와 공개된 계정·참여도 수치를 특정 시점의 관측값으로 보존합니다.

Kwai API 사양 개요

각 엔드포인트는 범위가 정해진 원본 요청을 받고, 공통 비동기 작업 결과 리더로 결과를 읽습니다.

엔드포인트입력원본 범위
Profiles사용자 이름, 지원하는 프로필 URL, 또는 둘 다공개 프로필 하나
User Posts사용자 이름, 지원하는 프로필 URL, 또는 둘 다반환된 원본 한 페이지
Posts지원하는 공개 게시물 URL공개 게시물 하나

Kwai API 작동 방식

세 엔드포인트 모두 표준 SocQ 비동기 작업 흐름을 따릅니다.

  1. 1. 식별자 제출

    Kwai 엔드포인트를 고르고 지원하는 사용자 이름이나 URL을 제출한 뒤, task_id를 저장합니다.

  2. 2. 작업 추적

    처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 저장된 결과 읽기

    data.results.items를 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.

공개 Kwai 데이터 가져오기

SocQ API 키로 인증하고 지원하는 공개 식별자를 제출합니다.

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

Kwai API 주요 활용 사례

프로필 정보 보강

이미 알고 있는 계정 레코드에 공개 식별 정보, 이미지, 계정 플래그, 출처 URL, 공개된 계정 신호를 추가합니다.

콘텐츠 목록 구축

공개 계정 게시물의 범위가 정해진 스냅샷을 만들거나, 이미 알고 있는 공개 게시물 URL의 정보를 보강합니다.

공개 신호 모니터링

반복 수집한 결과를 collected_at과 함께 저장해, 공개된 필드의 변화를 시간순으로 비교합니다.

제한 사항과 공개 데이터 정책

Kwai 결과는 특정 시점의 공개 레코드이며, 게시나 계정 관리 기능은 제공하지 않습니다.

  • Profiles와 User Posts는 username 또는 url 중 하나 이상이 필요하며, 둘을 함께 보내도 됩니다.
  • 지원하는 URL은 kwai.com, kwai-video.com 또는 두 호스트 중 하나의 하위 도메인에서 HTTP(S)를 사용하는 주소입니다.
  • User Posts는 원본 페이지네이션을 따라가지 않으며, 작업 결과 커서는 SocQ에 이미 저장된 레코드만 페이지로 나눕니다.
  • Posts는 지원하는 공개 게시물 URL 하나를 확인하며 results_limit을 받지 않습니다.
  • 성공한 작업은 건당 0.19 크레딧의 고정 요금이 부과됩니다.

Kwai API 자주 묻는 질문

Kwai API란 무엇인가요?

Kwai API 3종은 공개 프로필 하나, 공개 계정 게시물 한 페이지, 이미 알고 있는 공개 게시물 하나를 가져옵니다.

사용자 이름과 URL을 함께 보낼 수 있나요?

Profiles와 User Posts에서는 가능합니다. 두 필드 중 하나만 있으면 요건을 충족하며, 둘 다 보내면 모두 전달됩니다.

어떤 Kwai URL 호스트를 지원하나요?

kwai.com, kwai-video.com 또는 두 호스트 중 하나의 하위 도메인에서 HTTP나 HTTPS URL을 사용하세요.

User Posts는 원본 페이지네이션을 따라가나요?

아니요. 반환된 원본 한 페이지의 레코드를 저장하며, 작업 결과 커서는 저장된 SocQ 레코드만 읽습니다.

Kwai 수집 요금은 어떻게 되나요?

성공한 Kwai 작업은 건당 0.19 SocQ 크레딧의 고정 요금이 부과됩니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.