怎么调用 淘宝 关键词搜索 API？
search使用 platform="taobao"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 20 条，主要包含 id、url、title、price、currency、price_basis 等 43 个字段。
淘宝 search 的参数分别是什么意思？
keyword必填- search 的淘宝/天猫商品关键词，不是店铺名精确查询。
淘宝官方物料接口支持按商品关键词检索，并返回商品、卖家和店铺等字段；这是导购或联盟场景，不等于消费者网页搜索，也不为 EveryInfra 的 popular、price_asc、price_desc、relevance 或 tmall_only 实现背书。官方来源：淘宝开放平台：关键词物料搜索来源核查：
max_price可选- search 的商品最高价格条件，与 min_price 配合；不适用于店铺、详情、评论或问答。带小数时可能按整数筛选（向上取整）。带价格条件时不能翻页。
min_price可选- search 的商品最低价格条件，不是评论评分或 API 费用；不适用于店铺、详情、评论或问答。带小数时可能按整数筛选（向下取整）。带价格条件时不能翻页。
page可选- search 的页码，1–50，每页 20 条；不传就是第 1 页，每翻一页按一次调用计费。只有普通关键词搜索能翻页（不带 min_price、max_price、tmall_only，sort 不传或为 relevance），这种用法更稳，但多数行没有销量和店铺名；带这些条件又传大于 1 的 page 会在扣费前拒绝，去掉价格区间、排序和 tmall_only 就能翻页。limit 只决定这一页取几条，翻页时保持 20。排序实时变化，相邻两页偶尔有几条重复，合并时按 id 去重。
sort可选- search 使用 popular、price_desc、relevance（不提供低价优先）；默认/relevance 最多 20 条，popular/price_desc 最多 10 条，也不能翻页。reviews、questions 不接受 sort。shop 的 sort 只在带 page 翻页时生效，见 shop 的 page、sort 说明。
查看全部 3 个允许值
popularprice_descrelevance tmall_only可选- search 是否仅查询天猫商品，只接受布尔值 true / false，默认 false；开启时最多 10 条，也不能翻页。字符串 "false" 会在扣费前拒绝。
淘宝 返回字段与含义（34）
is_tmall- 是否为天猫店（区别于淘宝 C 店，开店门槛和保障不同）。
shop_id- 店铺 ID（search 行与详情、店铺商品行里是同一个 ID）。
shop_name- 店铺名。
brand- 品牌（product_detail 常缺省）。
category_id- 类目 ID。
price- 价格数值，不含货币符号；币种见 currency。product_detail 的价格（含 skus 每条的 price）多数由美元价折算成人民币，可能比淘宝页面上的价格高或低约 1–4%，以页面为准。search 每行的价可能是页面现价、划线价或推广价。是哪种见 price_basis。
price_basis- price 是怎么来的（有价才给）。product_detail：converted 是由美元价折算成的人民币价（多数调用），可能比淘宝页面上的价格高或低约 1–4%；page 是淘宝页面上的人民币价。search（每行一个）：page 是淘宝页面上的现价；list 是划线价，商品打折时高于实际卖价，有时高出一倍；promotion 是淘宝推广价，常比页面价低很多。currency 都是 CNY；同一商品不同次调用可能不同。
location- 发货地。卖家有多个仓时，同一商品不同次调用给出的发货地可能不同。
original_price- 原价（划线价）；search 无折扣时与 price 相同。shop 只有这一个价：列表展示的划线价，不是实际卖价，可能明显偏高；要卖价用 product_detail。
sold_count- 销量（search 有；product_detail 常缺省）。
stock- 库存件数。卖家有多个仓时，同一商品不同次调用给出的库存可能不同（发货地也可能不同）。
coupon_price- 券后价（有优惠券时低于 price，无券时缺省）。
category_path- 类目路径（面包屑，用「 > 」连接；product_detail 与 search 都可能有）。
images- 图片链接列表：product_detail、search 是商品图（search 不含主图 image_url），reviews 是买家晒图（没晒图时没有这个字段）。
free_shipping- 是否包邮。
sold_text- 销量原文（search，如「10万+」）；带「+」或「万」的是平台展示的约数，不是精确销量。
discount_type- 折扣/活动类型原文（如「特价秒杀」）。
seller_credit_level- 卖家信用等级（数字，越大越高）。
seller_positive_rate- 卖家好评率（search，百分数，100 即 100%）。
shop_score_description- 店铺动态评分·描述相符（5 分制）。
shop_score_service- 店铺动态评分·服务态度（5 分制）。
shop_score_delivery- 店铺动态评分·物流服务（5 分制）。
subtitle- 商品副标题（search，卖点短句）。
search_rank- 在本次搜索结果中的位置（search，从 1 起；翻页时接着往下数，第 3 页从 41 起）。
selling_points- 商品卖点标签列表。
review_tags- 评价标签列表，每项 tag（标签文字）与 count（提到次数，可能缺省）。
seller_type- 卖家类型代码（product_detail、search；B 为天猫或企业店，C 为个人店）。
shop_item_count- 店铺在售商品数（product_detail、search、shop）。
shop_opened_at- 开店时间原文（product_detail、search）。
discount_rate- 现价占原价的百分比（search；46.2 即打 4.62 折，100 为不打折）。
spu_id- 标准商品 SPU ID（search；同款不同店的商品共用一个，可用来归并同款）。
latest_review- 最新一条评价（search）：rating、text、posted_at、sku。
shop_age_years- 开店年数（search）。
shop_score_vs_industry- 店铺三项评分与同行比（search）：description、service、delivery 各为 higher / same / lower。