按关键词搜索 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 跨国价格对照表:同一关键词按每个 site 值各请求一次,每行都保留 site 和 currency,再用带日期的汇率表换算后,才下结论哪个市场最便宜。
- 价格带扫描:同一关键词配合一组连续的 price_start、price_end 区间反复请求,对比各区间的 total_count,看商品主要集中在哪个价位,再决定定价。
- 跨境选品清单:用 price_up 排序抓取关键词的前几页,把 title、price 和 shop_info 导出到表格,店铺名交给采购去联系供应商。
- 每日关键词价格快照:保存 site、keyword、item_id、price、currency 和抓取时间,对比前后快照,及时发现所关注商品的降价。
- 品牌最低价合规巡查:在各站点搜索品牌名,筛出低于约定最低价的商品,并附上 shop_info 方便后续跟进。
- 卖家集中度分析:把同一关键词的多页结果按 shop_id 分组,判断前几页是被少数店铺占据,还是供给比较分散。
- 关键词饱和度表:按站点记录候选选品关键词的 total_count,作为供给侧的参考指标(它代表商品数量,不代表需求或销量)。
- 购物助手工具调用:把搜索封装成函数,让 AI 智能体能回答「马来西亚预算内最便宜的无线耳机」这类问题,并返回结构化的价格和币种。
- 异常低价筛查:把每条商品与同关键词、同站点的价格中位数比较,标出价格可疑偏低的商品交由人工复核。
常见问题
可以搜索哪些 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 参数。