TikTok Videos
TikTok動画は、キャプション、クリエイター情報、メディア、音楽、再生時間、ハッシュタグ、メンション、公開情報、表示中のエンゲージメントを含むショート動画の投稿です。これらのコンテンツ情報は、トレンド調査、クリエイティブ分析、キャンペーンの振り返り、パフォーマンス比較に活用できます。
TikTok Videos API の主な機能
- 複数動画URLの一括検索まとめて指定したTikTok動画リンクを、形式の揃ったコンテンツレコードに変換します。
- 安定した動画識別動画IDと正規URLにより、動画の識別とソースの特定ができます。
- コンテンツとクリエイターのフィールドキャプション、言語、公開日時、クリエイター、再生時間、カバー画像の情報を抽出します。
- クリエイティブ関連のフィールドハッシュタグ、メンション、音楽、コンテンツフラグをクリエイティブ分析に取り込めます。
- 特定時点の指標表示中のエンゲージメント数を collected_at と組み合わせ、パフォーマンスのスナップショットとして保存できます。
TikTok Videos API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。現在公開アクセスが可能なTikTok動画の直接URLのリストです。 |
TikTok Videos API の使い方
ブックマーク、レポート、社内システムにあるリンクを、分析にすぐ使える動画一覧に変換します。
- 動画の直接リンクを集め、URL形式を正規化して重複を排除します。
- urls 配列を /v1/tiktok/videos に POST し、返された task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 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 trueTikTok Videos API の主なユースケース
- コンテンツのパターン分析: キャプション、ハッシュタグ、メンション、音楽、再生時間を組み合わせ、選定した動画に共通する要素を比較します。
- キャンペーン動画のレポート: 選定したアセットの再生数とエンゲージメントを取得し、キャンペーンのパフォーマンスを一貫した基準で比較します。
- 動画アセットのカタログ化: 動画ID、正規URL、カバー画像、クリエイター、公開日時でコンテンツをインデックス化し、すばやく検索できるようにします。
- トピックとフォーマットのタグ付け: 言語、キャプション、ハッシュタグ、音楽を使って、テーマ、フォーマット、想定オーディエンスを分類します。
TikTok Videos API 活用のヒント
- 重複するアセットは id で統合し、確認やソースへの移動用に url を保持してください。
- published_at は公開日時、collected_at は指標のスナップショット日時として保存してください。
- caption、hashtags、mentions、music を組み合わせて、検索可能なコンテンツ特徴量にしてください。
- views が存在し0より大きい場合は、いいね率・コメント率・シェア率の分母として使用してください。
- 同じ動画IDで Comments のレコードを結合すると、アセットのパフォーマンスとオーディエンスの反応を比較できます。
- 比較対象の動画はできるだけ近い時間に取得し、エンゲージメントのスナップショットを比較可能な状態に保ってください。
関連API
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 Hashtags API
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok Live Room Info API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Comment Keywords API