tiktok/
videos

1つ以上のTikTok動画URLから公開動画のメタデータを取得し、正規化されたクリエイター、キャプション、メディア、音楽、ハッシュタグ、メンション、エンゲージメントを返します。

TikTok Videos API

URLからの情報補完
クリエイティブ分析
パフォーマンスのスナップショット
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Videos

TikTok動画は、キャプション、クリエイター情報、メディア、音楽、再生時間、ハッシュタグ、メンション、公開情報、表示中のエンゲージメントを含むショート動画の投稿です。これらのコンテンツ情報は、トレンド調査、クリエイティブ分析、キャンペーンの振り返り、パフォーマンス比較に活用できます。

TikTok Videos API の主な機能

  • 複数動画URLの一括検索まとめて指定したTikTok動画リンクを、形式の揃ったコンテンツレコードに変換します。
  • 安定した動画識別動画IDと正規URLにより、動画の識別とソースの特定ができます。
  • コンテンツとクリエイターのフィールドキャプション、言語、公開日時、クリエイター、再生時間、カバー画像の情報を抽出します。
  • クリエイティブ関連のフィールドハッシュタグ、メンション、音楽、コンテンツフラグをクリエイティブ分析に取り込めます。
  • 特定時点の指標表示中のエンゲージメント数を collected_at と組み合わせ、パフォーマンスのスナップショットとして保存できます。

TikTok Videos API のパラメータ

パラメータ必須説明
urls必須必須。現在公開アクセスが可能なTikTok動画の直接URLのリストです。

TikTok Videos API の使い方

ブックマーク、レポート、社内システムにあるリンクを、分析にすぐ使える動画一覧に変換します。

  1. 動画の直接リンクを集め、URL形式を正規化して重複を排除します。
  2. urls 配列を /v1/tiktok/videos に POST し、返された task_id を保存します。
  3. タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。has_more が true の場合は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok Videos API の主なユースケース

  • コンテンツのパターン分析: キャプション、ハッシュタグ、メンション、音楽、再生時間を組み合わせ、選定した動画に共通する要素を比較します。
  • キャンペーン動画のレポート: 選定したアセットの再生数とエンゲージメントを取得し、キャンペーンのパフォーマンスを一貫した基準で比較します。
  • 動画アセットのカタログ化: 動画ID、正規URL、カバー画像、クリエイター、公開日時でコンテンツをインデックス化し、すばやく検索できるようにします。
  • トピックとフォーマットのタグ付け: 言語、キャプション、ハッシュタグ、音楽を使って、テーマ、フォーマット、想定オーディエンスを分類します。

TikTok Videos API 活用のヒント

  • 重複するアセットは id で統合し、確認やソースへの移動用に url を保持してください。
  • published_at は公開日時、collected_at は指標のスナップショット日時として保存してください。
  • caption、hashtags、mentions、music を組み合わせて、検索可能なコンテンツ特徴量にしてください。
  • views が存在し0より大きい場合は、いいね率・コメント率・シェア率の分母として使用してください。
  • 同じ動画IDで Comments のレコードを結合すると、アセットのパフォーマンスとオーディエンスの反応を比較できます。
  • 比較対象の動画はできるだけ近い時間に取得し、エンゲージメントのスナップショットを比較可能な状態に保ってください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok User Videos API — ユーザー名から、プロフィールフィードの公開動画をキャプション、クリエイター、メディア、タイムスタンプ、エンゲージメント、元のアカウント情報とともに取得します。
  • TikTok Trending Feed API — 地域ごとの現在の公開動画フィードを取得し、クリエイター、キャプション、カバー、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。
  • TikTok Video Transcript API — 公開動画のURLから、取得可能な文字起こしテキスト、言語、形式、取得元の情報を抽出します。
  • TikTok Fake Views Checker API — 動画URLの偽再生をスコア化し、推定される偽の再生数とトラフィック段階を返します。

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

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

TikTok Videos API — よくある質問

TikTok Videos APIは、1つ以上のTikTok動画の直接URLから、公開アクセス可能な動画メタデータを取得するAPIです。正規化されたクリエイター、キャプション、メディア、音楽、ハッシュタグ、メンション、公開情報、エンゲージメントのデータを返します。

1つ以上のTikTok動画の直接URLを urls 配列に入れてください。各URLは既知の動画の検索として処理されます。

できます。urls には複数の直接リンクを指定できるため、キャンペーン、クリエイター、競合の動画リストをまとめて情報補完できます。

結果には、動画ID、正規URL、キャプション、言語、公開日時、ハッシュタグ、メンション、公開されているクリエイターのアカウント情報とプロフィールのフィールドが含まれます。

結果には、いいね数、コメント数、再生数、シェア数、保存数、リポスト数に加え、再生時間、メディア、音楽のメタデータが含まれる場合があります。

エンゲージメント指標を collected_at とあわせて保存し、選定した動画群を近い取得時刻で比較してください。

返された正規化動画結果1件につき0.7クレジットです。