JP

TikTok動画詳細

最大200件のTikTok動画URLを投入し、公開されている動画・アカウント・エンゲージメント・メディア詳細を取得します

翻訳済み · ja-JP原文を表示

開発者
料金
$0.0015 / 件から
最終更新
2026-09-18

概要

公開されているTikTok動画の詳細は、すでに把握している動画について、見えるキャプション、クリエイター情報、エンゲージメントのスナップショット、メディア参照をまとめます。このData Appは、一連のTikTok動画リンクを、確認・比較・補強・保存に使える一貫したレコードに変えます。

動画を1本ずつ開いて目に見える情報を書き写す代わりに、チームは結果を構造化された調査データとして使えます。動画の候補リストがすでにあり、次にクリエイティブのテーマ、クリエイターの文脈、公開の傾向、公開エンゲージメントを比べたいときに特に役立ちます。

データ説明

データは、指定したリンクに対する公開TikTok動画詳細を対象とします。有効で重複除去された各動画URLは、動画IDで識別されるレコードを最大1件返します。無効、重複、削除済み、非公開、またはログイン限定の動画はレコードを返さない場合があります。

いいね数、コメント数、再生数、保存数、シェア数、フォロワー数、認証状態、および関連する値は収集時点のスナップショットであり、後から変わることがあります。件数フィールドはソースのテキスト形式のまま保持されます。動画キャプション、ハッシュタグ、メンション、楽曲フィールドもソーステキストとして保持されます。公開日時、収集日時、レコード更新日時は、タイムゾーンを補完せずソースの時刻を保ちます。

結果のイメージ

各レコードは、1本のTikTok動画について取得した公開詳細を表します。

動画IDアカウント名再生数いいね数公開国認証アカウント
7457124241389915399คณะสิงโตมังกรทองลูกชัยมงคล175600652Thailandいいえ
7659102246143102238Luxury cars6532118United Statesいいえ

ほかに、アカウント識別子とプロフィールリンク、カバーと動画URL、全文キャプション、楽曲メタデータ、収集日時、投入URLなどの値があります。

活用シーン

  • 再生数、いいね数、コメント数、シェア数を比べて、目に見えるエンゲージメントが強い動画を見つける。
  • 動画キャプション、ハッシュタグ、メンションを確認して、クリエイティブのテーマとメッセージを分類する。
  • アカウント名、アカウントID、プロフィールURL、認証アカウントを使って、選んだ動画セットにクリエイター文脈を加える。
  • 公開日時、収集日時、動画URL、再生URLを繰り返し収集して比べ、公開状態とメディア参照を監視する。

適用範囲と境界

1回の実行で1〜200件のTikTok動画URLを受け付け、有効で重複除去された各URLは公開詳細レコードを最大1件返します。

  • 適している用途
  • 既知のTikTok動画URLに対する公開メタデータとエンゲージメントのスナップショットが必要なときに使う
  • 1つのバックグラウンドタスクで最大200件の動画詳細レコードが必要なときに使う
  • 適さない用途
  • キーワード、ハッシュタグ、アカウントから動画を探す用途には使わない。既知のTikTok動画URLを指定する
  • 非公開、削除済み、ログイン限定の動画には使わない

失敗時の処理

