JP

TikTokキーワード検索

TikTokの検索キーワードを1つと期待件数を指定すると、一致する公開動画の識別子、リンク、収集メタデータを取得します。

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

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

概要

TikTok検索でトピックの現れ方を調べるには、一致する動画IDと公開リンクを信頼できる形で集める必要があります。このアプリは1つの検索キーワードから一致項目を構造化して収集し、各識別子にキーワードと収集コンテキストを添えるため、書き出し後や他資料と結合した後もデータセットを理解しやすくなります。

結果は発見用の索引として使えます。収集時点でブランド、商品、トピック、キャンペーンに紐づいた公開動画が分かります。継続的なモニタリング集合の作成、異なる語句で見つかるコンテンツ集団の比較、検索ページから手作業で控えることなく後続分析用のIDとリンクを用意するのに向いています。

データについて

各レコードは指定した検索キーワードに関連するTikTokの1件です。返却データセット内ではコンテンツIDで重複を除きます。一致キーワード、元の検索項目、ビジネスIDは収集コンテキストを保持し、同じ検索の多くのレコードで繰り返される場合があります。収集日時にはタイムゾーンがなく、地域をまたぐ絶対時刻としては扱わないでください。キーワード種別はレコードに付いた検索項目の種類を示します。

この収集には識別子、公開動画リンク、収集メタデータが含まれ、キャプション、文字起こし、反応数、コメント、完全な作者プロフィールは含まれません。データなしフラグは、一致コンテンツがない検索メタデータと通常の一致レコードを区別します。非公開、削除済み、検索できないTikTokコンテンツは対象外です。

結果の例

各行は検索キーワードに関連する一致TikTok動画、またはデータなしフラグです。

コンテンツID一致キーワードコンテンツURL収集日時データなしフラグ
7678592532162284813bluetooth earbudshttps://www.tiktok.com/@rebeccashao0/video/76785925321622848132026-08-27T15:13:22いいえ
7678160781283822879bluetooth earbudshttps://www.tiktok.com/@stitch.series6/video/76781607812838228792026-08-27T15:13:22いいえ

キーワード種別、収集レコードID、ビジネスID、元の検索項目も、レコードに含まれる場合は利用できます。

活用シーン

  • トピック発見では、一致キーワードごとに行をまとめ、異なるコンテンツIDの数を数えて、各語句に紐づく検索可能な動画の規模を比較します。
  • モニタリングでは、キーワード収集を繰り返し、コンテンツIDの集合を比較し、新たに観測された項目の文脈として収集日時を使います。
  • 由来確認では、データセットを結合する前に、一致キーワード、元の検索項目、ビジネスIDを比べて、各動画がどの検索文脈から得られたかを確認します。
  • 後続確認では、コンテンツURLを開き、データなしフラグで空検索のメタデータと使える一致レコードを分けます。

適用範囲と境界

1タスクにつきTikTok検索キーワードは1つ、期待件数は1~200件です。結果は10件単位の完全なバッチで返るため切り上げられる場合があり、公開のTikTokキーワード検索一覧に限定されます。

  • 適している用途
  • ブランド、商品、トピック、キャンペーンに関するTikTokキーワード検索のコンテンツIDと公開動画リンクが必要な場合。
  • 一致した各動画と検索キーワード、収集メタデータを結び付けた構造化リストが必要な場合。
  • 適さない用途
  • キャプション、文字起こし、反応指標、コメント、完全な作者プロフィールが必要な場合。
  • バックグラウンド収集ではなく、1件を即時に照会したい場合。

失敗時の処理

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

  1. 1一致レコードがない場合はキーワードを確認するか、より短く広い検索語句を試してください。
  2. 2一部成功では完了済みレコードを保持し、失敗または期限切れでは同じ入力で再実行してください。
  3. 3レート制限、一時的なサービス停止、タイムアウト後は時間を置いて再試行してください。
  4. 4認証に失敗した場合は、実行環境に設定されたAPIキーを確認してください。

入力

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

  • 検索キーワードkeyword必須string
    TikTokで検索するブランド、商品、トピック、または語句です。1タスクにつき1~512文字のキーワードを1つ指定します。
    例Shokz
  • 期待結果件数crawl_count必須integer
    期待する検索結果件数を1~200で指定します。結果は10件単位の完全なバッチで返るため、実際の件数が切り上げられる場合があります。
    範囲1–200例1

出力

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

  • コンテンツIDcontent_idstring
    一致したTikTok動画の一意識別子です。
    例7678592532162284813
  • コンテンツURLcontent_urlstring
    一致した項目の公開TikTok動画URLです。
    例https://www.tiktok.com/@rebeccashao0/video/7678592532162284813
  • 一致キーワードkeywordstring
    収集されたコンテンツに関連付けられた検索キーワードです。
    例bluetooth earbuds
  • キーワード種別keyword_typestring
    レコードに関連付けられた検索項目の分類です。
    例keyword

サンプルデータ

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

output.example
{
  "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 config
{
  "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件

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 10 件を 1 つの課金単位とし、端数は 10 件に切り上げて課金されます。

$0.002/ 10 件
Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

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