Submit a TikTok username and retrieve its collected video records after the collection task finishes
概要
TikTok検索でトピックの現れ方を調べるには、一致する動画IDと公開リンクを信頼できる形で集める必要があります。このアプリは1つの検索キーワードから一致項目を構造化して収集し、各識別子にキーワードと収集コンテキストを添えるため、書き出し後や他資料と結合した後もデータセットを理解しやすくなります。
結果は発見用の索引として使えます。収集時点でブランド、商品、トピック、キャンペーンに紐づいた公開動画が分かります。継続的なモニタリング集合の作成、異なる語句で見つかるコンテンツ集団の比較、検索ページから手作業で控えることなく後続分析用のIDとリンクを用意するのに向いています。
データについて
各レコードは指定した検索キーワードに関連するTikTokの1件です。返却データセット内ではコンテンツIDで重複を除きます。一致キーワード、元の検索項目、ビジネスIDは収集コンテキストを保持し、同じ検索の多くのレコードで繰り返される場合があります。収集日時にはタイムゾーンがなく、地域をまたぐ絶対時刻としては扱わないでください。キーワード種別はレコードに付いた検索項目の種類を示します。
この収集には識別子、公開動画リンク、収集メタデータが含まれ、キャプション、文字起こし、反応数、コメント、完全な作者プロフィールは含まれません。データなしフラグは、一致コンテンツがない検索メタデータと通常の一致レコードを区別します。非公開、削除済み、検索できないTikTokコンテンツは対象外です。
結果の例
各行は検索キーワードに関連する一致TikTok動画、またはデータなしフラグです。
| コンテンツID | 一致キーワード | コンテンツURL | 収集日時 | データなしフラグ |
|---|---|---|---|---|
| 7678592532162284813 | bluetooth earbuds | https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 | 2026-08-27T15:13:22 | いいえ |
| 7678160781283822879 | bluetooth earbuds | https://www.tiktok.com/@stitch.series6/video/7678160781283822879 | 2026-08-27T15:13:22 | いいえ |
キーワード種別、収集レコードID、ビジネスID、元の検索項目も、レコードに含まれる場合は利用できます。
活用シーン
- トピック発見では、一致キーワードごとに行をまとめ、異なるコンテンツIDの数を数えて、各語句に紐づく検索可能な動画の規模を比較します。
- モニタリングでは、キーワード収集を繰り返し、コンテンツIDの集合を比較し、新たに観測された項目の文脈として収集日時を使います。
- 由来確認では、データセットを結合する前に、一致キーワード、元の検索項目、ビジネスIDを比べて、各動画がどの検索文脈から得られたかを確認します。
- 後続確認では、コンテンツURLを開き、データなしフラグで空検索のメタデータと使える一致レコードを分けます。
適用範囲と境界
1タスクにつきTikTok検索キーワードは1つ、期待件数は1~200件です。結果は10件単位の完全なバッチで返るため切り上げられる場合があり、公開のTikTokキーワード検索一覧に限定されます。
- 適している用途
- ブランド、商品、トピック、キャンペーンに関するTikTokキーワード検索のコンテンツIDと公開動画リンクが必要な場合。
- 一致した各動画と検索キーワード、収集メタデータを結び付けた構造化リストが必要な場合。
- 適さない用途
- キャプション、文字起こし、反応指標、コメント、完全な作者プロフィールが必要な場合。
- バックグラウンド収集ではなく、1件を即時に照会したい場合。
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一致レコードがない場合はキーワードを確認するか、より短く広い検索語句を試してください。
- 2一部成功では完了済みレコードを保持し、失敗または期限切れでは同じ入力で再実行してください。
- 3レート制限、一時的なサービス停止、タイムアウト後は時間を置いて再試行してください。
- 4認証に失敗した場合は、実行環境に設定されたAPIキーを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- 検索キーワード
keyword必須stringTikTokで検索するブランド、商品、トピック、または語句です。1タスクにつき1~512文字のキーワードを1つ指定します。例Shokz - 期待結果件数
crawl_count必須integer期待する検索結果件数を1~200で指定します。結果は10件単位の完全なバッチで返るため、実際の件数が切り上げられる場合があります。範囲1–200例1
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- コンテンツID
content_idstring一致したTikTok動画の一意識別子です。例7678592532162284813 - コンテンツURL
content_urlstring一致した項目の公開TikTok動画URLです。例https://www.tiktok.com/@rebeccashao0/video/7678592532162284813 - 一致キーワード
keywordstring収集されたコンテンツに関連付けられた検索キーワードです。例bluetooth earbuds - キーワード種別
keyword_typestringレコードに関連付けられた検索項目の分類です。例keyword
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"content_id": "7678592532162284813",
"content_url": "https://www.tiktok.com/@rebeccashao0/video/7678592532162284813",
"keyword": "bluetooth earbuds",
"keyword_type": "keyword",
"crawl_time": "2026-08-27T15:13:22",
"cur_id": "6a8fe396b799f44efa7f2ff0",
"biz_id": "bluetooth earbuds",
"source_item": "bluetooth earbuds",
"no_data": false
}連携方法
この 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-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。