開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

  1. 1一時的なタスクまたはサービス失敗は、同じ動画URLで再試行する
  2. 2一部だけ成功した場合は、返されたレコードを使い、欠けている動画URLを再試行する
  3. 3空の結果は、URLが無効、重複、利用不可、または非公開になったことを意味する場合がある

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

  • TikTok動画URLvideo_items必須array<object>
    1〜200件のエントリを追加します。各エントリの「動画URL」欄にTikTok動画の完全なURLを入れてください。無効、重複、またはアクセスできないURLはレコードを返さない場合があります。
    件数最大 200 件例[{"kw":"https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399"}]

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

  • アカウントアバターURLaccount_avatar_urlstring
    この動画で返されたアカウントのアバター画像URL。
    例https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-giso/775d60a4592d9e2c8f9444d6146c86ba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=8fd2219a&x-expires=1787889600&x-signature=YNGo392zpoBnhgP2xrZA4E1qzug%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8
  • フォロワー数account_fans_countstring
    ソースのテキスト形式のまま保持されたアカウントのフォロワー数。
    例74700
  • フォロー数account_following_countstring
    ソースのテキスト形式のまま保持されたアカウントのフォロー数。
    例260
  • アカウントハート数account_heart_countstring
    ソースのテキスト形式のまま保持されたアカウントのハート数。

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "account_avatar_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast2a-avt-0068-giso/775d60a4592d9e2c8f9444d6146c86ba~tplv-tiktokx-cropcenter:100:100.jpeg?dr=9640&refresh_token=8fd2219a&x-expires=1787889600&x-signature=YNGo392zpoBnhgP2xrZA4E1qzug%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8",
  "account_fans_count": "74700",
  "account_following_count": "260",
  "account_heart_count": "<account_heart_count>",
  "account_id": "6905360269078922241",
  "account_name": "คณะสิงโตมังกรทองลูกชัยมงคล",
  "account_secure_id": "MS4wLjABAAAAB1kYoG7ow0_uy4aBS2ZdAH-tmY08IL85lod-zAzx5mh53zWaEyhH3_GzgFMubNuN",
  "account_signature": "ติดต่อสอบถามผลงาน",
  "account_total_like_count": "4401",
  "author_create_time": "<author_create_time>",
  "biz_id": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "clean_update_time": "2026-08-26T12:58:28",
  "collect_count": "53",
  "comment_count": "10",
  "content_id": "7457124241389915399",
  "content_text": "#คณะสิงโตมังกรทองลูกชัยมงคล ซ้อมใหญ่เตรียมงานตรุษจีน #ลูกชัยมงคล #สิงโตโปงลาง #สิงโตอีเว้นท์ #เชิดสิงโตอวยพร #สิงโตมงคล",
  "content_url": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "country_code": "TH",
  "crawl_time": "2026-08-26T12:58:27",
  "cur_id": "6a8e7274f5f83d2da3b12346",
  "detailed_mentions": "<detailed_mentions>",
  "effect_stickers": "<effect_stickers>",
  "hashtags": "<hashtags>",
  "is_ad": false,
  "is_slideshow": false,
  "is_verified": false,
  "keyword_list": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "like_count": "652",
  "location": "<location>",
  "mentions": "<mentions>",
  "music_album": "<music_album>",
  "music_author": "<music_author>",
  "music_cover_url": "<music_cover_url>",
  "music_id": "<music_id>",
  "music_name": "<music_name>",
  "music_original": false,
  "music_original_cover_url": "<music_original_cover_url>",
  "music_play_url": "<music_play_url>",
  "play_count": "175600",
  "private_account": false,
  "profile_url": "<profile_url>",
  "publish_country": "Thailand",
  "publish_time": "2025-01-07T18:50:40",
  "repost_count": "<repost_count>",
  "room_id": "<room_id>",
  "share_count": "28",
  "subtitle_links": "<subtitle_links>",
  "task_item": "https://www.tiktok.com/@chai_mong_kol/video/7457124241389915399",
  "task_no_data": false,
  "text_language": "<text_language>",
  "tt_seller": false,
  "user_friend_count": "<user_friend_count>",
  "user_video_count": "<user_video_count>",
  "video_cover_url": "<video_cover_url>",
  "video_definition": "<video_definition>",
  "video_download_addr": "<video_download_addr>",
  "video_duration": 0,
  "video_format": "<video_format>",
  "video_height": 0,
  "video_original_cover_url": "<video_original_cover_url>",
  "video_urls": "https://v16-webapp-prime.us.tiktok.com/video/tos/alisg/tos-alisg-pve-0037c001/oYLDobO0QBjLEifIFQAByIED9AzofDhCRHfV0x/?a=1988&bti=ODszNWYuMDE6&&bt=1611&ft=4KJMyMzm8Zmo0Z.tHa4jV~CCQpWrKsd.&mime_type=video_mp4&rc=OjdoNTw5Omc1OWVmOzhoZUBpamU1d3I5cnJqdzMzODczNEAvNi9eYjVjNjQxNF8wYF8zYSM1LzJzMmRrYXJgLS1kMTFzcw%3D%3D&expire=1787893156&l=202608260458202CAFAB1344990A166E7B&ply_type=2&policy=2&signature=2080d8f77af89de133812156ebbabc98&tk=tt_chain_token&btag=e000c8000",
  "video_width": 0
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。

detail.access.mcp.composeHint

料金

タスク開始

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回
返された詳細レコード

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。

$0.0015/ 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル
パラメータは送信前に input.schema で検証されます
$0.0015 / 件から