概要
買い物客が実際に商品を見つけるのはTikTok Shopのキーワード検索ですが、公開リスティングを比較可能なデータとして残すのは難しいです。タイトル、価格、ショップ、順位は一緒に動き、スクリーンショットは分析に向きません。このアプリは1つの検索キーワードを、米国TikTok Shopの一致商品の構造化リストに変え、マーチャンダイジング、ブランド、リサーチの担当者がその語句で今何が並んでいるかを見られるようにします。
すでに知っている商品ページを開くのとは違い、キーワード検索はブランド、カテゴリ、キャンペーンの語句に対してどの掲載が棚を占めているかを示します。商品の識別情報、掲載の商業シグナル、ショップの文脈を同じ行に残すことで、語句の比較、ブランドの露出確認、候補セットの作成を、結果を手で写さずに進められます。
データについて
各レコードは、米国TikTok Shopで送信した検索キーワードに紐づく公開商品掲載です。返却データセット内では商品IDで重複が除かれます。ヒットキーワード、ビジネスID、ソース項目は検索の文脈を保ち、同じタスクの多くの商品で繰り返されることがあります。掲載は収集時刻の安定した昇順で返ります。
価格は別通貨フィールドのない生文字列です。収集タイムスタンプと作成タイムスタンプはミリ秒文字列です。収集時刻にはタイムゾーンがないため、地域をまたぐ絶対時計として扱わないでください。検索順位は0から始まります。データなしマーカーは、一致商品がなかった検索項目と通常の掲載行を区別します。
対象は米国の公開検索掲載のみです。他国のカタログ、商品詳細の仕様、コメント、注文データは含まれません。
結果の例
各行は、検索キーワードに紐づくTikTok Shopの商品掲載1件、またはその検索のデータなしマーカーです。
| 商品タイトル | 商品ID | 価格 | ショップ名 | 販売数 | 検索順位 |
|---|---|---|---|---|---|
| Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | 1729435358486827693 | 41.54 | Micro Ingredients | 23284 | 0 |
| Binggrae Flavored Milk Drink, Banana Flavor 200ml * 6 Cartons | 1729408858647663361 | 18.26 | Weee Asian Supermarket | 6714 | 1 |
ブランド名、商品画像、評価数、ショップID、収集時刻、データなしマーカーも、レコードに含まれる場合に利用できます。
活用シーン
- キーワードの棚づくりでは、ヒットキーワードで行をまとめ、商品タイトル、価格、ショップ名を比べて、検索棚をどの掲載が占めているかを見ます。
- 競合追跡では、検索順位で並べ、販売数と評価数で目立つ掲載とロングテール商品を分けます。
- ブランド監視では、ブランド名をショップ名と商品IDと照合し、ブランド商品が自社ショップか他の出品者かを見ます。
- ソーシングのフォローでは、商品ID、ショップID、商品画像を一緒に残し、検索をやり直さずに同じ掲載を後から開けます。
適用範囲と境界
1回のタスクでTikTok Shopの検索キーワードは1件、希望件数は1〜300件。結果は30件単位の完全バッチで返り、切り上げられる場合があります。対象は米国の公開TikTok Shop検索商品に限られます。
- 適している用途
- ブランド、商品、カテゴリのキーワードで米国TikTok Shopに表示される商品が必要なとき。
- 一致した各掲載を店舗、価格、順位、公開の販売・評価シグナルと結び付けた一覧が必要なとき。
- 適さない用途
- 商品詳細ページの完全な仕様、コメント、注文データが必要なとき。
- バックグラウンドのキーワード収集ではなく、即時の単一レコード照会が必要なとき。
- 米国以外の地域のTikTok Shop掲載が必要なとき。
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一致するレコードがない場合は、より短く広い検索語句に変えて再提出してください。
- 2部分成功後は取得済みレコードを残し、失敗または期限切れ後は同じ入力で再提出してください。
- 3レート制限、一時的な利用不可、タイムアウトの後は時間をおいて再試行してください。
- 4認証に失敗した場合は、実行環境に設定したAPI Keyを確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| keyword | 検索キーワード | string | はい | — | — | milk | TikTok Shopで検索するブランド、商品、またはカテゴリの語句です。1回のタスクでキーワードは1つ、1〜512文字です。 |
| crawl_count | 希望取得件数 | integer | はい | — | 1–300 | 30 | 取得したい商品件数で、1〜300件です。結果は30件単位の完全バッチで返るため、実際の件数は切り上げられる場合があります。30件未満でも30件として課金されます。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| biz_id | ビジネスID | string | milk | 収集した商品に付く業務グループ識別子。値がない場合は空です。 |
| brand_name | ブランド名 | string | Micro Ingredients | 商品ページに表示されるブランド名。値がない場合は空です。 |
| collect_time | 収集タイムスタンプ | string | 1789121807761 | 収集時刻のミリ秒タイムスタンプ文字列。値がない場合は空です。 |
| crawl_time | 収集時刻 | string | 2026-09-11T18:16:47 | 商品の収集時刻。ソースはタイムゾーンを示しません。 |
| created_at | 作成タイムスタンプ | string | 1789121807761 | レコード作成時刻のミリ秒タイムスタンプ文字列。値がない場合は空です。 |
| image_url | 商品画像 | string | https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839 | 商品ページのメイン画像URL。値がない場合は空です。 |
| keyword | ヒットキーワード | string | milk | この商品に紐づく検索キーワード。 |
| page_num | 結果ページ | string | 1 | 検索結果のページ番号文字列。値がない場合は空です。 |
| platform_code | プラットフォームコード | string | tiktokShop | 商品に付くソースプラットフォームコード。 |
| price | 価格 | string | 41.54 | 通貨フィールドのない生文字列としての掲載価格。値がない場合は空です。 |
| product_id | 商品ID | string | 1729435358486827693 | TikTok Shop商品の安定した一意の識別子。 |
| product_title | 商品タイトル | string | Micro Ingredients Whole Milk Powder, 4lbs, Made in USA | TikTok Shopの掲載に表示される商品タイトル。 |
| rank_index | 検索順位 | integer | 0 | 検索結果における0始まりの順位。値がない場合は空です。 |
| rating_count | 評価数 | string | 3185 | 評価件数の数字文字列。値がない場合は空です。 |
| sale_count | 販売数 | string | 23284 | 公開販売数の数字文字列。値がない場合は空です。 |
| shop_id | ショップID | string | 7494949083499694765 | TikTok Shop店舗の一意の識別子。値がない場合は空です。 |
| shop_name | ショップ名 | string | Micro Ingredients | 商品に紐づく店舗名。 |
| status_code | ステータスコード | string | — | 商品ステータスの生コード。値がない場合は空です。 |
| source_item | ソース項目 | string | milk | このレコードを生んだ収集のキーワード項目。 |
| no_data | データなしマーカー | boolean | false | この検索項目が一致商品を返さなかったかどうかを示します。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "収集した商品に付く業務グループ識別子。値がない場合は空です。",
"prefill": "milk"
},
"brand_name": {
"type": "string",
"title": "ブランド名",
"description": "商品ページに表示されるブランド名。値がない場合は空です。",
"prefill": "Micro Ingredients"
},
"collect_time": {
"type": "string",
"title": "収集タイムスタンプ",
"description": "収集時刻のミリ秒タイムスタンプ文字列。値がない場合は空です。",
"prefill": "1789121807761"
},
"crawl_time": {
"type": "string",
"title": "収集時刻",
"description": "商品の収集時刻。ソースはタイムゾーンを示しません。",
"prefill": "2026-09-11T18:16:47"
},
"created_at": {
"type": "string",
"title": "作成タイムスタンプ",
"description": "レコード作成時刻のミリ秒タイムスタンプ文字列。値がない場合は空です。",
"prefill": "1789121807761"
},
"image_url": {
"type": "string",
"title": "商品画像",
"description": "商品ページのメイン画像URL。値がない場合は空です。",
"prefill": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/a6be9c262efc4e9e95cce5c93daa4ccf~tplv-fhlh96nyum-crop-webp:2000:2000.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast5&from=2378011839"
},
"keyword": {
"type": "string",
"title": "ヒットキーワード",
"description": "この商品に紐づく検索キーワード。",
"prefill": "milk"
},
"page_num": {
"type": "string",
"title": "結果ページ",
"description": "検索結果のページ番号文字列。値がない場合は空です。",
"prefill": "1"
},
"platform_code": {
"type": "string",
"title": "プラットフォームコード",
"description": "商品に付くソースプラットフォームコード。",
"prefill": "tiktokShop"
},
"price": {
"type": "string",
"title": "価格",
"description": "通貨フィールドのない生文字列としての掲載価格。値がない場合は空です。",
"prefill": "41.54"
},
"product_id": {
"type": "string",
"title": "商品ID",
"description": "TikTok Shop商品の安定した一意の識別子。",
"prefill": "1729435358486827693"
},
"product_title": {
"type": "string",
"title": "商品タイトル",
"description": "TikTok Shopの掲載に表示される商品タイトル。",
"prefill": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA"
},
"rank_index": {
"type": "integer",
"title": "検索順位",
"description": "検索結果における0始まりの順位。値がない場合は空です。",
"prefill": 0
},
"rating_count": {
"type": "string",
"title": "評価数",
"description": "評価件数の数字文字列。値がない場合は空です。",
"prefill": "3185"
},
"sale_count": {
"type": "string",
"title": "販売数",
"description": "公開販売数の数字文字列。値がない場合は空です。",
"prefill": "23284"
},
"shop_id": {
"type": "string",
"title": "ショップID",
"description": "TikTok Shop店舗の一意の識別子。値がない場合は空です。",
"prefill": "7494949083499694765"
},
"shop_name": {
"type": "string",
"title": "ショップ名",
"description": "商品に紐づく店舗名。",
"prefill": "Micro Ingredients"
},
"status_code": {
"type": "string",
"title": "ステータスコード",
"description": "商品ステータスの生コード。値がない場合は空です。"
},
"source_item": {
"type": "string",
"title": "ソース項目",
"description": "このレコードを生んだ収集のキーワード項目。",
"prefill": "milk"
},
"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": {
"super_ig__tiktok-shop-keyword-list": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=super_ig/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 30 件を 1 つの課金単位とし、端数は 30 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。