按关键词搜索 Lazada 商品列表,覆盖东南亚六个站点,支持排序、翻页和价格区间筛选。

查看 Lazada 商品搜索 API 的全部接口 →

返回某个 Lazada 国家站点下指定关键词的一页搜索结果。入参包括 keywords(必填,搜索词)、site(必填,站点代码:my、sg、vn、id、ph 或 th),以及可选的 page、sort(pop、sales、price_up 或 price_down)、price_start 和 price_end。实测(keywords 为 t shirt,site 为 th,page 为 1,HTTP 200)返回 JSON 外层结构:code 为 200、msg 为 success,data 对象包含 page、page_size(40)、start_key、total_count(该次调用为 33,395)、keyword、cat_url、sort、price_start、price_end,以及含 40 条记录的 items 列表。实测中每条商品都带有 item_id、product_url、title、img、category_path、brand、brand_id、currency(THB)、price、price_info(sale_price、origin_price)、discount、review_info(average_score、review_count)、comment_count、shop_info(shop_id、shop_name、shop_url、seller_id、seller_name)、sold_count、delivery_info(area_from)、is_in_stock 和 is_ad。未验证的部分:文档示例中还出现了 data.extra 令牌,但实测响应里没有;其余五个站点、价格筛选以及大于 1 的页码都没有实测过。price、sold_count、comment_count 等数值字段以字符串形式返回。返回内容是搜索结果的快照,不是销量、库存或订单数据源。

API 功能

一个 site 参数切换六个站点 必填参数 site 可取 my、sg、vn、id、ph 或 th,同一个关键词按站点分别请求,就能得到各国站点的搜索结果。每条商品自带 currency 字段(泰国站点实测为 THB),不同站点的数据行不会混淆币种。
价格区间与四种排序方式 可选的 price_start 和 price_end 用来限定商品价格范围,sort 支持 pop、sales、price_up 和 price_down。实际生效的 sort、price_start、price_end 会回显在 data 对象中,每份存档的响应都能对应到产生它的筛选条件。
分页结果并附带商品总数 通过 page 参数逐页翻阅结果。实测中泰国站点搜索 t shirt 的第 1 页返回 page_size 为 40,total_count 为 33,395,可以先评估关键词的商品规模,再决定要拉取多少页。
含价格、折扣与评价的商品卡片 每条商品包含 item_id、title、brand、price,price_info 给出售价与原价,另有 discount 折扣标签、带平均评分和评价数的 review_info、sold_count、is_in_stock,以及 product_url 和 img 链接。
每条结果都带店铺信息 shop_info 为每条商品提供 shop_id、shop_name、shop_url、seller_id 和 seller_name,可以按店铺对结果分组,看出某个关键词下哪些卖家占据了主要位置。
统一的 code/msg 外层结构 响应把数据包在 code/msg 结构中(实测 code 为 200、msg 为 success),业务内容全部放在 data 下,调用方先做一次成功判断,再读取 items 即可。

在线 API 演示

GET /api/project/lazada-api/search-items-by-keywords

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/lazada-api/search-items-by-keywords?key=<API_KEY>&keywords=t+shirt&page=1&site=th&sort=pop'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

可以搜索哪些 Lazada 站点?

必填参数 site 可取 my(马来西亚)、sg(新加坡)、vn(越南)、id(印度尼西亚)、ph(菲律宾)或 th(泰国),每次请求只传一个代码。实测只跑过 th,依赖其他站点之前,请先用样例请求核对返回结果。

怎样对比同一关键词在不同国家的结果?

用相同的 keywords 对每个 site 值各调用一次。价格以各站点自己的币种返回(泰国站点实测为 THB),所以请读取每条商品的 currency 字段,并用带日期的汇率表换算,不要直接比较原始的 price 字符串。

每页返回多少条结果,如何获取更多?

第 1 页实测返回 40 条,page_size 为 40,同时给出 total_count(th 站点搜索 t shirt 为 33,395)。增大 page 参数即可翻页。大于 1 的页码没有实测过,当 items 为空时就停止翻页。

sort 支持哪些取值,默认值是什么?

sort 支持 pop、sales、price_up 和 price_down。实测未传 sort 时,响应中的 sort 为 pop,说明默认大概率是按热度排序。实际生效的值会回显在 data.sort 中。

price_start 和 price_end 怎么用?

两者都是可选的数字字符串,用来限定商品价格范围,响应会在 data.price_start 和 data.price_end 中回显(未传时为空字符串)。实测没有传这两个参数,建议先在目标站点用较窄的区间试一次,并按该站点的币种来理解这两个边界。

每条商品包含哪些字段?

实测中每条商品都有 item_id、product_url、title、img、category_path、brand、brand_id、currency、price、price_info(sale_price 和 origin_price)、discount、review_info(average_score 和 review_count)、comment_count、shop_info(shop_id、shop_name、shop_url、seller_id、seller_name)、sold_count、delivery_info.area_from、is_in_stock 和 is_ad。

price 和各种计数字段是数字还是字符串?

是字符串。实测中 price、comment_count 和 sold_count 都是字符串,文档示例里的 sold_count 还出现了 38.1K 这样的缩写形式,所以解析时要做好容错,并在得出派生数值的同时保留原始文本。

能拿到销售历史、库存或订单数据吗?

不能。它返回的是搜索结果的快照。sold_count 和 comment_count 是商品列表上显示的数字,is_in_stock 是每条商品的标记,这里没有订单、库存或历史销量数据。如需时间序列,请自行保存带时间戳的快照。

成功的响应是什么样的?

是一个 JSON 对象,code 为 200、msg 为 success,data 对象包含 page、page_size、start_key、total_count、keyword、cat_url、sort、price_start、price_end 和 items。读取 items 之前先检查 code。start_key 是不透明的值,文档没有说明它的作用,所以翻页请使用 page 参数。

相关指南

查看订阅方案 →