COMMERCE_SERP 并设置 site aliexpress,按商城的顺序获取搜索结果中的商品。COMMERCE_PRODUCT 不读取这家商城的商品页面。每次完成的搜索消耗 0.5 积分。
搜索
GET /v1/async/task/{id} 或通过 webhook 接收。参见异步任务。
参数
site:必填。值为aliexpress。query:必填。搜索词,1-500 个字符。limit:可选整数,范围 1-40,默认 20。country:可选。默认是商城所在国家US。其他国家会以422 REGION_UNSUPPORTED拒绝。
include:即使是 include: {},也会在冻结积分前返回针对 payload.include 的 422 VALIDATION_ERROR。
响应示例
结果字段
site、query和country回显请求。returnedCount是products中的商品数。- 每个商品包含
rank、productId、title和url。productId是商城自己的商品 ID。rank遵循商城的默认排序,商城标为广告的商品会被跳过。 - 搜索结果页显示时返回
price、rating和imageUrl。price是以商品的currency(ISO 4217)计的数字;不同规格分别定价时,取最低价。 AliExpress 的价格是向未登录的美国买家显示的促销价。 rating为五分制。 AliExpress 只显示星级、不显示评价数,因此其商品没有reviewCount。- 每次搜索从商城搜索结果的第一页获取商品。
错误与计费
- 没有返回任何商品的搜索以失败任务结束。
- 只对完成的搜索计费,每次 0.5 积分。