TikTok Shop Keyword Search

Give one TikTok Shop search keyword and an expected product count to get matching US listings with shop, price, and sales signals.

原文 · en-US訳文に戻す

データ収集 E-commerce & Retail TikTok Products

概要

Searching TikTok Shop by keyword is how shoppers actually discover products, but the public listing is hard to capture as a comparable dataset: titles, prices, shops, and rank shift together, and screenshots do not survive analysis. This app turns one search keyword into a structured list of matching United States TikTok Shop products so merchandising, brand, and research teams can see what currently appears for that term.

Unlike opening a product page you already know, keyword search shows which listings occupy the shelf for a brand, category, or campaign phrase. Keeping product identity, listing commercial signals, and shop context in the same row makes it possible to compare terms, watch a brand's presence, or build a candidate set without copying results by hand.

Data notes

Each record is a public product listing associated with the submitted search keyword on TikTok Shop in the United States. Product IDs are de-duplicated within the returned dataset. Matched keyword, Business ID, and Source item preserve the search context and may repeat across many products from the same task. Listings are returned in a stable ascending collection-time order.

Price is the listing amount as a raw string, with no separate currency field. Collect timestamp and Created timestamp are millisecond strings; Collection time has no timezone, so it should not be treated as an absolute cross-region clock. Search rank starts at 0. A No-data marker distinguishes a search item that produced no matching products from ordinary listing rows.

The collection covers public United States search listings only. It does not include other country catalogs, product-detail specifications, comments, or order data.

What a result looks like

Each row is one TikTok Shop product listing associated with the search keyword, or a no-data marker for that search.

Product title	Product ID	Price	Shop name	Sales count	Search rank
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

Brand name, Product image, Rating count, Shop ID, Collection time, and No-data marker are also available when supplied with the record.

Use cases

For keyword merchandising, group rows by Matched keyword and compare Product title, Price, and Shop name to see which listings occupy the search shelf.
For competitive tracking, sort by Search rank and use Sales count with Rating count to separate highly visible listings from long-tail products.
For brand monitoring, compare Brand name against Shop name and Product ID to see whether branded goods are sold by the brand shop or by other merchants.
For sourcing follow-up, keep Product ID, Shop ID, and Product image together so the same listing can be reopened later without repeating the search by hand.

適用範囲と境界

One TikTok Shop search keyword per task with an expected result count from 1 to 300; results are returned in complete batches of 30 and may be rounded up; coverage is limited to public US TikTok Shop search listings.

適している用途
When you need US TikTok Shop products that appear for a brand, product, or category keyword.
When you need a structured list that connects each matched listing with its shop, price, rank, and public sales or rating signals.

適さない用途
When you need full product specifications, comments, or order data from a product detail page.
When you need an immediate single-record lookup rather than a background keyword collection task.
When you need TikTok Shop listings from regions other than the United States.

失敗時の処理

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

1If no matching records are returned, try a shorter or broader search phrase and resubmit.
2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
3Retry later after rate limiting, temporary service unavailability, or a timeout.
4If authentication fails, verify the API Key configured for the execution environment.

入力

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

フィールド	業務名称	型	必須	デフォルト	列挙値／制約	例	説明
keyword	Search keyword	string	はい	—	—	milk	A brand, product, or category phrase to search on TikTok Shop. Each task accepts one keyword from 1 to 512 characters.
crawl_count	Expected result count	integer	はい	—	1–300	30	Expected number of product listings, from 1 to 300. Results are returned in complete batches of 30, so the actual count may be rounded up. Incomplete batches are still billed as 30 records.

出力

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

