Kwai API
公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。
利用できるKwai API
アカウントのレコードにはProfiles、アカウントから取得元の1ページ分を取得するにはUser Posts、既知の公開投稿URL 1件にはPostsを使用します。
取得できるKwaiデータ
SocQは、選択したリソースで取得可能な公開フィールドをそのまま保持し、欠けている値を0として扱うことはありません。
プロフィール情報
取得可能なプロフィールのアカウント情報、画像、Webサイト、公開アカウントのフラグを取得します。
投稿のコンテンツ
正規化された投稿本文、投稿者のコンテキスト、公開日時、ハッシュタグ、メンションを取得します。
メディアと指標
取得可能なメディアのフィールドと、表示中のアカウント数値やエンゲージメント数を、特定時点の観測値として保持します。
Kwai APIの仕様概要
各エンドポイントは取得元へのリクエスト範囲が限定されており、共通の非同期タスク結果リーダーを使用します。
| エンドポイント | 入力 | 取得元の範囲 |
|---|---|---|
| Profiles | ユーザー名、対応するプロフィールURL、またはその両方 | 公開プロフィール1件 |
| User Posts | ユーザー名、対応するプロフィールURL、またはその両方 | 返された取得元の1ページ分 |
| Posts | 対応する公開投稿URL | 公開投稿1件 |
Kwai APIの仕組み
3つのエンドポイントはすべて、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)のURLです。
- User Postsは取得元のページネーションをたどりません。タスク結果のカーソルは、SocQがすでに保存したレコードのページ分割にのみ使われます。
- Postsは対応する公開投稿URLを1件解決するもので、results_limit は受け付けません。
- 成功したタスクには、1回あたり一律0.19クレジットが課金されます。
Kwai APIに関するよくある質問
Kwai APIとは何ですか?
3つのKwai APIで、公開プロフィール1件、公開アカウントの投稿1ページ分、既知の公開投稿1件を取得できます。
ユーザー名とURLを同時に送信できますか?
ProfilesとUser Postsでは可能です。どちらか一方のフィールドで要件を満たし、両方を指定した場合はどちらも転送されます。
どのKwai URLのホストに対応していますか?
kwai.com、kwai-video.com、またはそれらのサブドメイン上のHTTPまたはHTTPSのURLを使用してください。
User Postsは取得元のページネーションをたどりますか?
いいえ。返された取得元の1ページ分のレコードを保存します。タスク結果のカーソルは、保存済みのSocQレコードの読み取りにのみ使われます。
Kwaiデータ取得の料金はどのように計算されますか?
成功したKwaiタスクは、すべて1回あたり一律0.19 SocQクレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Truth Social API
公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。
Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。
Google Maps API
公開スポットの検索、既知のMaps URLの正規化された詳細の取得、取得元に紐づくスポット情報と投稿者のコンテキストを含む公開クチコミの取得ができます。
Amazon API
対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。
Apple App Store API
既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。
SEO API
Googleのオーガニック検索結果をリアルタイムで取得し、キーワードの需要と順位獲得の難易度を比較し、シードキーワードを拡張し、サイトの検索での可視性を支えるキーワードとページを明らかにし、検索意図を分類できるほか、Googleニュース・画像・サジェスト、Bing、YouTubeの結果も集められます。すべてのエンドポイントで、共通のSocQのAPIキー、非同期タスクフロー、正規化された結果形式を使用します。


