kwai/
user-posts

ユーザー名または対応するプロフィールURLから公開Kwai投稿を1ページ分取得し、テキスト、投稿者、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを正規化レコードとして返します。

Kwai User Posts API

ユーザー名またはプロフィールURL
ソース1ページ分
正規化された公開投稿
1リクエストあたり0.19クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Kwai User Posts

Kwaiのユーザー投稿とは、アカウントが公開している投稿で、キャプション、投稿者情報、添付メディア、ハッシュタグ、メンション、タイムスタンプ、表示中のエンゲージメント数を含みます。これらのコンテンツとコンテキストのフィールドは、アカウント調査、メディア形式の確認、特定時点のエンゲージメント比較に活用できます。

Kwai User Posts API の主な機能

  • 2種類の識別情報の入力に対応ユーザー名、または kwai.com や kwai-video.com 上の公開プロフィールURLのどちらかから開始できます。識別情報のフィールドは少なくとも1つ必要です。
  • 公開投稿を1ページ分取得選択した公開アカウントについて、プロバイダーの1ページで返された投稿を取得します。ソースのカーソルや呼び出し側で指定する結果件数上限は公開していません。
  • 正規化されたコンテンツと投稿者のコンテキスト投稿テキスト、公開投稿者フィールド、ソースURL、メディア参照、ハッシュタグ、メンション、公開日時、取得日時を一貫した投稿形式で受け取れます。
  • 表示中のエンゲージメントのスナップショット取得可能ないいね数・コメント数・シェア数・再生数を collected_at とともに保持し、比較を観測時刻に結び付けます。

Kwai User Posts API のパラメータ

パラメータ必須説明
url必須(いずれか1つ以上)解析後のホスト名が kwai.com、kwai-video.com、またはそのいずれかのサブドメインである、空でないKwaiプロフィールの参照です。オーソリティとホスト名があればスキームは問わず、プロトコル相対参照も受け付けます。url または username を指定してください。両方を指定することもできます。
username必須(いずれか1つ以上)先頭に任意で @ を1つ付け、その後にASCIIの英字、数字、ドット、アンダースコア、ハイフンからなる1〜64文字が続くKwaiユーザー名で、全体の最大長は65文字です。プロバイダーにはこの値が handle として渡されます。

Kwai User Posts API の使い方

対応するKwaiの識別情報を送信して非同期タスクを追跡し、完了後に保存された正規化結果をページ送りで読み取ります。

  1. Kwaiのユーザー名、または kwai.com や kwai-video.com 上の公開プロフィールURLのどちらかを用意します。
  2. url または username を /v1/kwai/user-posts に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間はタスク結果の next_cursor を使用します。このカーソルは保存済みの結果をページ送りするもので、Kwaiのソースを対象とするものではありません。
curl -X POST "https://api.socq.ai/v1/kwai/user-posts" \
  -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 and follow the stored-result next_cursor while has_more is true

Kwai User Posts API の主なユースケース

  • 公開アカウントのコンテンツ調査: 選んだアカウント1つについて、キャプション、投稿者の帰属情報、公開メディアの参照、ハッシュタグ、メンション、公開日時を確認します。
  • メディア形式の確認: 元の投稿と投稿者の情報を保持したまま、返された投稿を取得可能なメディア種別、再生時間、サムネイル、サイズごとにグループ化します。
  • 特定時点のエンゲージメント比較: collected_at で観測期間を特定しながら、取得した投稿間で表示中のいいね数・コメント数・シェア数・再生数を比較します。

Kwai User Posts API 活用のヒント

  • 送信前に、ユーザー名を受け付けられる「@ は任意」の形式に正規化し、プロフィールURLのホストが kwai.com または kwai-video.com であることを検証してください。
  • ソースへのリクエストに cursor や results_limit を追加しないでください。各タスクは、対応する識別情報のフィールドのみを使ってプロバイダーに1ページ分を要求します。
  • GET /v1/tasks/{task_id} の cursor と limit は、送信後に保存済みのタスク結果をページ送りする場合にのみ使用してください。limit は1〜500を受け付け、デフォルトは50です。
  • テキスト、投稿者の詳細、個々の指標、メディア、ハッシュタグ、メンション、公開日時は任意項目として扱い、スナップショットは collected_at で時点を固定してください。

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

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

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

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

Kwai User Posts API — よくある質問

Kwai User Posts APIは、Kwaiのユーザー名または対応するプロフィールURLから、公開投稿レコードを1ページ分取得するAPIです。公開フィールドが取得可能な場合は、正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを返します。

url と username のうち少なくとも1つを指定してください。ユーザー名は @ で始めることができ、英字、数字、ドット、アンダースコア、ハイフンを使用できます。URLは kwai.com、kwai-video.com、またはそのいずれかのサブドメインを使用する必要があります。

できません。送信時の仕様には results_limit もソースのカーソルもなく、プロバイダーへのリクエストは1回のみです。GET /v1/tasks/{task_id} のカーソルは、完了したタスクにすでに保存された結果をページ送りするだけです。

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

成功したタスク1件につき固定で0.19 SocQクレジットです。1ページ分のリクエストで返される投稿レコード数によって料金が変わることはありません。