TikTok Shopの商品IDまたはSPUの一覧を渡すと、タイトル、価格、出品者、配送、SKU、取得状況の詳細を返します
概要
買い物客が実際に商品を見つけるのは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必須stringTikTok Shopで検索するブランド、商品、またはカテゴリの語句です。1回のタスクでキーワードは1つ、1〜512文字です。例milk - 希望取得件数
crawl_count必須integer取得したい商品件数で、1〜300件です。結果は30件単位の完全バッチで返るため、実際の件数は切り上げられる場合があります。30件未満でも30件として課金されます。範囲1–300例30
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- ビジネスID
biz_idstring収集した商品に付く業務グループ識別子。値がない場合は空です。例milk - ブランド名
brand_namestring商品ページに表示されるブランド名。値がない場合は空です。例Micro Ingredients - 収集タイムスタンプ
collect_timestring収集時刻のミリ秒タイムスタンプ文字列。値がない場合は空です。例1789121807761 - 収集時刻
crawl_timestring商品の収集時刻。ソースはタイムゾーンを示しません。例2026-09-11T18:16:47
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"biz_id": "milk",
"brand_name": "Micro Ingredients",
"collect_time": "1789121807761",
"crawl_time": "2026-09-11T18:16:47",
"created_at": "1789121807761",
"image_url": "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": "milk",
"page_num": "1",
"platform_code": "tiktokShop",
"price": "41.54",
"product_id": "1729435358486827693",
"product_title": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA",
"rank_index": 0,
"rating_count": "3185",
"sale_count": "23284",
"shop_id": "7494949083499694765",
"shop_name": "Micro Ingredients",
"status_code": "<status_code>",
"source_item": "milk",
"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=super_ig/tiktok-shop-keyword-list",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(デフォルトではログインを案内し、API Key をチャットに送るよう求めることはありません)。
detail.access.mcp.composeHint
料金
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 30 件を 1 つの課金単位とし、端数は 30 件に切り上げて課金されます。
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。