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つ送信して非同期タスクを追跡し、完了後に正規化された投稿レコードを読み取ります。
- URLに、kwai.com、kwai-video.com、または受け付けられるサブドメインの解析可能なホスト名が含まれていることを確認します。
- url 文字列を /v1/kwai/post に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで、/v1/tasks/{task_id} をポーリングします。
- 成功したら 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.itemsKwai Post API の主なユースケース
- 既知投稿のカタログ補完: 保存済みのKwaiリンクを、正規化された投稿ID、テキスト、投稿者情報、公開日時、ソースの各フィールドに置き換えます。
- 選定投稿の内容確認: テキスト、メディア参照、ハッシュタグ、メンション、投稿者情報を使い、承認済みの投稿群を個別に確認します。
- エンゲージメントのスナップショット比較: 決めたタイミングで照会を繰り返し、表示中のいいね数・コメント数・シェア数・再生数を collected_at と組み合わせて、特定時点の比較に活用します。
Kwai Post API 活用のヒント
- ホスト名を解析できるようURLスキームを含め、アカウント名だけではなく正確な公開投稿のリンクを使用してください。
- この詳細エンドポイントは単一の url フィールドのみを受け付け、results_limit やバッチ入力がないため、タスク1件につきURLを1つ送信してください。
- 受け付けられるホスト名であっても、プロバイダーがリソースを解決できるとは限らないため、成功したタスクがアイテムを返さなかった場合に備えて送信したURLを保持してください。
- 公開投稿ではすべての正規化フィールドが公開されているとは限らないため、任意の投稿者、メディア、要素、エンゲージメントの各フィールドは欠損を想定して保存してください。
- 指標を比較する際は必ず collected_at を使用し、表示中のカウンターをリアルタイムのフィードとして扱わないでください。
関連API
Kwai Post API 以外に別の種類の公開Kwaiデータが必要な場合は、これらのAPIをご利用ください。
- Kwai Profile API — ユーザー名または対応URLから公開Kwaiプロフィール1件を取得し、正規化されたアカウント情報、画像、アカウント属性、表示中のカウント、取得情報を返します。
- Kwai User Posts API — ユーザー名または対応するプロフィールURLから公開Kwai投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを返します。