Lazada 商品搜索 API
输入关键词并选择国家站点,即可获取 Lazada 商品列表:价格、币种、折扣、评价和店铺信息一并返回,还能按价格区间筛选、排序和翻页。各站点按本币报价,跨站比较前请先换算币种。
打开独立演示页第一次 Lazada 商品搜索
在控制台获取你获准使用的 API 密钥,替换示例中的 <API_KEY>。密钥会出现在查询 URL 中,请勿通过链接、截图或日志泄露。
示例搜索关键词 t shirt,站点为泰国(site=th),其余参数留空,由服务按默认方式排序。这些是示例指定的公开输入,不是省略参数后的默认值;商品、价格、数量和排序会随时间变化,也可能返回空列表。你可以在表单中改成其他关键词,或换成 my、sg、vn、id、ph 等站点代码,但示例所用的泰国站点是目前唯一实测过的。打开页面、切换接口、展开说明或复制示例都不会发送数据请求,只有你主动提交才会调用。
基础 URL https://api.opendata-api.com
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'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/lazada-api/search-items-by-keywords",
params={
"key": "<API_KEY>",
"keywords": "t shirt",
"page": "1",
"site": "th",
"sort": "pop",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/lazada-api/search-items-by-keywords");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"keywords": "t shirt",
"page": "1",
"site": "th",
"sort": "pop",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());请求基础设置
- site 为必填,每次只传一个站点代码:my(马来西亚)、sg(新加坡)、vn(越南)、id(印度尼西亚)、ph(菲律宾)或 th(泰国)。价格以该站点的本币返回,每条商品都带 currency 字段;price_start 和 price_end 也应按同一站点的本币来理解。跨站点对比前,请先按带日期的汇率换算,不要把不同币种的价格放进同一列排序。
- price、sold_count、comment_count 等数值字段以字符串形式返回,已售数量还可能是 38.1K 这类缩写文本。解析时请做好容错,并在得出派生数值的同时保留原始文本。price_start 和 price_end 作为数字字符串提交,两者都可以留空。
- page 从 1 开始,实测每页返回 40 条,total_count 是该关键词在所选站点下的商品总量,只反映供给规模,不代表需求或销量。大于 1 的页码尚未实测,遇到空的 items 就停止翻页;start_key 是不透明的值,翻页请只用 page。每翻一页都是一次独立请求,请先评估总量再决定拉取多少页。
查看响应
先看 HTTP 状态,再看网关返回的 code、message、data 业务状态:HTTP 200 只说明请求到达了网关,业务是否成功要以 code 为准。业务成功后再读取 data 里的 items 列表;items 为空数组表示该关键词在所选站点和价格区间下没有结果,属于正常未命中,不是接口故障。price、sold_count 等数值字段以字符串返回,解析时请保留原始文本。
按任务选择接口
- 按关键词搜索站点商品
-
这是一个没有前置步骤的接口:只需提供必填的 keywords 和 site,就能拿到该站点的一页商品列表,不必先获取商品 ID,也不需要额外凭据。需要时再加上 sort、page、price_start 和 price_end;结果里的 item_id、product_url 和 shop_info 可用来核对商品、按店铺分组统计。
电商商品搜索
/api/project/lazada-api/search-items-by-keywords 按关键词搜索 Lazada 商品列表,覆盖东南亚六个站点,支持排序、翻页和价格区间筛选。
完整文档 →说明
返回某个 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 等数值字段以字符串形式返回。返回内容是搜索结果的快照,不是销量、库存或订单数据源。
测试接口 2 个必填 · 4 个可选
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
可选参数 (2)
| 参数 | 位置 | 值 |
|---|---|---|
| query | ||
| query |
调用成本暂不可用,未假定任何价格。
接口能力
按关键词搜索 Lazada 商品并直接拿到结构化 JSON,不用自己写爬虫,也不用对付滑块验证。可查询东南亚六个国家站点,从搜索结果里读取价格、币种、折扣、评价和店铺信息。
- 关键词搜索:一次请求返回所选站点上某个关键词的一页 Lazada 商品列表
- 六个国家站点:马来西亚、新加坡、越南、印度尼西亚、菲律宾和泰国,价格按各站点本币返回
- 价格区间与排序:用最低价、最高价缩小范围,并按热度、销量或价格升降序排列
- 分页与总数:逐页翻阅搜索结果,并读取该关键词下的商品总数
- 商品卡片:商品 ID、标题、品牌、售价与原价、折扣、评分、已售数量、库存标记和商品链接
- 店铺信息:每条结果都带店铺名称、卖家名称和店铺链接
标准 RESTful JSON 接口,适用于跨境电商选品、多国价格对比、竞品与品牌价格监控、导购内容生成和 AI 购物助手。