TikTok Shop Product Search (by Keyword)
omnial/tiktok-shop-web-fetch-search-products-list
Given a search keyword, returns matching TikTok Shop product listings (title, price, product image dimensions (URLs withheld), star rating, review count, units sold, and the selling shop) plus the shops that carry matching products. When the keyword matches nothing, the endpoint falls back to a general recommendation feed of unrelated products with an empty shops list rather than an error.
activeper callv2
Price
Up to $0.00205 per call; you pay what the call used
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Data from TikTok.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/tiktok-shop-web-fetch-search-products-list" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/tiktok-shop-web-fetch-search-products-list" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/tiktok-shop-web-fetch-search-products-list", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/tiktok-shop-web-fetch-search-products-list", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.00205 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"search_word"
],
"properties": {
"offset": {
"type": "integer",
"default": 0,
"description": "Offset"
},
"region": {
"type": "string",
"default": "US",
"examples": [
"US"
],
"description": "Region code"
},
"page_token": {
"type": "string",
"description": "Page token"
},
"search_word": {
"type": "string",
"examples": [
"labubu"
],
"description": "Search keyword"
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"properties": {
"code": {
"type": "number",
"description": "0 on both real calls observed."
},
"data": {
"type": "object",
"properties": {
"component_data": {
"type": "object",
"properties": {
"shops": {
"type": "array",
"items": {
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "Opaque numeric TikTok Shop seller ID, not a phone number."
},
"shop_logo": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Withheld -- see usage.md."
}
},
"additionalProperties": true
},
"shop_name": {
"type": "string"
}
},
"additionalProperties": true
},
"description": "Shops matching the search keyword directly (not shops selling recommendation-feed products). Empty array `[]` when the keyword matched no direct results (e.g. a gibberish keyword)."
},
"offset": {
"type": "number"
},
"has_more": {
"type": "boolean",
"description": "Whether another page of results is available."
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Withheld -- see usage.md."
}
},
"additionalProperties": true
},
"title": {
"type": "string"
},
"seo_url": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"canonical_url": {
"type": [
"string",
"null"
],
"description": "Withheld -- see usage.md."
}
},
"additionalProperties": true
},
"sku_info": {
"type": "array",
"items": {
"type": "object",
"properties": {
"SkuId": {
"type": "string"
},
"PriceInfo": {
"type": "object",
"properties": {
"currency_name": {
"type": "string"
},
"currency_symbol": {
"type": "string"
},
"discount_format": {
"type": "string",
"description": "Discount amount off the origin price. Only observed on some variants."
},
"sale_price_format": {
"type": "string"
},
"origin_price_format": {
"type": "string",
"description": "Pre-discount price. Only observed on some variants."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Per-variant (size/color) pricing."
},
"rate_info": {
"type": "object",
"properties": {
"score": {
"type": "number",
"description": "0 when the product has no reviews yet."
},
"review_count": {
"type": "string"
}
},
"additionalProperties": true
},
"sold_info": {
"type": "object",
"properties": {
"sold_count": {
"type": "number"
}
},
"additionalProperties": true
},
"brand_info": {
"type": "object",
"properties": {
"brand_name": {
"type": "string"
}
},
"description": "Only observed populated on some products; absent on others.",
"additionalProperties": true
},
"product_id": {
"type": "string"
},
"seller_info": {
"type": "object",
"properties": {
"seller_id": {
"type": "string",
"description": "Opaque numeric TikTok Shop seller ID, not a phone number."
},
"shop_logo": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Withheld -- see usage.md."
}
},
"additionalProperties": true
},
"shop_name": {
"type": "string"
}
},
"additionalProperties": true
},
"transparent_image": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"url_list": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
},
"description": "Withheld -- see usage.md."
}
},
"description": "Same product image with a transparent background.",
"additionalProperties": true
},
"product_price_info": {
"type": "object",
"properties": {
"sku_id": {
"type": "string"
},
"price_prefix": {
"type": "string",
"description": "e.g. 'From', when the product has multiple variant prices. Absent on some products."
},
"currency_name": {
"type": "string"
},
"currency_symbol": {
"type": "string"
},
"sale_price_format": {
"type": "string",
"description": "Human-readable price, e.g. '34.98'."
},
"promotion_deduction_details": {
"type": "object",
"properties": {
"seller_subtotal_deduction": {
"type": "string",
"description": "Seller-funded discount amount, when any."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"description": "Matching products, or a fallback recommendation feed when the keyword matched nothing."
},
"load_more_params": {
"type": "object",
"properties": {
"page_token": {
"type": "string"
},
"search_word": {
"type": "string"
}
},
"description": "Pass `page_token` back as this tool's `page_token` input to fetch the next page.",
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"additionalProperties": true
},
"message": {
"type": "string",
"description": "'success' on both real calls observed."
}
},
"description": "The search-results envelope. No genuinely empty/not-found case was observed -- an unmatched keyword (e.g. gibberish) still returns a populated `products` array (a fallback recommendation feed) with `shops` empty.",
"additionalProperties": true
}