Lazada Search API searches products on Lazada in Singapore, Malaysia, Indonesia, Thailand, the Philippines and Vietnam. Each item has the price, original price and discount as numbers with the currency, rating, review count, sold count, seller, shop id, brand, categories, images and badges for LazMall, free shipping and flash sale.
Filter by price range, minimum rating, sort order, items shipped from the local country and LazMall only. Every item in the answer follows the filters you send. Send a category slug from data.filters.categories to list a category, with or without a search text.
There are 40 results per page and at most 102 pages. total_results is capped by Lazada, total_results_capped says so. Page N returns the real page N. sold_count is null when Lazada shows none. The item_id and shop_id feed the Product, Reviews, Shop and Shop Products APIs unchanged.
Costs 2 credits per successful request. Empty results and failed requests are free.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
10 optional filters available.
string
Optional
Search text, 1 to 120 characters, for example headphones. Required unless you send a category.
coffee shops
string
Optional
Country code: sg, my, id, th, ph or vn (default sg). One country per request.
US
integer
Optional
One-based page number, 1 to 102 (default 1). 40 results per page.
1
string
Optional
Category slug from data.filters.categories of an earlier search, for example shop-on-ear-headphones.
example
string
Optional
One of relevance, price_asc, price_desc, popularity.
relevance
number
Optional
Lowest price in the local currency.
10
number
Optional
Highest price in the local currency.
10
integer
Optional
Lowest item rating as a whole star value, 1 to 5. Items without a rating are left out.
10
boolean
Optional
Set 1 to list only items shipped from the country of the site.
true
boolean
Optional
Set 1 to list only LazMall items.
true
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"query": "headphones",
"country": "sg",
"filters": {
"sorts": [
"relevance",
"price_asc",
"price_desc",
"popularity"
],
"categories": [
{
"slug": "shop-over-ear-headphones",
"title": "Over-Ear Headphones"
},
{
"slug": "shop-on-ear-headphones",
"title": "On-Ear Headphones"
},
{
"slug": "shop-in-ear-headphones",
"title": "In-Ear Headphones"
}
]
},
"results": [
{
"url": "https://www.lazada.sg/products/pdp-i13786136851.html",
"brand": {
"id": "28314",
"name": "Marshall"
},
"image": "https://sg-live-01.slatic.net/p/1e3ea8a5ea124a38d2b1dc82c24a0ba9.jpg",
"price": 304,
"title": "[NEW] Marshall Milton A.N.C On-Ear Headphones",
"badges": {
"lazmall": true,
"flash_sale": false,
"free_shipping": true
},
"images": [
"https://sg-live-01.slatic.net/p/1e3ea8a5ea124a38d2b1dc82c24a0ba9.jpg",
"https://sg-live-01.slatic.net/p/b6a649167f24052ef30945305b227f5b.png",
"https://sg-live-01.slatic.net/p/20e93ca8557e8e45f0af4b9cc4272749.png"
],
"rating": 5,
"seller": {
"id": "1133229569",
"name": "Marshall"
},
"sku_id": "124766487777",
"item_id": "13786136851",
"shop_id": "402099",
"currency": "SGD",
"in_stock": true,
"location": "Singapore",
"categories": [
"10100387",
"154",
"157"
],
"sold_count": 27,
"is_sponsored": false,
"review_count": 5,
"original_price": 329,
"discount_percent": 7.6
}
],
"category": null,
"currency": "SGD",
"pagination": {
"page": 1,
"has_next": true,
"per_page": 40,
"total_results": 4080,
"total_results_capped": true
}
},
"meta": {
"credits": 2,
"billable": true,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"query": [
"A search text or a category is required, e.g. headphones."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Lazada could not be reached after several tries. This response is not billable. Retry shortly.
{
"meta": {
"credits": 0,
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Lazada could not be reached. Please retry shortly."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.