怎么调用 速卖通 关键词搜索 API?
search使用 platform="aliexpress"、action="search" 调用“关键词搜索”能力;返回列表,默认 20 条、单次最多 200 条,主要包含 product_id、title、url、price、original_price、currency 等 19 个字段。
速卖通 search 的参数分别是什么意思?
keyword必填- AliExpress 商品搜索词,例如 wireless earbuds。用于查商品列表,不是卖家 ID;商品详情、规格变体和评论使用商品链接定位。
AliExpress 官方联盟商品查询接口使用 keywords 检索商品,并提供售价区间、目标语言、目标币种和部分排序选项。EveryInfra 使用名为 keyword 的独立公开参数;这里只证明商品关键词检索的对应概念,不把官方参数名、排序枚举、分页或单次上限直接复制为 EveryInfra 契约。官方来源:AliExpress:联盟商品查询的关键词与售价条件来源核查:
min_price可选- 商品搜索的最低价格,数值,用于排除低于该价格的商品;不是折扣百分比,也不是 API 请求预算。价格币种需以搜索结果为准。
min_rating可选- 商品搜索的最低星级评分,数值范围 0–5,例如 4.5;不是评论条数或好评率百分比,也不筛选单条评论的星级。
sort可选- 按当前 action 列出的允许值选择。search:relevance 为默认综合排序,popular 为订单量优先,price_asc / price_desc 为价格升序 / 降序,top_rated 为评分优先;兼容旧值 default / orders / rating。reviews:relevance 为默认顺序,newest 为最新评论,不是商品上架时间。ratings 不公开 sort 参数。
查看全部 5 个允许值
popularprice_ascprice_descrelevancetop_rated
速卖通 特有返回字段与含义(8)
- product_id
- 商品 ID。
- original_price
- 原价(划线价)。与 price 对比可算真实折扣。
- discount
- 折扣力度。
- orders_count
- 累计订单数。AliExpress 上这是比评分更硬的信任指标。
- free_shipping
- 是否包邮。
- ships_from
- 发货地。
- seller_name
- 卖家名称。
- is_top_rated
- 是否为平台认证的优质卖家。