概要
TikTok動画の公開コメントは、視聴者が自分の言葉でどう反応し、どの発言に返信が集まり、作者がいいねやピン留めをしているかを示します。このData Appは、1本の動画の公開コメント欄を、本文、投稿者、返信関係、反応のスナップショット、投稿時刻が揃ったデータセットにします。
手作業でコメント欄をスクロールするのではなく、繰り返し分析できる形で原文を残し、各コメントを動画・投稿者・親コメント・ルートコメントに結び付けます。反応の比較、繰り返し現れるテーマの発見、会話の点検がしやすくなります。
データ説明
データは、指定したTikTok動画で取得時点に公開されているコメントを対象にします。通常レコードはコメントIDで識別され、重複除去にも使われます。非公開、削除済み、コメント無効の動画は対象外です。
いいね数、返信数、作者のいいね、作者のピン留めはスナップショットであり、取得後に変わることがあります。件数、コメント種別などの分類値、メンション欄は数値やリストに変換せず、ソースのテキストのまま保持されます。投稿日時と取得日時はタイムゾーンを推定せず、データ源の表記を保ちます。キーワード、ビジネスID、コンテンツID、ソース項目は、ソースレコードがその値を持っている場合、投入したコンテンツIDを繰り返すことがあります。画像URLはコメントに画像がない場合は空です。親コメントIDはトップレベルコメントでは通常 0 です。データなしは、公開コメントが取得できなかったときの結果を残します。
結果の形
通常の各レコードは、選択したTikTok動画の公開コメント1件を表します。
| コメントID | コメント本文 | 投稿者名 | 投稿日時 | いいね数 | 返信数 |
|---|---|---|---|---|---|
| 7676928910512587528 | 🔥🔥🔥 | LOR3NZO 🥵 | 2026-08-23T02:45:14 | 1 | 0 |
| 7676937550266663696 | Hi | F00tba11EDITS | 2026-08-23T03:18:57 | 0 | 0 |
追加の値には、アイコンと投稿者識別子、返信関係、作者の反応フラグ、取得時刻、メンションテキスト、データなしの結果が含まれます。
利用シーン
- コメント本文をいいね数と返信数と突き合わせ、目に見える反応が強かった発言を見つける。
- コメント本文を繰り返し現れる語句でまとめ、投稿日時で議論の変化を見る。
- 親コメントID、ルートコメントID、コメント種別で返信スレッドを組み立て、トップレベルと返信を区別する。
- 作者のいいねと作者のピン留めを投稿者IDと合わせて見直し、作者が議論にどう参加したかを見る。
適用範囲と境界
1回の実行で1本のTikTok動画からコメントを取得します。希望件数は1〜10000件です。結果は20件単位の完全なバッチで返るため、実際の件数は切り上げられる場合があります。対象は取得時点で公開されているコメントのみです。
- 適している用途
- 特定のTikTok動画の公開コメント本文と反応状況が必要なとき
- コメント投稿者、返信関係、投稿時刻、作者の反応を分析したいとき
- 適さない用途
- 1回の実行で複数動画のコメントが必要なとき——動画ごとに別の実行を提出してください
- 非公開、削除済み、コメント無効のデータを求めるとき——このAppは公開コメントのみを対象とします
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1コメントが返らない場合は、コンテンツIDを確認し、動画とコメントが公開されているか確かめてください
- 2レート制限、一時的な利用不可、タイムアウトのあとは、同じ内容で後から再試行できます
- 3提出結果が不明なときは、重複タスクを作らないよう、すぐ同じ内容を再提出しないでください
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| content_id | コンテンツID | string | はい | — | — | 7676927940759653650 | 公開TikTok動画のコメントを取得するための数字IDです。キーワードやURLではなく、コンテンツIDを1つだけ入力してください。 |
| comment_count | 希望コメント数 | integer | はい | — | 1–10000 | 20 | 取得したいコメント数で、1〜10000件です。結果は20件単位の完全なバッチで返され、同じ単位で課金されるため、実際の件数は切り上げられる場合があります。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| comment_id | コメントID | string | 7676928910512587528 | TikTokコメントの安定した一意の識別子 |
| content_id | コンテンツID | string | 7676927940759653650 | コメントが紐づくTikTok動画の識別子 |
| cur_id | レコードID | string | 6a8fe471f5f83d2da3b7649d | このコメントとともに返されたソース側のレコード識別子 |
| comment_type | コメント種別 | string | 1 | コメント種別を示すソース値。ソースのテキストのまま保持されます |
| root_comment_id | ルートコメントID | string | 7676928910512587528 | この返信スレッドのルートコメント識別子。トップレベルコメントでは通常自身のコメントIDと同じです |
| parent_comment_id | 親コメントID | string | 0 | 返信先の親コメント識別子。トップレベルコメントでは通常 0 です |
| comment_user_id | 投稿者ID | string | 7577435595783603221 | コメント投稿者の公開TikTok識別子 |
| comment_user_avatar_url | 投稿者アイコン | string | https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/02b166b17f1f9cd4fd5bcab5b12d3b4f~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=e18e22e5&x-expires=1787900400&x-signature=NEB%2BONXLIJ33UyKgKI6NOuyNNS0%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5 | コメント投稿者の公開アイコン画像URL |
| comment_user_name | 投稿者名 | string | LOR3NZO 🥵 | コメント投稿者の公開表示名 |
| comment_text | コメント本文 | string | 🔥🔥🔥 | TikTokコメントとして公開された本文 |
| publish_time | 投稿日時 | string | 2026-08-23T02:45:14 | コメントが投稿されたソース側の時刻。データ源の表記のまま保持されます |
| image_urls | 画像URL | string | — | コメントに付いた画像アドレス。ソースのテキストのまま保持され、画像がない場合は空です |
| crawl_time | 取得日時 | string | 2026-08-27T15:17:02 | このコメントレコードが取得されたソース側の時刻。データ源の表記のまま保持されます |
| like_count | いいね数 | string | 1 | 取得時点のいいね数。ソースのテキストのまま保持されます |
| keyword | キーワード | string | 7676927940759653650 | このコメントレコードに付随するソース側のキーワード値。ソースのテキストのまま保持されます |
| sec_id | 投稿者sec ID | string | MS4wLjABAAAAPbxslh-t5xoPlxOuQY3X4ZNjqiwy2dBXmUa5HM7crjnOmIAJTTzKPm5aYI79jHTn | コメント投稿者の公開TikTok sec ID。ソースのテキストのまま保持されます |
| biz_id | ビジネスID | string | 7676927940759653650 | ソースのコメントレコードが持つビジネス識別子。ソースのテキストのまま保持されます |
| detailed_mentions | 詳細メンション | string | [] | ソースレコードが持つ詳細なメンションテキスト。リストには変換せず、ソースのテキストのまま保持されます |
| liked_by_author | 作者のいいね | boolean | true | 取得時点で動画作者がこのコメントにいいねしたかどうか |
| mentions | メンション | string | [] | ソースレコードが持つメンションテキスト。リストには変換せず、ソースのテキストのまま保持されます |
| pinned_by_author | 作者のピン留め | boolean | false | 取得時点で動画作者がこのコメントをピン留めしたかどうか |
| reply_comment_total | 返信数 | string | 0 | 取得時点の返信数。ソースのテキストのまま保持されます |
| source_item | ソース項目 | string | 7676927940759653650 | この結果レコードに対応する、投入されたTikTokコンテンツID |
| no_data | データなし | boolean | false | 対象動画について公開コメントが取得できなかったかどうか |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"comment_id": {
"type": "string",
"title": "コメントID",
"description": "TikTokコメントの安定した一意の識別子",
"prefill": "7676928910512587528"
},
"content_id": {
"type": "string",
"title": "コンテンツID",
"description": "コメントが紐づくTikTok動画の識別子",
"prefill": "7676927940759653650"
},
"cur_id": {
"type": "string",
"title": "レコードID",
"description": "このコメントとともに返されたソース側のレコード識別子",
"prefill": "6a8fe471f5f83d2da3b7649d"
},
"comment_type": {
"type": "string",
"title": "コメント種別",
"description": "コメント種別を示すソース値。ソースのテキストのまま保持されます",
"prefill": "1"
},
"root_comment_id": {
"type": "string",
"title": "ルートコメントID",
"description": "この返信スレッドのルートコメント識別子。トップレベルコメントでは通常自身のコメントIDと同じです",
"prefill": "7676928910512587528"
},
"parent_comment_id": {
"type": "string",
"title": "親コメントID",
"description": "返信先の親コメント識別子。トップレベルコメントでは通常 0 です",
"prefill": "0"
},
"comment_user_id": {
"type": "string",
"title": "投稿者ID",
"description": "コメント投稿者の公開TikTok識別子",
"prefill": "7577435595783603221"
},
"comment_user_avatar_url": {
"type": "string",
"title": "投稿者アイコン",
"description": "コメント投稿者の公開アイコン画像URL",
"prefill": "https://p16-common-sign.tiktokcdn-us.com/tos-alisg-avt-0068/02b166b17f1f9cd4fd5bcab5b12d3b4f~tplv-tiktokx-cropcenter:100:100.jpg?dr=9640&refresh_token=e18e22e5&x-expires=1787900400&x-signature=NEB%2BONXLIJ33UyKgKI6NOuyNNS0%3D&t=4d5b0474&ps=13740610&shp=30310797&shcp=ff37627b&idc=useast5"
},
"comment_user_name": {
"type": "string",
"title": "投稿者名",
"description": "コメント投稿者の公開表示名",
"prefill": "LOR3NZO 🥵"
},
"comment_text": {
"type": "string",
"title": "コメント本文",
"description": "TikTokコメントとして公開された本文",
"prefill": "🔥🔥🔥"
},
"publish_time": {
"type": "string",
"title": "投稿日時",
"description": "コメントが投稿されたソース側の時刻。データ源の表記のまま保持されます",
"prefill": "2026-08-23T02:45:14"
},
"image_urls": {
"type": "string",
"title": "画像URL",
"description": "コメントに付いた画像アドレス。ソースのテキストのまま保持され、画像がない場合は空です"
},
"crawl_time": {
"type": "string",
"title": "取得日時",
"description": "このコメントレコードが取得されたソース側の時刻。データ源の表記のまま保持されます",
"prefill": "2026-08-27T15:17:02"
},
"like_count": {
"type": "string",
"title": "いいね数",
"description": "取得時点のいいね数。ソースのテキストのまま保持されます",
"prefill": "1"
},
"keyword": {
"type": "string",
"title": "キーワード",
"description": "このコメントレコードに付随するソース側のキーワード値。ソースのテキストのまま保持されます",
"prefill": "7676927940759653650"
},
"sec_id": {
"type": "string",
"title": "投稿者sec ID",
"description": "コメント投稿者の公開TikTok sec ID。ソースのテキストのまま保持されます",
"prefill": "MS4wLjABAAAAPbxslh-t5xoPlxOuQY3X4ZNjqiwy2dBXmUa5HM7crjnOmIAJTTzKPm5aYI79jHTn"
},
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "ソースのコメントレコードが持つビジネス識別子。ソースのテキストのまま保持されます",
"prefill": "7676927940759653650"
},
"detailed_mentions": {
"type": "string",
"title": "詳細メンション",
"description": "ソースレコードが持つ詳細なメンションテキスト。リストには変換せず、ソースのテキストのまま保持されます",
"prefill": "[]"
},
"liked_by_author": {
"type": "boolean",
"title": "作者のいいね",
"description": "取得時点で動画作者がこのコメントにいいねしたかどうか",
"prefill": true
},
"mentions": {
"type": "string",
"title": "メンション",
"description": "ソースレコードが持つメンションテキスト。リストには変換せず、ソースのテキストのまま保持されます",
"prefill": "[]"
},
"pinned_by_author": {
"type": "boolean",
"title": "作者のピン留め",
"description": "取得時点で動画作者がこのコメントをピン留めしたかどうか",
"prefill": false
},
"reply_comment_total": {
"type": "string",
"title": "返信数",
"description": "取得時点の返信数。ソースのテキストのまま保持されます",
"prefill": "0"
},
"source_item": {
"type": "string",
"title": "ソース項目",
"description": "この結果レコードに対応する、投入されたTikTokコンテンツID",
"prefill": "7676927940759653650"
},
"no_data": {
"type": "boolean",
"title": "データなし",
"description": "対象動画について公開コメントが取得できなかったかどうか",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。
MCP(Model Context Protocol)を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"hello_moto__tiktok-video-comments": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=hello_moto/tiktok-video-comments",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 20 件を 1 つの課金単位とし、端数は 20 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。