kwai/
post

既知の kwai.com または kwai-video.com のURLから公開Kwai投稿を1件取得し、正規化されたテキスト、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

Kwai Post API

既知の投稿URL
投稿と投稿者のコンテキスト
固定のタスク料金
1リクエストあたり0.19クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Kwai Post

Kwaiの投稿は、テキストやメディアに、投稿者情報、ハッシュタグ、メンション、公開日時、表示中のエンゲージメントを組み合わせられる公開コンテンツのレコードです。これらのフィールドは、URLカタログの情報補完、コンテンツのレビュー、選定した投稿の特定時点での比較に活用できます。

Kwai Post API の主な機能

  • 既知のURLを1件照会kwai.com、kwai-video.com、またはそのサブドメイン上の公開URLを1つ解決します。未検証のパスルールは追加しません。
  • 投稿と投稿者のコンテキスト投稿ID、ソースURL、テキスト、公開日時に加え、取得可能な投稿者ID、ユーザー名、表示名、プロフィールURL、アバター、アカウントフラグを返します。
  • メディアとコンテンツ要素取得可能なメディア参照、プレビュー、サイズ、再生時間、ハッシュタグ、メンションを投稿レコードとあわせて保持します。
  • 表示中のエンゲージメントのスナップショット取得可能ないいね数・コメント数・シェア数・再生数を collected_at とともに正規化し、レコードの観測時刻を明確にします。

Kwai Post API のパラメータ

パラメータ必須説明
url必須必須。対応するサブドメインを含め、解析可能な kwai.com または kwai-video.com のホスト名を持つ空でないURLです。ランタイムでは特定のパスのパターンは必須ではありません。

Kwai Post API の使い方

受け付けられるKwaiのURLを1つ送信して非同期タスクを追跡し、完了後に正規化された投稿レコードを読み取ります。

  1. URLに、kwai.com、kwai-video.com、または受け付けられるサブドメインの解析可能なホスト名が含まれていることを確認します。
  2. url 文字列を /v1/kwai/post に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで、/v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を読み取ります。詳細取得のプロバイダーが保存できる投稿は最大1件のため、タスク結果のルートに 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 やバッチ入力がないため、タスク1件につきURLを1つ送信してください。
  • 受け付けられるホスト名であっても、プロバイダーがリソースを解決できるとは限らないため、成功したタスクがアイテムを返さなかった場合に備えて送信したURLを保持してください。
  • 公開投稿ではすべての正規化フィールドが公開されているとは限らないため、任意の投稿者、メディア、要素、エンゲージメントの各フィールドは欠損を想定して保存してください。
  • 指標を比較する際は必ず collected_at を使用し、表示中のカウンターをリアルタイムのフィードとして扱わないでください。

Kwai Post API 以外に別の種類の公開Kwaiデータが必要な場合は、これらのAPIをご利用ください。

  • Kwai Profile API — ユーザー名または対応URLから公開Kwaiプロフィール1件を取得し、正規化されたアカウント情報、画像、アカウント属性、表示中のカウント、取得情報を返します。
  • Kwai User Posts API — ユーザー名または対応するプロフィールURLから公開Kwai投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを返します。

他のプラットフォームを見る

Kwaiのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Kwai Post API — よくある質問

Kwai Post APIは、受け付けられるKwaiホスト上の既知のURLから公開Kwai投稿を1件取得するためのプログラムインターフェースです。正規化された投稿ID、テキスト、投稿者、メディア、ハッシュタグ、メンション、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。

解析後のホスト名が kwai.com、kwai-video.com、またはそのいずれかのサブドメインである、空でないURLを送信してください。ホスト名を解析するにはスキームが必要です。

現在のランタイムのバリデーターでは、パスのパターンは強制されません。ただし、別のリソースのパスでもホスト名の検証は通過する一方で投稿レコードが生成されないことがあるため、実際の公開投稿URLを使用してください。

レコードには、投稿ID、URL、テキスト、公開日時と取得日時、投稿者の詳細、メディア、ハッシュタグ、メンション、表示中のいいね数・コメント数・シェア数・再生数が含まれる場合があります。任意の公開フィールドは null になることがあります。

results_limit は受け付けず、1回のプロバイダーリクエストで保存できる投稿は最大1件です。共通のタスク結果ルートでは引き続き limit、next_cursor、has_more が提供されますが、この詳細結果は通常1ページ目に収まります。

成功したタスク1件につき固定で0.19 SocQクレジットです。見積もりは結果の件数によって変わらず、成功してもレコードが解決されなかったタスクにも固定のタスク料金がかかります。