怎么调用 1688 关键词搜索 API？
search使用 platform="alibaba1688"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、title、text、price_min、price_max 等 69 个字段。
1688 search 的参数分别是什么意思？
keyword必填- 1688 批发商品搜索词，例如保温杯、包装纸盒。用于 search，不是店铺名或 offerId；起订量和阶梯价属于返回的商品信息。
1688 官方说明用户输入关键词后，平台会匹配商品或服务，并可按销量、价格、综合等维度查看结果。该来源可解释 EveryInfra keyword 的商品搜索对象，但不证明 popular 与销量排序完全等价，也不证明 relevance、city、价格范围或本接口结果上限的具体实现。官方来源：1688：关键词匹配与商品搜索排序来源核查：
city可选- 1688 商品查询的城市筛选文本。它不是账号所在地，也不会修改返回供应商的地址；指定单品时不能据此推断该筛选仍生效。
max_price可选- 批发商品价格筛选上限，数值；不是阶梯报价中的采购数量上限。可带小数；个别情况按整元筛选时向上取整（145.98 按 146），只放宽不收窄。与 min_price 配合限定价格范围，不能保证每个 SKU 或数量档都处于该范围。
min_price可选- 批发商品价格筛选下限，数值；不是最低起订量或 API 调用预算。可带小数；个别情况按整元筛选时向下取整（39.81 按 39），只放宽不收窄。不同采购数量可能对应不同阶梯价，不能把筛选价当作最终成交报价。
sort可选- 商品搜索排序：relevance 为相关度，popular 为畅销优先，price_asc / price_desc 为价格升序 / 降序。不传时 search 使用 relevance；排序不等于返回精确销量或成交额。
查看全部 4 个允许值
popularprice_ascprice_descrelevance
1688 返回字段与含义（63）
supplier_name- 供应商名称。
supplier_type- 供应商经营模式（如 生产加工、经销批发）。
supplier_founded_year- 供应商成立年份。
supplier_fans- 供应商粉丝数。商品详情同步调用时可能为空；需要这一项请用异步调用。
province- 供应商所在省份。商品详情同步调用时可能为空；需要这一项请用异步调用。
min_order_quantity- 最小起订量(MOQ)。1688 批发场景的第一门槛，采购前先看它。
price_min- 价格区间下限。
price_max- 价格区间上限。
unit- 计价单位（个/件/箱）。
order_count- 订单数。
sold_count- 销量（数字）；只有约数（如 10万+）时缺省，原文见 sold_display。
repurchase_rate- 复购率。1688 上判断供应商质量最硬的指标之一。
stock- 库存。商品详情同步调用时可能为空；需要这一项请用异步调用。
is_out_of_stock- 是否缺货。商品详情同步调用时可能为空；需要这一项请用异步调用。
images- 商品主图链接，按页面顺序；product_detail 里有的商品还带规格图，详情区的图在 description_images。没有图片时不出现这个字段。
supports_dropship- 是否支持一件代发。做无货源电商的关键筛选项。商品详情同步调用时可能为空；需要这一项请用异步调用。
description_images- 详情描述图 URL 列表（按商品页原顺序）；null 表示该商品无详情图。
video_url- 商品视频链接（如有）。
specs- 商品参数/规格表：[{name, value}] 键值对列表（如 材质: TPU）。商品详情同步调用时可能为空；需要这一项请用异步调用。
rating- 商品综合评分（1-5）。商品详情同步调用时可能为空；需要这一项请用异步调用。
review_count- 累计评价数。商品详情同步调用时可能为空；需要这一项请用异步调用。
positive_rate- 好评率（0-1 小数，如 0.999 = 99.9%）。商品详情同步调用时可能为空；需要这一项请用异步调用。
sold_display- 销量的原文展示（如 已售10万+件）；数字形式见 sold_count。商品详情同步调用时可能为空；需要这一项请用异步调用。
want_buy_count- 想要/求购人数（采购意向热度参考）。商品详情同步调用时可能为空；需要这一项请用异步调用。
category_path- 完整类目路径（如 数码、电脑 > 手机配件 > 手机保护套）；product_detail 常缺省，类目名见 category。商品详情同步调用时可能为空；需要这一项请用异步调用。
winport_url- 供应商 1688 诚信通店铺链接。
supplier_years- 供应商在 1688 平台的年数。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_shop_url- 供应商店铺链接。
supplier_composite_score- 供应商综合服务分（1-5）。
sold_count_text- 销量的原文展示（搜索行，如 全网100+件）。
service_tags- 服务标签列表（搜索行）。
product_badges- 商品徽章列表（搜索行，如 7×24H响应、先采后付）。
coupons- 店铺券与权益列表：每项含 type（类型代码）、type_name（类型名）、label（标签，如 满50包邮）、summary（说明）、valid_from / valid_to（有效期，原文时间）、link_url（活动页）、id；字段缺失时没有该子键。
promotion_details- 促销活动明细：activity_id、name、type（如 sellerProm 店铺活动 / officialProm 平台活动）、detail / summary（规则说明）、valid_period（有效期原文）、discount_amount（优惠金额，元）、original_price_range（活动前价格区间原文）、note（补充说明，如不免邮区域）、link_url。promotions 仍只给名称。
service_details- 服务保障明细：code（服务代码）、name、description（规则说明）、rule_url（规则页）。services / service_tags 只给名称。商品详情同步调用时可能为空；需要这一项请用异步调用。
purchase_limits- 限购：per_buyer（每个买家限购件数）、promotion_per_buyer（活动价限购件数）；-1 表示不限购。
mix_wholesale- 混批条件：min_amount（混批起批金额，元）、min_varieties（最少款数）。
supports_mix- 是否支持混批（不同款式凑单起批）。
review_tags- 买家印象标签：[{tag, count}]，如 面料软糯 ×2。商品详情同步调用时可能为空；需要这一项请用异步调用。
refund_rate- 退款率（0-1 小数）。
review_negative_count- 差评数；null 表示没给，不等于 0。
review_neutral_count- 中评数；null 表示没给，不等于 0。
review_with_photo_count- 带图评价数；null 表示没给，不等于 0。商品详情同步调用时可能为空；需要这一项请用异步调用。
review_with_text_count- 有文字的评价数；null 表示没给，不等于 0。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_stats- 供应商画像（只含有值的子键）：employee_count（员工数）、plant_area_sqm（厂房面积，平方米）、plant_type（厂房类型，如 自有工厂）、equipment_count（主要设备数）、product_count（在售商品数）、repeat_rate（回头率 0-1）、repeat_buyer_count_text / cross_border_buyer_count_text（回头客数、跨境买家数原文，如 300+）、response_rate（响应率 0-1）、positive_review_rate（好评率 0-1）、fulfillment_rate（履约率 0-1）、certificate_count / certificates / management_certificates（证书数、证书名、管理体系认证）、patent_count（专利数）、oem_mode（OEM/ODM）、own_brands（自有品牌原文）、brand_count、partner_brand（合作品牌）、is_major_brand_partner（是否大牌供应商）、scale_tier（规模档，如 规上企业）、honors（荣誉）。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_scores- 供应商分项服务分（1-5，没有评分的项不给）：goods（商品）、logistics（物流）、consultation（咨询）、dispute（纠纷）、return（退换货）；综合分见 supplier_composite_score。
supplier_metric_tags- 工厂指标标签：[{name, value}]，如 回头率 66%、履约率 100%。
supplier_rank- 供应商上榜信息：text（如 2026上榜二钻工厂）、link_url（榜单页）。
supplier_industry_belt- 产业带认证：description（如 1688官方认证的安阳连身衣产业带旗舰商家）、link_url（认证说明页）。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_certification- 第三方验厂/验商认证：agency（认证机构代码，如 sgs、tuv）、report_number（报告编号原文）、report_url（报告页）。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_verification_tags- 供应商认证标签，如 深度验厂、深度验商。
supplier_inspection_report_url- 验厂/验商报告页链接。
supplier_videos- 工厂/公司视频：video_id、title、type（视频类型代码）、video_url、cover_url、duration_sec（秒）。
supplier_address- 供应商地址原文。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_coordinates- 供应商位置坐标：{longitude（经度）, latitude（纬度）}。商品详情同步调用时可能为空；需要这一项请用异步调用。
supplier_main_category- 供应商主营类目。商品详情同步调用时可能为空；需要这一项请用异步调用。
customization- 定制服务（只含有值的子键）：title（定制说明）、lead_time_days（定制交期，天）、min_order_quantity / min_order_unit（定制起订量与单位）、services（可定制项，如 更换客户标）、options（定制选项：service 选项名、selection 单选/多选、choices[] 每个选择的 name、description、is_default、min_value / max_value / unit（尺寸类取值范围）、image_url、price_tiers[{min_quantity, price}] 加价阶梯）。是否支持定制看 customization_supported。
shipping- 物流（只含有值的子键）：carrier（常用快递）、logistics_text（物流说明原文）、dispatch_hours / dispatch_text（预计发货时长与说明）、delivery_days / delivery_hours（预计送达时长）、fee（运费，元）、is_free_shipping（是否包邮）、ship_from（发货地）、ship_from_code（发货地行政区划代码）、fee_note（运费说明）。
unit_weight_kg- 单件重量（千克）。
price_tiers- 阶梯价（买得越多单价越低）：[{min_quantity, max_quantity, price}]，max_quantity 是该档上限（最后一档没有）。不分数量档的商品没有这个字段，价格看 price_min / price_max。
category- 分类名称，取值为原平台的分类体系，未做跨平台归一。商品详情同步调用时可能为空；需要这一项请用异步调用。
city- 城市名，用原平台的语言书写，未做中英归一。商品详情同步调用时可能为空；需要这一项请用异步调用。
rating_scale- 上一列
rating的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。商品详情同步调用时可能为空；需要这一项请用异步调用。