douyin_search_products
Read-only
用户需要按关键词查找抖音全局搜索中的商品时使用；支持排序、价格、服务和卖点筛选，返回归一化商品列表与不透明分页令牌。当前服务提供详情工具时：已有 product_id 时直接使用 douyin_get_product_detail_by_product_id；已有商品链接或分享文案时使用 douyin_get_product_detail_by_url。不用于搜索作品或用户，也不表示商城频道内完整搜索链路。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | 抖音商品搜索词，必填，去除首尾空白后不能为空；可传关键词或短语，例如“iPhone 16”或“露营桌”；keyword 只传搜索词，不要传商品链接、抖音平台对象 ID（如 sku_id、promotion_id、aweme_id、sec_user_id）或 page_token；不要把价格、排序或服务条件拼进 keyword，请使用对应筛选参数。 | |
| max_price | No | 最高价格，正整数，单位：元；必须大于 0，不传表示不限；与 min_price 同时传入时不得小于 min_price。 | |
| min_price | No | 最低价格，正整数，单位：元；必须大于 0，不传表示不限；与 max_price 同时传入时不得大于 max_price。 | |
| only_live | No | true 时仅返回当前正在直播的商品（抖音原生筛选“直播中”）；false 表示不限（默认）。 | |
| sort_type | No | 商品排序：general（综合，默认）、sales_descending（销量降序）、price_ascending（价格升序）、price_descending（价格降序）。 | general |
| page_token | No | page_token 是不透明分页令牌。首次请求留空；继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一抖音商品搜索链路、关键词、排序和筛选条件，不能跨能力复用；翻页时 keyword、sort_type、min_price、max_price 及全部筛选参数必须与上一页保持一致；需要修改任一条件时，清空 page_token 后从第一页重新搜索；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 | |
| selling_point | No | 卖点筛选：all（不限，默认）、high_sales（月销过万）、high_rating（好评多）。 | all |
| official_store | No | true 时仅返回带“抖音旗舰”标识的商品；false 表示不限（默认）。 | |
| seven_day_return | No | true 时仅返回支持 7 天无理由退货的商品；false 表示不限（默认）。 | |
| shipping_insurance | No | true 时仅返回支持运费险的商品；false 表示不限（默认）。 | |
| dispatch_within_24h | No | true 时仅返回支持 24 小时内发货的商品；false 表示不限（默认）。 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | 当前页商品列表 | |
| points | Yes | 本次成功调用的积分消耗与调用完成时的账户积分余额。 | |
| next_page_token | Yes | 下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论、关键词或筛选条件复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。 |