フィールド	業務名称	型	例	説明
biz_id	Business ID	string	milk	Business grouping identifier returned with the collected listing; empty when none is returned.
brand_name	Brand name	string	Micro Ingredients	Brand name shown on the product listing; empty when none is returned.
collect_time	Collect timestamp	string	1789121807761	Collect time as a millisecond timestamp string; empty when none is returned.
crawl_time	Collection time	string	2026-09-11T18:16:47	Collection time for the listing; the source does not specify a timezone.
created_at	Created timestamp	string	1789121807761	Record created time as a millisecond timestamp string; empty when none is returned.
image_url	Product image	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	Main product image URL from the listing; empty when none is returned.
keyword	Matched keyword	string	milk	Search keyword associated with this product listing.
page_num	Result page	string	1	Search result page number as a string; empty when none is returned.
platform_code	Platform code	string	tiktokShop	Source platform code returned with the listing.
price	Price	string	41.54	Listing price as a raw string, with no separate currency field; empty when none is returned.
product_id	Product ID	string	1729435358486827693	Stable unique identifier of the TikTok Shop product.
product_title	Product title	string	Micro Ingredients Whole Milk Powder, 4lbs, Made in USA	Product title shown on the TikTok Shop listing.
rank_index	Search rank	integer	0	Zero-based rank of the product in the search listing; empty when none is returned.
rating_count	Rating count	string	3185	Number of ratings as a numeric string; empty when none is returned.
sale_count	Sales count	string	23284	Public sales count as a numeric string; empty when none is returned.
shop_id	Shop ID	string	7494949083499694765	Unique identifier of the TikTok Shop store; empty when none is returned.
shop_name	Shop name	string	Micro Ingredients	Store name associated with the product listing.
status_code	Status code	string	—	Raw product status code; empty when none is returned.
source_item	Source item	string	milk	Keyword item associated with the collection that produced this record.
no_data	No-data marker	boolean	false	Indicates whether this search item produced no matching products.

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "Business grouping identifier returned with the collected listing; empty when none is returned.",
      "prefill": "milk"
    },
    "brand_name": {
      "type": "string",
      "title": "Brand name",
      "description": "Brand name shown on the product listing; empty when none is returned.",
      "prefill": "Micro Ingredients"
    },
    "collect_time": {
      "type": "string",
      "title": "Collect timestamp",
      "description": "Collect time as a millisecond timestamp string; empty when none is returned.",
      "prefill": "1789121807761"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collection time",
      "description": "Collection time for the listing; the source does not specify a timezone.",
      "prefill": "2026-09-11T18:16:47"
    },
    "created_at": {
      "type": "string",
      "title": "Created timestamp",
      "description": "Record created time as a millisecond timestamp string; empty when none is returned.",
      "prefill": "1789121807761"
    },
    "image_url": {
      "type": "string",
      "title": "Product image",
      "description": "Main product image URL from the listing; empty when none is returned.",
      "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": "Matched keyword",
      "description": "Search keyword associated with this product listing.",
      "prefill": "milk"
    },
    "page_num": {
      "type": "string",
      "title": "Result page",
      "description": "Search result page number as a string; empty when none is returned.",
      "prefill": "1"
    },
    "platform_code": {
      "type": "string",
      "title": "Platform code",
      "description": "Source platform code returned with the listing.",
      "prefill": "tiktokShop"
    },
    "price": {
      "type": "string",
      "title": "Price",
      "description": "Listing price as a raw string, with no separate currency field; empty when none is returned.",
      "prefill": "41.54"
    },
    "product_id": {
      "type": "string",
      "title": "Product ID",
      "description": "Stable unique identifier of the TikTok Shop product.",
      "prefill": "1729435358486827693"
    },
    "product_title": {
      "type": "string",
      "title": "Product title",
      "description": "Product title shown on the TikTok Shop listing.",
      "prefill": "Micro Ingredients Whole Milk Powder, 4lbs, Made in USA"
    },
    "rank_index": {
      "type": "integer",
      "title": "Search rank",
      "description": "Zero-based rank of the product in the search listing; empty when none is returned.",
      "prefill": 0
    },
    "rating_count": {
      "type": "string",
      "title": "Rating count",
      "description": "Number of ratings as a numeric string; empty when none is returned.",
      "prefill": "3185"
    },
    "sale_count": {
      "type": "string",
      "title": "Sales count",
      "description": "Public sales count as a numeric string; empty when none is returned.",
      "prefill": "23284"
    },
    "shop_id": {
      "type": "string",
      "title": "Shop ID",
      "description": "Unique identifier of the TikTok Shop store; empty when none is returned.",
      "prefill": "7494949083499694765"
    },
    "shop_name": {
      "type": "string",
      "title": "Shop name",
      "description": "Store name associated with the product listing.",
      "prefill": "Micro Ingredients"
    },
    "status_code": {
      "type": "string",
      "title": "Status code",
      "description": "Raw product status code; empty when none is returned."
    },
    "source_item": {
      "type": "string",
      "title": "Source item",
      "description": "Keyword item associated with the collection that produced this record.",
      "prefill": "milk"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data marker",
      "description": "Indicates whether this search item produced no matching products.",
      "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 config

{
  "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>" }
    }
  }
}

自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

30 returned records

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

$0.005/ 30 件

Per task submitted

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

$0.0001/ 回

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

Credits を確認

今すぐ試す

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

サンプル

パラメータは送信前に input.schema で検証されます

Search keywordkeyword*A brand, product, or category phrase to search on TikTok Shop. Each task accepts one keyword from 1 to 512 characters.

Expected result countcrawl_count*Expected number of product listings, from 1 to 300. Results are returned in complete batches of 30, so the actual count may be rounded up. Incomplete batches are still billed as 30 records.

まず必須パラメータを入力してください

$0.005 / 30 件から