Submit a TikTok username and retrieve its collected video records after the collection task finishes
概要
公開されているTikTok動画の詳細は、すでに把握している動画について、見えるキャプション、クリエイター情報、エンゲージメントのスナップショット、メディア参照をまとめます。このData Appは、一連のTikTok動画リンクを、確認・比較・補強・保存に使える一貫したレコードに変えます。
動画を1本ずつ開いて目に見える情報を書き写す代わりに、チームは結果を構造化された調査データとして使えます。動画の候補リストがすでにあり、次にクリエイティブのテーマ、クリエイターの文脈、公開の傾向、公開エンゲージメントを比べたいときに特に役立ちます。
データ説明
データは、指定したリンクに対する公開TikTok動画詳細を対象とします。有効で重複除去された各動画URLは、動画IDで識別されるレコードを最大1件返します。無効、重複、削除済み、非公開、またはログイン限定の動画はレコードを返さない場合があります。
いいね数、コメント数、再生数、保存数、シェア数、フォロワー数、認証状態、および関連する値は収集時点のスナップショットであり、後から変わることがあります。件数フィールドはソースのテキスト形式のまま保持されます。動画キャプション、ハッシュタグ、メンション、楽曲フィールドもソーステキストとして保持されます。公開日時、収集日時、レコード更新日時は、タイムゾーンを補完せずソースの時刻を保ちます。
結果のイメージ
各レコードは、1本のTikTok動画について取得した公開詳細を表します。
| 動画ID | アカウント名 | 再生数 | いいね数 | 公開国 | 認証アカウント |
|---|---|---|---|---|---|
| 7457124241389915399 | คณะสิงโตมังกรทองลูกชัยมงคล | 175600 | 652 | Thailand | いいえ |
| 7659102246143102238 | Luxury cars | 6532 | 118 | United States | いいえ |
ほかに、アカウント識別子とプロフィールリンク、カバーと動画URL、全文キャプション、楽曲メタデータ、収集日時、投入URLなどの値があります。
活用シーン
- 再生数、いいね数、コメント数、シェア数を比べて、目に見えるエンゲージメントが強い動画を見つける。
- 動画キャプション、ハッシュタグ、メンションを確認して、クリエイティブのテーマとメッセージを分類する。
- アカウント名、アカウントID、プロフィールURL、認証アカウントを使って、選んだ動画セットにクリエイター文脈を加える。
- 公開日時、収集日時、動画URL、再生URLを繰り返し収集して比べ、公開状態とメディア参照を監視する。
適用範囲と境界
1回の実行で1〜200件のTikTok動画URLを受け付け、有効で重複除去された各URLは公開詳細レコードを最大1件返します。
- 適している用途
- 既知のTikTok動画URLに対する公開メタデータとエンゲージメントのスナップショットが必要なときに使う
- 1つのバックグラウンドタスクで最大200件の動画詳細レコードが必要なときに使う
- 適さない用途
- キーワード、ハッシュタグ、アカウントから動画を探す用途には使わない。既知のTikTok動画URLを指定する
- 非公開、削除済み、ログイン限定の動画には使わない
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一時的なタスクまたはサービス失敗は、同じ動画URLで再試行する
- 2一部だけ成功した場合は、返されたレコードを使い、欠けている動画URLを再試行する
- 3空の結果は、URLが無効、重複、利用不可、または非公開になったことを意味する場合がある
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- TikTok動画URL
video_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 から生成されています。
- アカウントアバターURL
account_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 から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"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": {
"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 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。