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. 식별자 제출
Kwai 엔드포인트를 고르고 지원하는 사용자 이름이나 URL을 제출한 뒤, task_id를 저장합니다.
2. 작업 추적
처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 저장된 결과 읽기
data.results.items를 읽고, has_more가 true일 때만 next_cursor를 따라갑니다.
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.itemsKwai 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 크레딧의 고정 요금이 부과됩니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
Truth Social API
공개 계정 정보를 가져오고, 계정 게시물의 원본 한 페이지를 수집하거나, 알고 있는 게시물 URL 하나를 정규화된 레코드로 확인합니다.
Google Ad Library API
공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.
Google Maps API
공개 장소를 찾고, 이미 알고 있는 Maps URL의 정규화된 상세 정보를 가져오고, 출처가 연결된 장소·작성자 정보와 함께 공개 리뷰를 수집합니다.
Amazon API
지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.
Apple App Store API
이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.
SEO API
실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.


